<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Mertcan Poyraz on Medium]]></title>
        <description><![CDATA[Stories by Mertcan Poyraz on Medium]]></description>
        <link>https://medium.com/@mertcanpoyraz?source=rss-d9257e6a6fa8------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*P7rTZ_lhrugxfNGBw40PLw.jpeg</url>
            <title>Stories by Mertcan Poyraz on Medium</title>
            <link>https://medium.com/@mertcanpoyraz?source=rss-d9257e6a6fa8------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Fri, 20 Nov 2026 11:55:42 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@mertcanpoyraz/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Decorator Design Pattern with Go Gin]]></title>
            <link>https://medium.com/@mertcanpoyraz/decorator-design-pattern-with-go-gin-2c8d70b9b4c0?source=rss-d9257e6a6fa8------2</link>
            <guid isPermaLink="false">https://medium.com/p/2c8d70b9b4c0</guid>
            <category><![CDATA[api]]></category>
            <category><![CDATA[golang]]></category>
            <category><![CDATA[design-patterns]]></category>
            <dc:creator><![CDATA[Mertcan Poyraz]]></dc:creator>
            <pubDate>Mon, 19 Feb 2024 18:44:40 GMT</pubDate>
            <atom:updated>2024-02-19T19:43:53.633Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/768/1*FYEMh0E3PnzN1C2ag9DiMw.jpeg" /></figure><p>Hello everyone ! I will talk about the Golang Decorator Desing Pattern with real time API example in this article. Let’s Start it !</p><h3>What is the Decorator Design Pattern ?</h3><p>Decorator Design Pattern is a structural pattern that allows adding new functionalities to an object dynamically without altering its structure. It involves a set of decorator classes wrapping around a base component to extend its behavior. This pattern enables flexible and reusable code by allowing the addition of new features at runtime.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/768/1*nk_ZOIM6xQGCXkZAJk4M8Q.jpeg" /></figure><h3>1) Scenario</h3><p>Let’s have an endpoint called <strong>“/calculate-amount”</strong>. We will send an AmountRequest to this endpoint. Then, we say to API , brother calculate an amount using the discount rates according to the fields I sent to the API in AmountRequest and present it to me as an answer. After this request the API presents this AmountResponse for us.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*XrL7ALIcKn9ytjoyXiR0TA.png" /><figcaption>Structure of Calculate Discounted Amount API</figcaption></figure><p><strong>AmountRequest</strong></p><pre>{<br>  &quot;amount&quot;: 100,<br>  &quot;isBrandDiscount&quot;: true,<br>  &quot;isBasketDiscount&quot;: false<br>}</pre><p><strong>AmountResponse</strong></p><pre>{<br>    &quot;amount&quot;: 75,<br>    &quot;totalDiscountPercentage&quot;: 0.25,<br>    &quot;description&quot;: &quot;Calculated the amount with base discount percentage. <br>    | Added the brand discount.&quot;<br>}</pre><h3>2) Let’s Create Our Models</h3><p>Firstly , we prepare project packages and structures.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/828/1*ktOtbnoRtSwQudn4KrBwsw.png" /></figure><p>Our models consist of the 3 structs.</p><ul><li>Amount</li><li>AmountRequest</li><li>AmountResponse</li></ul><p>Let’s create an Amount struct. This struct returns a float64 amount value. We will add a public method called CalculateDiscountedAmount for calculating discounted amounts, making it suitable for use in decorators.</p><h4>Amount</h4><pre>package model<br><br>import (<br> &quot;math&quot;<br>)<br><br>type Amount struct {<br> Value float64<br>}<br><br>func NewAmount(amount float64) *Amount {<br> return &amp;Amount{Value: amount}<br>}<br><br>func (a *Amount) CalculateDiscountedAmount(discountPercentage float32) float64 {<br> discountedAmount := a.Value - (a.Value * float64(discountPercentage))<br> roundedAmount := math.Round(discountedAmount*100) / 100<br> return roundedAmount<br>}</pre><h4>AmountRequest</h4><p>AmountRequest has amount field, isBrandDiscount field and isBasketDiscount field.</p><pre>package request<br><br>type AmountRequest struct {<br> Amount           float64 `json:&quot;amount&quot;`<br> IsBrandDiscount  bool    `json:&quot;isBrandDiscount&quot;`<br> IsBasketDiscount bool    `json:&quot;isBasketDiscount&quot;`<br>}</pre><h4>AmountResponse</h4><p>AmountResponse has amount field, totalDiscountPercentage field and description field.</p><pre>package response<br><br>type AmountResponse struct {<br> Amount                  float64 `json:&quot;amount&quot;`<br> TotalDiscountPercentage float32 `json:&quot;totalDiscountPercentage&quot;`<br> Description             string  `json:&quot;description&quot;`<br>}</pre><h3>3) Let’s Create Our Decorators</h3><p>Firstly , we created the IAmount interface for the Decorator Implementations. We created the GetAmount function and it returns the AmountResponse.</p><pre>package ports<br><br>import &quot;design-patterns-go/structural/decorator/domain/dto/response&quot;<br><br>type IAmount interface {<br> GetAmount() *response.AmountResponse<br>}</pre><p>First implementation is the BaseAmount , Base Amount has a baseDiscountPercentage private const value and this value is %0. So BaseAmount equals the Request Amount Value.</p><pre>package discount<br><br>import (<br> &quot;design-patterns-go/structural/decorator/pkg/domain/dto/request&quot;<br> &quot;design-patterns-go/structural/decorator/pkg/domain/dto/response&quot;<br> &quot;design-patterns-go/structural/decorator/pkg/domain/model&quot;<br>)<br><br>const baseDiscountPercentage float32 = 0.0<br><br>type BaseAmount struct {<br> request *request.AmountRequest<br>}<br><br>func NewBaseAmount(r *request.AmountRequest) *BaseAmount {<br> return &amp;BaseAmount{request: r}<br>}<br><br>func (ba *BaseAmount) GetAmount() *response.AmountResponse {<br> amount := model.NewAmount(ba.request.Amount)<br> discountedAmount := amount.CalculateDiscountedAmount(baseDiscountPercentage)<br> return &amp;response.AmountResponse{<br>  Amount:                  discountedAmount,<br>  TotalDiscountPercentage: baseDiscountPercentage,<br>  Description:             &quot;Calculated the amount with base discount percentage.&quot;,<br> }<br>}</pre><p>The second implementation is the brand discount amount. Let this discount type be a 25% discount rate created by the brand’s own business logic. Here, before decorating, let’s instantiate the previousAmount object by chaining our GetAmount function from our interface. Then, let’s use our function for calculation and calculate the discountedAmount value.</p><pre>package discount<br><br>import (<br> &quot;design-patterns-go/structural/decorator/domain/dto/response&quot;<br> &quot;design-patterns-go/structural/decorator/domain/model&quot;<br> &quot;design-patterns-go/structural/decorator/ports&quot;<br>)<br><br>const brandDiscountPercentage float32 = 0.25<br><br>type BrandDiscountAmountDecorator struct {<br> amount ports.IAmount<br>}<br><br>func NewBrandDiscountDecorator(a ports.IAmount) *BrandDiscountAmountDecorator {<br> return &amp;BrandDiscountAmountDecorator{amount: a}<br>}<br><br>func (bda *BrandDiscountAmountDecorator) GetAmount() *response.AmountResponse {<br> previousAmount := bda.amount.GetAmount()<br> amount := model.NewAmount(previousAmount.Amount)<br> discountedAmount := amount.CalculateDiscountedAmount(brandDiscountPercentage)<br> return &amp;response.AmountResponse{<br>  Amount:                  discountedAmount,<br>  TotalDiscountPercentage: previousAmount.TotalDiscountPercentage + brandDiscountPercentage,<br>  Description:             previousAmount.Description + &quot; | Added the brand discount.&quot;,<br> }<br>}</pre><p>The last implementation is the basket discount amount. Basket Discount is a type of discount where we apply an extra discount to the price in the basket at the end of all discounts. We said that the rate of this type of discount is 10%. As in the previous decorator, let’s call our previousAmount with the GetAmount method of our interface and change the amount in the last state.</p><pre>package discount<br><br>import (<br> &quot;design-patterns-go/structural/decorator/domain/dto/response&quot;<br> &quot;design-patterns-go/structural/decorator/domain/model&quot;<br> &quot;design-patterns-go/structural/decorator/ports&quot;<br>)<br><br>const basketDiscountPercentage float32 = 0.10<br><br>type BasketDiscountAmountDecorator struct {<br> amount ports.IAmount<br>}<br><br>func NewBasketDiscountDecorator(a ports.IAmount) *BasketDiscountAmountDecorator {<br> return &amp;BasketDiscountAmountDecorator{amount: a}<br>}<br><br>func (bda *BasketDiscountAmountDecorator) GetAmount() *response.AmountResponse {<br> previousAmount := bda.amount.GetAmount()<br> amount := model.NewAmount(previousAmount.Amount)<br> discountedAmount := amount.CalculateDiscountedAmount(basketDiscountPercentage)<br> return &amp;response.AmountResponse{<br>  Amount:                  discountedAmount,<br>  TotalDiscountPercentage: previousAmount.TotalDiscountPercentage + basketDiscountPercentage,<br>  Description:             previousAmount.Description + &quot; | Added the basket discount.&quot;,<br> }<br>}</pre><h3>4) Let’s Create Our Service</h3><p>After preparing our decorators, let’s create a simple service and instantiate the amount value in this service according to the parameters we sent in the request, using the decorators we want.</p><pre>package service<br><br>import (<br> &quot;design-patterns-go/structural/decorator/domain/discount&quot;<br> &quot;design-patterns-go/structural/decorator/domain/dto/request&quot;<br> &quot;design-patterns-go/structural/decorator/domain/dto/response&quot;<br> &quot;design-patterns-go/structural/decorator/ports&quot;<br>)<br><br>type DiscountService struct {<br>}<br><br>func NewDiscountService() *DiscountService {<br> return &amp;DiscountService{}<br>}<br><br>func (ds *DiscountService) CalculateDiscountedAmount(req *request.AmountRequest) (*response.AmountResponse, error) {<br> var amount ports.IAmount<br> amount = discount.NewBaseAmount(req)<br><br> if req.IsBrandDiscount {<br>  amount = discount.NewBrandDiscountDecorator(amount)<br> }<br><br> if req.IsBasketDiscount {<br>  amount = discount.NewBasketDiscountDecorator(amount)<br> }<br><br> return amount.GetAmount(), nil<br>}</pre><h3>5) Let’s Create Our Handler and Router</h3><p>After creating our service, let’s create a handler with which we can process our HTTP requests, and then use this handler in our presentation layer to serve our API.</p><p>Let’s take advantage of go gin as an http provider. You can paste the following command into the terminal to add Go Gin for our project.</p><pre>$ go get -u github.com/gin-gonic/gin</pre><pre>package handler<br><br>import (<br> &quot;design-patterns-go/structural/decorator/domain/dto/request&quot;<br> &quot;design-patterns-go/structural/decorator/domain/service&quot;<br> &quot;github.com/gin-gonic/gin&quot;<br> &quot;net/http&quot;<br>)<br><br>func CalculateDiscountHandler(ctx *gin.Context) {<br> var req request.AmountRequest<br> if err := ctx.ShouldBindJSON(&amp;req); err != nil {<br>  ctx.JSON(http.StatusBadRequest, gin.H{&quot;error json parse&quot;: err.Error()})<br>  return<br> }<br><br> discountService := service.NewDiscountService()<br> amountResponse, err := discountService.CalculateDiscountedAmount(&amp;req)<br> if err != nil {<br>  ctx.JSON(http.StatusInternalServerError, gin.H{&quot;error&quot;: err.Error()})<br>  return<br> }<br> ctx.JSON(http.StatusOK, amountResponse)<br>}</pre><p>Let’s define the handler function we created to a POST /calculate-amount endpoint. Then, let’s serve it on port 9090.</p><pre>package router<br><br>import (<br> &quot;design-patterns-go/structural/decorator/internal/infrastructure/http/handler&quot;<br> &quot;github.com/gin-gonic/gin&quot;<br> &quot;log&quot;<br>)<br><br>func StartDiscountApp() {<br> r := gin.Default()<br><br> r.POST(&quot;/calculate-amount&quot;, handler.CalculateDiscountHandler)<br><br> log.Fatal(r.Run(&quot;:9090&quot;))<br>}</pre><p>Lastly , let’s start our app in the main function.</p><pre>package main<br><br>import (<br> &quot;design-patterns-go/structural/decorator/internal/infrastructure/http/router&quot;<br>)<br><br>func main() {<br> router.StartDiscountApp()<br>}</pre><h3>5) Let’s Test It Our API</h3><ul><li>Scenario-1<br>BrandDiscount = false, BasketDiscount = false</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-0zbhcr24Cry66VcKOlzqQ.png" /></figure><ul><li>Scenario-2 <br>BrandDiscount = true , BasketDiscount = false</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7dpg7kaSRQrWWsNGmOSiFw.png" /></figure><ul><li>Scenario-3<br>BrandDiscount = false, BasketDiscount = true</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*D4Wh_A1xaStO1afD9_fLZQ.png" /></figure><ul><li>Scenario-4<br>BrandDiscount = true, BasketDiscount = true</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ld_FiqjkmaR-EO1Fr_SAXA.png" /></figure><p>We created a simple API client together using the Decorator design pattern. Thank you very much if you have read this far.</p><p>In the future , see you with other API examples using different design patterns. Take care of yourselves 👋</p><p><a href="https://github.com/PoyrazM/design-patterns-go">https://github.com/PoyrazM/design-patterns-go</a></p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=2c8d70b9b4c0" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Kotlin + Spring Boot Validation Ve Global Exception Handling]]></title>
            <link>https://medium.com/@mertcanpoyraz/kotlin-spring-boot-validation-ve-global-exception-handling-39541aaf75da?source=rss-d9257e6a6fa8------2</link>
            <guid isPermaLink="false">https://medium.com/p/39541aaf75da</guid>
            <category><![CDATA[kotlin]]></category>
            <category><![CDATA[spring-boot]]></category>
            <category><![CDATA[validation]]></category>
            <category><![CDATA[exception-handling]]></category>
            <category><![CDATA[backend]]></category>
            <dc:creator><![CDATA[Mertcan Poyraz]]></dc:creator>
            <pubDate>Mon, 14 Aug 2023 15:50:18 GMT</pubDate>
            <atom:updated>2023-08-15T05:55:35.243Z</atom:updated>
            <content:encoded><![CDATA[<h3>Kotlin + Spring Boot ile Validation Ve Global Exception Handling</h3><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5Sk996o4wcavGu-86JoLqg.png" /></figure><p>Herkese selamlar , bu yazımda Kotlin ve Spring Boot ile Spring Boot Validation ve Global Exception Handling konularından bahsedeceğim.</p><p>Bu yazım daha öncesinde bahsetmiş olduğum ‘Kotlin ve Spring Boot 3 Kullanılarak REST API Nasıl Geliştirilir’ adlı yazımın devamı olacak. Eğer okumadıysanız ve okumak isterseniz linki de aşağıya bırakıyorum.</p><p><a href="https://medium.com/@mertcanpoyraz/kotlin-ve-spring-boot-3-kullan%C4%B1larak-rest-api-nas%C4%B1l-geli%C5%9Ftirilir-23c40defd095">Kotlin ve Spring Boot 3 Kullanılarak REST API Nasıl Geliştirilir</a></p><p>Şimdiden hepinize keyifli okumalar dilerim.</p><p>Başlayalım o halde !</p><h3><strong>1) Spring Boot Validation</strong></h3><p>Spring Boot Validation, Request’te gönderdiğimiz verileri DB’ye istek gitmeden kontrol ederek uygunluklarını doğrulayan bir araçtır. Bu sayede geliştirdiğimiz API’ye Request’te yanlış veya geçersiz veri göndermemizi engeller. Yani, kullanıcıların doğru ve beklenen verileri girmesini sağlar ve böylece uygulamanın daha güvenilir ve istikrarlı çalışmasını sağlar.</p><p>Ayrıca konumuzla alakalı daha öncesinde Java ve Spring Boot Validation adlı bir yazı yazmıştım. Eğer o yazımı da okumak isterseniz aynı şekilde linki bırakıyorum. Sonrasında da Dependency’mizi ekleyerek ilk yazımızda geliştirdiğimiz projemizle devam edelim.</p><p><a href="https://medium.com/@mertcanpoyraz/spring-boot-api-validasyon-mesajlar%C4%B1-175a771f9ccc">Spring Boot API Validasyon Mesajları</a></p><p>Spring Boot Validation’u projemizde kullanabilmek için öncelikle <strong>build.gradle.kts</strong> adlı dosyamızdaki bağımlılıklarımıza bir de spring-boot-starter-validation bağımlılığını eklememiz gerekmektedir.</p><pre>implementation(&quot;org.springframework.boot:spring-boot-starter-validation&quot;)</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/660/1*B0D2l54Z-bp9CxVbAPEtPA.png" /></figure><p>Bağımlılığımızı ekledikten sonra da ilk önce mesajlarımızı oluşturalım. 3 adet mesaj tanımladım burada örnek olması için. Product Request DTO’muzda 4 adet parametreye sahiptik , bunlar ;</p><ul><li>productName</li><li>productType</li><li>price</li><li>secretInfo</li></ul><p>Öncelikle bir adet <strong>ValidationMessages</strong> adında properties dosyası oluşturalım.</p><pre>## Product Name Validations ##<br>com.poyrazm.product-name.size.message=Product Name Should Not Be Less Than 3 Characters !<br><br>## Product Type Validations ##<br>com.poyrazm.product-type.not-empty.message=Product Type Should Not Be Empty !<br><br>## Product Price Validations ##<br>com.poyrazm.price.not-less-one.message=Price Should Not Be Less Than 1 !</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/783/1*s2O8cg5Tq7m0SFv0a6B94g.png" /></figure><p>4 adet parametremiz vardı ama 3 adet parametre için validasyon mesajları oluşturduk istersek bunları daha da çeşitlendirebiliriz ama şu an için bu yapıda bu mesajlar fazlasıyla işimizi görecektir.</p><p>Bu mesajlarımızda da valide ettiğimiz durumlar da şu şekildedir.</p><ul><li>Ürün oluştururken ürün ismini 3 karakterden daha az girme durumu.</li><li>Ürün oluştururken ürün çeşidini boş girme durumu.</li><li>Ürün oluştururken ürünün birim fiyatını 1&#39;den daha az girme durumu.</li></ul><p>Mesajlarımızı oluşturduktan sonra ise Request attığımız DTO classına giderek bu objelerimiz için gerekli Validation tanımlamalarını yapalım.</p><pre>import jakarta.validation.constraints.*<br>import java.math.BigDecimal<br><br>data class ProductRequest(<br>    @field:Size(min = 3, message = &quot;{com.poyrazm.product-name.size.message}&quot;)<br>    var productName : String,<br><br>    @field:NotEmpty(message = &quot;{com.poyrazm.product-type.not-empty.message}&quot;)<br>    var productType : String,<br><br>    @field:DecimalMin(value = &quot;1&quot;, message = &quot;{com.poyrazm.price.not-less-one.message}&quot;)<br>    var price : BigDecimal,<br><br>    var secretInfo : String? = null,<br>)</pre><pre>Example:<br>Syntax -&gt; @field:Size(message = &quot;{message.name.in.properties.file}&quot;)</pre><p>Ürün ismi için minimum karakter sayısını 3 olarak belirledik ve hatalı parametre gönderme durumumuzda mesajımızı , ValidationMessages.properties dosyamızdaki productName için oluşturduğumuz mesaj olarak tanımladık.</p><p>Ürün çeşidi için Request atarken productType parametresini boş gönderemeyeceğimizi söyledik ve aynı şekilde oluşturduğumuz mesajı tanımladık.</p><p>Son olarak da ürün fiyatını oluştururken price parametresini minimum 1 birim fiyatı olarak gönderebilmemiz gerektiğini söyledik. Yani biz Request’te 1&#39;in altında bir price set etmeye çalışırsak bize properties dosyamızda bu senaryo için tanımladığımız hata mesajı döndürecek.</p><p>Bu taraftaki son adımımız için Controller’da fonksiyonda request parametresini gönderdiğimiz zaman Request DTO’muzun önüne Valid anotasyonu koymamız gerekiyor. Daha sonrasında da olası bir hata alma durumumuzda bu validasyon hatalarını handle edeceğimiz kodu yazmamız gerekiyor ama onu aşağıda Global Exception Handling kısmında belirteceğiz. O yüzden Valid anotasyonunu koyup Global Exception Handling konumuza geçebiliriz.</p><p>Biz 2 tane HTTP Metotumuzda Request gönderiyorduk.</p><ul><li>createProduct fonksiyonunda</li><li>updateProduct fonksiyonunda</li></ul><p>Eklemelerimizi şu şekilde tanımlayıp Global Exception Handling konumuza başlayalım.</p><pre>@PostMapping<br>    fun createProduct(@Valid @RequestBody req : ProductRequest) : ResponseEntity&lt;ProductResponse&gt; {<br>        val savedProduct = productService.createProduct(req)<br>        return ResponseEntity(savedProduct, HttpStatus.CREATED)<br>    }</pre><pre>@PutMapping(&quot;/{productId}&quot;)<br>    fun updateProduct(@PathVariable productId : Long, @Valid @RequestBody req : ProductRequest) : ResponseEntity&lt;ProductResponse&gt; {<br>        val updatedProduct = productService.updateProductById(productId, req)<br>        return ResponseEntity.ok(updatedProduct)<br>    }</pre><h3>2) Global Exception Handling</h3><p>Global Exception Handling Runtime’da düşebileceğimiz hataları yakalayıp onları yönlendirebilmemizi sağlar. Ayrıca Business Logic’lerle beraber iş kurallarımıza uymayan durumlarda da hata mesajı yönlendirebiliriz.</p><p>İlk önce bir ValidationErrors ve Exception Response’larımız için bir standart belirleyelim. İki response’ta da ortak fieldlar olacağı için Base bir error response oluşturalım. Bir adet IApiErrorResponse adında interface oluşturalım.</p><pre>interface IApiErrorResponse {<br>    val isSuccess : Boolean?<br>    val status : String?<br>    val timeStamp : LocalDateTime?<br>    val message : String?<br>    val statusCode : Int?<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/391/1*2MAm7WNZ966wX-CDurvLGw.png" /></figure><p>Sonrasında ise dto paketinin altındaki response paketinin içinde de 2 adet data class oluşturalım ve birisine ExceptionErrorResponse , diğerine de ValidationErrorResponse adını verelim. Bu data classlarımız da oluşturduğumuz bu Interface’yi implemente etsin. Response’taki ortak fieldlarımız bu Interface’den gelsin. Bu 2 Response’a özel bir field’ımız olursa da data class’larında bu field’ı da spesifik olarak ekleyebiliriz.</p><pre>data class ExceptionErrorResponse(<br>    override val isSuccess: Boolean?,<br>    override val status: String?,<br>    override val timeStamp: LocalDateTime?,<br>    override val message: String?,<br>    override val statusCode: Int?,<br>) : IApiErrorResponse</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/391/1*2zmo-pIUndHxrVvcjnmKLg.png" /></figure><pre>data class ValidationErrorResponse(<br>    override val isSuccess: Boolean?,<br>    override val status : String? = null,<br>    override val timeStamp: LocalDateTime? = null,<br>    override val message: String? = null,<br>    override val statusCode: Int? = null,<br>    var validationErrors : Map&lt;String, String&gt;? = null<br>) : IApiErrorResponse</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/492/1*WDfi1j-1Naw_snhWP1o5vw.png" /></figure><p>Validation Error Response’ta bir tane daha variable oluşturduk. Bunun sebebi GlobalExceptionHandler’da Validation Hatalarını yakaladığımız zaman 1&#39;den fazla Validation Hatalarını da bu Map’in içine putlayabilmek için.</p><p>Bir sonraki aşamada da oluşturduğumuz bu data classlar için Parser’a ihtiyacımız olacak. O yüzden bir adet ErrorResponseParser adında Kotlin Class oluşturalım.</p><pre>class ErrorResponseParser {<br><br>    fun validationParser(validationErrors : Map&lt;String, String&gt;, timeStamp: LocalDateTime, statusCode: Int) : ValidationErrorResponse {<br>        return ValidationErrorResponse(<br>            isSuccess = false,<br>            status = &quot;failed&quot;,<br>            message = &quot;Validation Errors !&quot;,<br>            timeStamp = timeStamp,<br>            statusCode = statusCode,<br>            validationErrors = validationErrors<br>        )<br>    }<br><br>    fun exceptionParser(message: String, statusCode: Int, timeStamp: LocalDateTime) : ExceptionErrorResponse {<br>        return ExceptionErrorResponse(<br>            isSuccess = false,<br>            status = &quot;failed&quot;,<br>            message = message,<br>            statusCode = statusCode,<br>            timeStamp = timeStamp<br>        )<br>    }<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*gueZJcg6ux-uoq4kKQCVDg.png" /></figure><p>Projemizin içinde exception adında bir paket oluşturalım ve Exception’larımızı oluşturmaya başlayalım.</p><h4>a) Base Exception</h4><p>Bir adet BaseException adlı open class oluşturalım. Open class ile miras alınabilir hale getirelim.</p><pre>open class BaseException(override val message: String) : RuntimeException(message) {<br>    protected val log: Logger = LoggerFactory.getLogger(BaseException::class.java)<br>}</pre><h4>b) Exception’ları Oluşturalım</h4><p>4 adet Exception class’ı oluşturalım.</p><ul><li>ProductNotCreatedException</li><li>ProductNotFoundException</li><li>ProductNotUpdatedException</li><li>ProductNotDeletedException</li></ul><pre>class ProductNotCreatedException(message: String) : BaseException(message) {<br>    init {<br>        log.error(&quot;[ProductNotCreatedException] -&gt; message : {}&quot;, message)<br>    }<br>}</pre><pre>class ProductNotFoundException(message: String) : BaseException(message) {<br>    init {<br>        log.error(&quot;[ProductNotFoundException] -&gt; message : {}&quot;, message)<br>    }<br>}</pre><pre>class ProductNotUpdatedException(message : String) : BaseException(message) {<br>    init {<br>        log.error(&quot;[ProductNotUpdatedException] -&gt; message : {}&quot;, message)<br>    }<br>}</pre><pre>class ProductNotDeletedException(message : String) : BaseException(message) {<br>    init {<br>        log.error(&quot;[ProductNotDeletedException] -&gt; message : {}&quot;, message)<br>    }<br>}</pre><p>Burada init yapısını kullanarak bu sınıfların başlatılma anında , yani hatanın yakalandığı anda hatalı log mesajını basmasını istiyoruz. Parametrik olarak da String veri tipinde mesaj vereceğimizi belirtiriz.</p><h4>c) Hata Mesajlarımızı Oluşturalım</h4><p>Bir adet IExceptionTypes adında Interface oluşturalım. Bu interface’ye de diyelim ki sen implemente olduğun her classtan String veri tipinde bir değer getirmesini iste. Bize bir disiplin sağla.</p><pre>interface IExceptionTypes {<br>    fun getValue() : String<br>}</pre><p>Bir adet ProductExceptionTypes adında enum class’ı oluşturalım ve bu Interface’miz ile besleyelim.</p><pre>enum class ProductExceptionTypes(private val value : String)  : IExceptionTypes{<br><br>    PRODUCT_NOT_CREATED(&quot;Product Not Created ! Because Product Name Is Exist : &quot;),<br>    PRODUCT_NOT_FOUND(&quot;Product Not Found With This ID ! ID -&gt; &quot;),<br>    PRODUCTS_NOT_FOUND(&quot;Any Products Not Found In The Database !&quot;),<br>    PRODUCT_NOT_UPDATED(&quot;Product Not Updated With This ID ! Product ID Is NOT Exist !&quot;),<br>    PRODUCT_NOT_DELETED(&quot;Product Not Deleted With This ID ! Product ID Is NOT Exist !&quot;);<br><br>    override fun getValue(): String {<br>        return this.value<br>    }<br>}</pre><h4>d) GlobalExceptionHandler Sınıfımızı Oluşturalım</h4><ul><li><strong>RestControllerAdvice :</strong> Sınıfımıza bu anotasyonu eklersek , sınıfımıza uygulamanın genelindeki istisnaları yakalayabilip ve yönetebileceğimizi söyleriz.</li><li><strong>ExceptionHandler :</strong> Metotumuza bu anotasyonu eklersek , metotumuzun yakaladığımız istisna karşısında nasıl reaksiyon vermesi gerektiğini söyleriz. Yani yakaladığımız istisnayı handle etmişsek , bu metot otomatik olarak devreye girer.</li></ul><p>GlobalExceptionHandler classımızda 6 adet istisnayı yakaladığımızda nasıl davranması gerektiğini söylemiş olduk.</p><ul><li>Ürünü Database’de bulamadığımız durum.</li><li>Hiçbir ürün bulamadığımız durum.</li><li>Ürünü oluşturamadığımız durum.</li><li>Ürünü güncelleyemediğimiz durum.</li><li>Ürünü silemediğimiz durum.</li><li>Request Body’mizde göndereceğimiz objeleri valide ettiğimiz durum.</li></ul><p>Az önce oluşturduğumuz parser metotlarını da burada kullanmış olduk.</p><pre>@RestControllerAdvice<br>class GlobalExceptionHandler {<br><br>    val parser = ErrorResponseParser()<br><br>    @ExceptionHandler(ProductNotCreatedException::class)<br>    @ResponseStatus(HttpStatus.BAD_REQUEST)<br>    private fun handleProductNotCreatedException(exception: ProductNotCreatedException): ExceptionErrorResponse {<br>        return parser.exceptionParser(<br>            message = exception.message,<br>            statusCode = HttpStatus.BAD_REQUEST.value(),<br>            timeStamp = LocalDateTime.now()<br>        )<br>    }<br><br>    @ExceptionHandler(ProductNotFoundException::class)<br>    @ResponseStatus(HttpStatus.NOT_FOUND)<br>    private fun handleProductNotFoundException(exception: ProductNotFoundException): ExceptionErrorResponse {<br>        return parser.exceptionParser(<br>            message = exception.message,<br>            statusCode = HttpStatus.NOT_FOUND.value(),<br>            timeStamp = LocalDateTime.now()<br>        )<br>    }<br><br>    @ExceptionHandler(ProductNotDeletedException::class)<br>    @ResponseStatus(HttpStatus.NOT_FOUND)<br>    private fun handleProductNotDeletedException(exception: ProductNotDeletedException): ExceptionErrorResponse {<br>        return parser.exceptionParser(<br>            message = exception.message,<br>            statusCode = HttpStatus.NOT_FOUND.value(),<br>            timeStamp = LocalDateTime.now()<br>        )<br>    }<br><br>    @ExceptionHandler(ProductNotUpdatedException::class)<br>    @ResponseStatus(HttpStatus.NOT_FOUND)<br>    private fun handleProductNotUpdatedException(exception: ProductNotUpdatedException): ExceptionErrorResponse {<br>        return parser.exceptionParser(<br>            message = exception.message,<br>            statusCode = HttpStatus.NOT_FOUND.value(),<br>            timeStamp = LocalDateTime.now()<br>        )<br>    }<br><br>    @ExceptionHandler(MethodArgumentNotValidException::class)<br>    @ResponseStatus(HttpStatus.BAD_REQUEST)<br>    private fun handleValidationException(exception: MethodArgumentNotValidException): ValidationErrorResponse {<br><br>        val validationErrors = HashMap&lt;String, String&gt;()<br>        for (fieldError in exception.bindingResult.fieldErrors) {<br>            validationErrors[fieldError.field] = fieldError.defaultMessage.toString()<br>        }<br><br>        return parser.validationParser(<br>            validationErrors = validationErrors,<br>            timeStamp = LocalDateTime.now(),<br>            statusCode = HttpStatus.BAD_REQUEST.value()<br>        )<br>    }<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/983/1*e8ADjXfdbmKcSSUfK2fUzQ.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/955/1*oW6ttBYXuKZTWMss3991Gg.png" /></figure><h4><strong>e) Servis İmplementasyon Sınıfımızda Logiclerimize Göre İstisnaları Yakalayalım</strong></h4><p>Logiclerimize göre istisnaları şu şekilde yakalayalım. Normalde PUT ve DELETE HTTP Metotlarımızda Optional&lt;Product&gt; metotumuzun getirdiği <strong>orElseThrow</strong> metotumuzu ProductID’yi Database’de bulamadığımız durumlar için <strong>NotFoundException</strong> fırlatmak için kullanabiliriz. Fakat mantık daha iyi anlaşılsın diye Update ve Delete için 2 adet farklı Exception sınıfı oluşturmuştuk.</p><pre>@Service<br>class ProductServiceImpl(<br>    private val productRepository: IProductRepository,<br>    private val mapper : ProductMapper) : IProductService {<br><br>    override fun createProduct(request: ProductRequest): ProductResponse {<br>        val isProductNotExist = productRepository.existsProductByProductName(request.productName).not()<br><br>        if (isProductNotExist) {<br>            val productRequest = mapper.requestToEntity(request)<br>            productRepository.save(productRequest)<br>            return mapper.entityToResponse(productRequest)<br>        } else throw ProductNotCreatedException(ProductExceptionTypes.PRODUCT_NOT_CREATED.getValue() + request.productName)<br>    }<br><br>    override fun getAllProducts(): List&lt;ProductResponse&gt; {<br>        val allProducts = productRepository.findAll().toList()<br><br>        val isNotAllProductsEmpty = allProducts.isEmpty().not()<br><br>        if (isNotAllProductsEmpty) return mapper.entityListToResponseList(allProducts)<br>        else throw ProductNotFoundException(ProductExceptionTypes.PRODUCTS_NOT_FOUND.getValue())<br>    }<br><br>    override fun receiveProductById(productId: Long): ProductResponse {<br>        val validProduct = findById(productId).orElseThrow {<br>            throw ProductNotFoundException(ProductExceptionTypes.PRODUCT_NOT_FOUND.getValue() + productId)<br>        }<br><br>        return mapper.entityToResponse(validProduct)<br>    }<br><br>    override fun updateProductById(productId: Long, request: ProductRequest): ProductResponse {<br>        val validProduct = findById(productId)<br><br>        val isProductPresent = validProduct.isPresent<br><br>        if (isProductPresent) {<br>            val updatedProduct = validProduct.get()<br>            mapper.updateRequestToEntity(request, updatedProduct)<br>            productRepository.save(updatedProduct)<br>            return mapper.entityToResponse(updatedProduct)<br>        } else throw ProductNotUpdatedException(ProductExceptionTypes.PRODUCT_NOT_UPDATED.getValue())<br>    }<br><br>    override fun deleteProductById(productId: Long) {<br>        val validProduct = findById(productId)<br><br>        val isProductPresent = validProduct.isPresent<br><br>        if (isProductPresent) productRepository.delete(validProduct.get())<br>        else throw ProductNotDeletedException(ProductExceptionTypes.PRODUCT_NOT_DELETED.getValue())<br>    }<br><br>    private fun findById(productId: Long) : Optional&lt;Product&gt; {<br>        return productRepository.findById(productId)<br>    }<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1013/1*2qmsXo1MVOoS_Od4fh4W9A.png" /></figure><h4>f) İstisnalarımızı Test Edelim.</h4><p>Öncelikle Database’imize bakalım.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*GUMTo7OQrGbW4hxpfTc2DA.png" /></figure><p>Var olan ‘product_name’ ile ürün oluşturmayı deneyelim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fFtUYG3e5VAOpBrhJZFEjA.png" /></figure><p>Farklı bir ‘product_name’ ile ürün oluşturmayı deneyelim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*NmEgt7JpU2rl5zYD3Ih6Zw.png" /></figure><p>Logic’imizin doğru çalıştığını ve aksi durumda yakaladığımız istisnayı fırlatabildiğimizi görmüş olduk. Şimdi Validation’u test edelim. Tanımladığımız validasyonların aksi durumunda bir Request atalım.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*UNM1elytv0BFJJhBgIAmWA.png" /></figure><p>ID’si 1 olan ürünümüzü silip tekrar , silmeyi deneyelim. Sildikten sonra Database’imizi de kontrol edelim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*BnWChpSrftxmK6uXhup8sg.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*84zOLF1lvz7W6UEkXpSRgQ.png" /></figure><p>Sildiğimiz ürünümüze GET isteği atalım.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*wRm438_cNbqaJ_yhCTQ4MA.png" /></figure><p>Şimdi de tüm ürünlerimizi silip , ürünlerimizin hepsini listeleyen Endpoint’e istek atalım. Öncesinde de Database kontrolü yapalım.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_N-COe3AO6rDH3MgYOL6Aw.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Zb91fKu6ksAFAKQD7B-W1Q.png" /></figure><p>Exception classlarımızda sınıf kullanıldığı ilk anda terminale log gönderecek bir yapı kullanmıştık.</p><p>Konsolumuzdan kontrol edelim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*cyiqvHWP0N2Zw0M-aOFERw.png" /></figure><p>Evet gördüğünüz gibi Validation ve GlobalExceptionHandling konuları aslında dışardan gözüktüğü gibi korkutucu değil. Buraya kadar okuduysanız çok teşekkür ederim. Sonraki yazılarımda API Gateway Katmanında Authentication ve Spring Security konularından bahsetmeyi düşünüyorum.</p><p>Başka yazılarımızda görüşmek üzere , kendinize çok iyi bakın 👋</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=39541aaf75da" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Kotlin ve Spring Boot 3 Kullanılarak REST API Nasıl Geliştirilir]]></title>
            <link>https://medium.com/enuygun-wingie-tech/kotlin-ve-spring-boot-3-kullan%C4%B1larak-rest-api-nas%C4%B1l-geli%C5%9Ftirilir-23c40defd095?source=rss-d9257e6a6fa8------2</link>
            <guid isPermaLink="false">https://medium.com/p/23c40defd095</guid>
            <category><![CDATA[kotlin]]></category>
            <category><![CDATA[spring-boot]]></category>
            <category><![CDATA[backend]]></category>
            <category><![CDATA[rest]]></category>
            <category><![CDATA[api]]></category>
            <dc:creator><![CDATA[Mertcan Poyraz]]></dc:creator>
            <pubDate>Mon, 03 Jul 2023 21:53:05 GMT</pubDate>
            <atom:updated>2023-07-31T07:16:57.289Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*C5_yajr4WeehJRNr.png" /></figure><p>Herkese selamlar , bu yazımda CRUD bir REST API Kotlin ve Spring Boot kullanılarak nasıl geliştirilir ondan bahsedeceğim.</p><p>Bu yazıda sadece CRUD bir API nasıl geliştirilir konu başlığımız ama daha sonra Global Exception Handling , Security konularını da başka yazılarda ele alacağım. Şimdiden hepinize keyifli okumalar.</p><p>Başlayalım !</p><h3><strong>1) Projemizi Oluşturalım</strong></h3><p>Projemizi şimdilik bizim için yeterli olan konfigürasyonları ekleyerek oluşturalım.</p><p>Projeyi oluştururken eğer IntelliJ IDEA Ultimate kullanıyorsak , new Project’i seçip direkt Spring projesi oluşturabiliriz. Ama eğer Community Edition kullanıyorsak da start.spring.io aracılığıyla da oluşturabiliriz.</p><p><a href="https://start.spring.io/">https://start.spring.io/</a></p><p>İlk kısımda sadece projemizin group ve artifact name’ini doldurduk. Daha sonrasında ise projemizde kullanacağımız dili Kotlin olarak işaretledik ve ardından Dependency Management için Gradle-Kotlin seçeneğimizi işaretledik.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*uVoNrNPsuoYQTkwEJumdKA.png" /></figure><p>Hemen ardından şimdilik Web , JPA ve MySQL Dependency’lerinden yararlanacağımız için sadece bu 3 Dependency’i projeye eklesek yeterli olur.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*HqH147qH2jnNaL3ulN31NQ.png" /></figure><p>Dependency’lerimizi seçip projemizi create ettikten sonra , Swagger implementasyonu için build.gradle.kts adlı dosyamızda bulunan Dependency’lerimizin arasına Swagger’ı da ekleyebiliriz ayrıyeten. Swagger kullanarak API’larımızı hızlıca test edebilir. CURL alarak Postman , Insomnia gibi toollarda da koleksiyon oluşturabiliriz. Kısacası API’mizin dokümantasyonunu sağlar bize Swagger.</p><pre>implementation(&quot;org.springdoc:springdoc-openapi-starter-webmvc-ui:2.1.0&quot;)</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*sHi4W87teGFsZAN_z8c3nA.png" /></figure><p>Konfigürasyon işlemlerinin son aşaması için de resources altında bir adet application.yml oluşturup , bu yaml dosyası içerisinde 2 tane ayar yapacağım. Birincisi Spring Boot ayağa kalkarken default 8080 portunda ayağa kalkar. İlk önce portumu 4000 olarak set edeceğim. Daha sonrasında ise MySQL Konfigürasyonlarını yapacağım. Bu ayarlar şu anlık localdeki MySQL için ama isterseniz Docker ile de DB bağlantısı sağlayabilirsiniz.</p><pre>server:<br>  port: 4000<br><br>spring:<br>  datasource:<br>    driver-class-name: com.mysql.cj.jdbc.Driver<br>    password: admin123<br>    url: jdbc:mysql://localhost:3306/product_db?createDatabaseIfNotExist=true<br>    username: root<br>  jpa:<br>    hibernate:<br>      ddl-auto: update<br>    properties:<br>      hibernate:<br>        dialect: org.hibernate.dialect.MySQL8Dialect<br>    show:<br>      sql: true</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*3BiTzrbX-fx9soD07V3NMg.png" /></figure><h3>2) Projemizin Struct’unu Belirleyelim</h3><p>Projemizi oluşturduktan sonra proje için bir yapı belirlememiz gerekiyor.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/617/1*Zdh2KosjHJrgVkdN3jtoKg.png" /></figure><p>Projenin yapısını bu CRUD REST Servisi için şu şekilde belirleyebiliriz.</p><ul><li><strong>Business Layer : </strong>İş katmanı servis implementasyonlarımızı yapabileceğimiz ve iş logiclerimizi yazabileceğimiz katmandır. Diğer adıyla da Servis Katmanı diyebiliriz.</li><li><strong>Presentation Layer :</strong> Servisimizi sunduğumuz katmandır. Endpoint’lerimizi bu katmanda belirleyip , servisleri Endpoint’lerimizde sunabilmemizi sağlayan katmadır. Diğer adıyla da Controller diyebiliriz.</li><li><strong>JPA (Database Layer) :</strong> Database entegrasyonlarımızı bu katmanda oluşturabiliriz. Örneğin ORM sorgularımızı bu katmandan DB’ye iletebiliriz. Diğer adıyla ise Repository’lerimizi tuttuğumuz katman diyebiliriz.</li><li><strong>DTO (Data Transfer Object) :</strong> Tablolarımızdaki verileri tamamıyla olduğu gibi değil de oluşturduğumuz DTO adlı data class’larıyla transfer etmemiz için gereklidir. Örneğin biz bütün verileri response’ta döndürmek istemeyebiliriz. Bu noktada ise biz DTO’ya abi ben senden sadece bu dataları istiyorum diyoruz ve DTO’da bize sadece o verileri getiriyor.</li><li><strong>Entity : </strong>Entity’ler bizim data class’ımızdaki kalıcı olacak verileri veritabanıyla eşlediğimiz katmandır. Yani Entity classında oluşturduğumuz her bir obje aslında tablomuzun kolonlarına eş değer oluyor.</li><li><strong>Data Binding (Mapper) :</strong> Data Binding ya da diğer adıyla Map’lemek , burada Mapper kullanmamızın amacı ise , biz Entity’lerimize request atarken objeler verebiliyoruz ya da Entity’lerimizin Response’undan da aynı şekilde objeler alıyoruz. Bu data transferi işleminde sürekli olarak objeleri classlar arasında get ya da set işlemleri yapıyoruz. Bunu her CRUD işleminde tek tek getleyip , setlemek yerine Mapper’da bir kere yapıp , bu metotla objelerimiz arasındaki veri transferini yapabiliyoruz.</li></ul><p>Projemizin Main paketinin altında her bir katman için bir adet paket oluşturuyoruz. Bu daha da genişletilebilir ama bu yazı için hazırladığım projede sadece temel bir REST API nasıl yazılır ondan bahsedeceğim için şu anlık bu yapı işimize yarayacaktır.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/988/1*ohuAbgTRoIOk-AlRmdl1AA.png" /></figure><h3>3) Entity Class’ımızı Oluşturalım.</h3><p>Projenin ilk adımı olarak öncelikle bir Entity classı oluşturup bunu da daha sonrasında DB’mizde Product tablosu ile eşleyelim.</p><p>Entity paketinin altında yeni bir Kotlin Data Class’ı oluşturalım.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/666/1*wfIBjGLcx6cB-bOADUjgoA.png" /></figure><p>Entity classımızı oluşturduktan sonra içinde DB’mize eşlemek istediğimiz objeleri oluşturalım.</p><p>Öncelikle bu classın bir Entity classı olduğunu belirtmek için Entity anotasyonundan yararlanalım. Entity anotasyonuyla classı oluşturduktan sonra DB tablomuz için bir adet foreign key obje belirtmemiz istenecektir. Bunu da ID anotasyonu kullanarak tanımlayabiliriz ve bu foreign key verisinin benzersiz bir kimliğe sahip olacağını söylemek için de IDENTITY stratejisi kullanılabilir. Bu sayede hem veritabanına benzersiz bir veri tutmasına izin verdiğimizi söylemiş oluruz hem de minimum değerden başlayarak artacak şekilde ayarlamış oluruz. Son olarak da DB ile eşlemek istediğimiz verileri şu şekilde oluşturabiliriz.</p><p>Burada PrePersist ve PreUpdate adlı 2 tane anotasyon var bunların ne olduğundan kısaca bahsedersek de PrePersist veritabanına bir nesne eklerken , ilk eklendiği anda çalışan logictir. PreUpdate ise zaten var olan bir varlık nesnesi üzerinde güncelleme yapılırsa çalışan bir logictir.</p><p>Son olarak da bazı objeleri burada nullable tanımlamamın sebebi ise , bazı objeleri DTO classlarımda requestte göndermeyeceğim ya da response’ta sergilemeyeceğim için.</p><pre><br>@Entity<br>@Table(name = &quot;product&quot;)<br>data class Product(<br>    @Id<br>    @GeneratedValue(strategy = GenerationType.IDENTITY)<br>    var id : Long? = null,<br>    var productName : String,<br>    var productType : String,<br>    var price : BigDecimal,<br>    var secretInfo : String? = null,<br>    var createdDate : LocalDateTime? = null,<br>    var updatedDate : LocalDateTime? = null<br>)<br><br>{<br>    @PrePersist<br>    fun prePersist() {<br>        createdDate = LocalDateTime.now()<br>        updatedDate = LocalDateTime.now()<br>    }<br><br>    @PreUpdate<br>    fun preUpdate() {<br>        updatedDate = LocalDateTime.now()<br>    }<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Nn7Fp1aY3mK348qR9rjQCQ.png" /></figure><p>Projemizi runlayıp tablomuzun oluşup oluşmadığını kontrol edebiliriz. Tablomuz da oluştuğuna göre şu anlık her şey yolunda gidiyor diyebiliriz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*gFgyEcrFZyWEoQSPc-7iBw.png" /></figure><h3>4) DTO Class’ımızı Oluşturalım</h3><p>Bu sefer ise dto paketimizin içinde 2 adet data class oluşturalım.<br>Şu an sadece ProductResponse ve ProductRequest adında 2 tane DTO classı oluşturacağım eğer istersek bir adet BaseResponse classı’da oluşturarak burada daha genel bir Response’ta döndürebiliriz. Ama şu anlık 1 adet Request ve 1 adet Product Response bizim işimizi görecektir.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*jlJA5pAjtYZLhzWQ0XdVOw.png" /></figure><pre><br>data class ProductResponse(<br>    var productName : String,<br>    var productType : String,<br>    var price : BigDecimal,<br>)</pre><pre><br>data class ProductRequest(<br>    var productName : String,<br>    var productType : String,<br>    var price : BigDecimal,<br>    var secretInfo : String,<br>)</pre><p>Şimdi DTO mantığını daha iyi anlayabilmek için bir adet secretInfo adında bir obje oluşturmuştum Entity’nin içerisinde. Burada ben API’da bir ürün oluştururken secret bir bilgi oluşturacağım. Ama bunu response’ta göstermek istemiyorum. Eğer DTO değil de Response’un dönüş tipini Entity olarak dönersek secretInfo’yu da göstermiş olacağız.</p><h3>5) Mapper Class’ımızı Oluşturalım</h3><p>Öncelikle bir interface oluşturalım. Bu interface’imize de IMapper ismini verelim. Bu Mapper içine soyut Response , Request ve Entity alsın. Kullanacağımız map işlemleri de şu an için 5 adet fonksiyondan oluşmakta.</p><ul><li>Entity’yi Response’a çevir.</li><li>Response’u Entity’e çevir.</li><li>Request’i Entity’e çevir.</li><li>Entity Listesini , Response Listesine çevir.</li><li>Update Request’ini Entity’e çevir.</li></ul><pre>interface IMapper&lt;Response, Request, Entity&gt; {<br>    fun entityToResponse(entity: Entity) : Response<br>    fun responseToEntity(response: Response) : Entity<br>    fun requestToEntity(request: Request) : Entity<br>    fun entityListToResponseList(entity: List&lt;Entity&gt;) : List&lt;Response&gt;<br>    fun updateRequestToEntity(request: Request, entity: Entity)<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*LtNEKBr7hu_233U33HROEw.png" /></figure><p>Soyut sınıfımızı tanımladıktan sonra içini dolduracağımız bir ProductMapper classı oluşturalım ve interface classımızı implemente edelim.</p><p>Burada implemente ettikten sonra yukarda soyut bir şekilde gösterdiğimiz Response, Request ve Entity objelerini bu sefer doldurduk. Sonrasında ise DTO’larımızdaki objelere göre Entity-DTO veri transferini sağlamış olduk.<br>Update request için bir dönüş tipi belirtmedik. Orada yaptığımız işlem tam olarak şu aslında o metotta şunu diyoruz. Abi şimdi Entity’mde şu obje var çok güzel ama ben bunu güncellerken artık Entity’deki obje , benim Update Request’i atarken gönderdiğim parametreyle değişmeli.</p><pre>@Component<br>class ProductMapper : IMapper&lt;ProductResponse, ProductRequest, Product&gt; {<br>    override fun entityToResponse(entity: Product): ProductResponse {<br>        return ProductResponse(<br>            productName = entity.productName,<br>            productType = entity.productType,<br>            price = entity.price<br>        )<br>    }<br><br>    override fun responseToEntity(response: ProductResponse): Product {<br>        return Product(<br>            productName = response.productName,<br>            productType = response.productType,<br>            price = response.price<br>        )<br>    }<br><br>    override fun requestToEntity(request: ProductRequest): Product {<br>        return Product(<br>            productName = request.productName,<br>            price = request.price,<br>            productType = request.productType,<br>            secretInfo = request.secretInfo<br>        )<br>    }<br><br>    override fun entityListToResponseList(entity: List&lt;Product&gt;): List&lt;ProductResponse&gt; {<br>        return entity.map {<br>            entityToResponse(it)<br>        }<br>    }<br><br>    override fun updateRequestToEntity(request: ProductRequest, entity: Product) {<br>        entity.productName = request.productName<br>        entity.productType = request.productType<br>        entity.price = request.price<br>        entity.secretInfo = request.secretInfo<br>    }<br>}</pre><h3>6) JPA Katmanımızı Oluşturalım</h3><p>Öncelikle jpa paketimizin altında bir adet IProductRepository adında bir interface oluşturalım ve bu interface ise CrudRepository’den beslensin. Burada Java’daki gibi beslendiğimiz Repository’e Entity’mizin ismini ve Entity’mizdeki foreign key olarak tanımladığımız objemizin veri tipini veriyoruz.</p><pre>@Repository<br>interface IProductRepository : CrudRepository&lt;Product, Long&gt; </pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qeRqqp-bEWMZkf-qrExeQw.png" /></figure><p>Burada da yine aynı şekilde farklı JPA sorguları atabilmekteyiz. Ama şu an oluşturduğumuz API temel CRUD bir REST Servisi olduğu için CrudRepository’nin beslediği fonksiyonlar bizim için yeterli olmaktadır.</p><p>Ama örnek olarak şöyle bir ORM sorgusu gösterebilirim. Böyle bir sorgu yazıp o ürün ismini içeren tüm ürünleri ID’ye göre sıralayabiliriz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*PXoA5h-9TwThCNKuyjkEKA.png" /></figure><h3>7) Servis Katmanımızı Oluşturalım</h3><p>İlk önce IProductService adında bir interface tanımlayıp , implementasyonlarını yapacağımız metotları soyut bir şekilde oluşturalım.</p><p>Bizim oluşturmak istediğimiz temel CRUD API’sinde şu şekilde işlemler yapabilmeliyiz.</p><ul><li>Request ile yeni bir ürün oluşturmalıyız.</li><li>Bütün ürünlerin bize liste olarak dönebilmesini sağlamalıyız.</li><li>Özel bir parametresiyle istek atıp tek bir ürünü görebilmeliyiz. Burada id ile bulabileceğimiz bir metot tanımladık ama unique bir veri tipiyle de istek atabiliriz. Eğer tek bir datayı özel olarak çağırmak istiyorsak tabii ki.</li><li>Var olan bir varlık nesnesini attığımız Update Request’i ile güncelleyebilmeliyiz.</li><li>Son olarak da var olan bir varlık nesnesini silebilmeliyiz.</li></ul><pre>interface IProductService {<br>    fun createProduct(request : ProductRequest) : ProductResponse<br>    fun getAllProducts() : List&lt;ProductResponse&gt;<br>    fun receiveProductById(productId : Long) : ProductResponse<br>    fun updateProductById(productId: Long, request: ProductRequest) : ProductResponse<br>    fun deleteProductById(productId: Long)<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*QZRRhrtVowqeKJRLDS84mg.png" /></figure><p>Soyut sınıfımızı oluşturduktan sonra da implementasyonlar için bir adet Implementation sınfına ihtiyacımız var. ProductServiceImpl adında normal bir Kotlin.class oluşturuyoruz.</p><p>Yazının en başında da bahsettiğim gibi Global Exception’lar için ayrı bir yazı daha yazacağım bu proje üzerinden , o yüzden şimdilik sadece aksi durumda RuntimeException fırlatalım. Daha sonrasında ise bunları nasıl spesifik bir şekilde handle edeceğimize bakarız.</p><pre>@Service<br>class ProductServiceImpl(<br>    private val productRepository: IProductRepository,<br>    private val mapper : ProductMapper) : IProductService {<br><br>    private val PRODUCT_NOT_FOUND_MESSAGE : String = &quot;Product Not Found with this Product ID !&quot;<br><br>    override fun createProduct(request: ProductRequest): ProductResponse {<br>        val productRequest = mapper.requestToEntity(request)<br>        productRepository.save(productRequest)<br>        return mapper.entityToResponse(productRequest)<br>    }<br><br>    override fun getAllProducts(): List&lt;ProductResponse&gt; {<br>        val allProducts = productRepository.findAll().toList()<br>        return mapper.entityListToResponseList(allProducts)<br>    }<br><br>    override fun receiveProductById(productId: Long): ProductResponse {<br>        val validProduct = findById(productId)<br>        val isProductPresent = validProduct.isPresent<br><br>        if (isProductPresent) {<br>            return mapper.entityToResponse(validProduct.get())<br>        } else throw RuntimeException(PRODUCT_NOT_FOUND_MESSAGE)<br><br>    }<br><br>    override fun updateProductById(productId: Long, request: ProductRequest): ProductResponse {<br>        val validProduct = findById(productId).orElseThrow{throw RuntimeException(PRODUCT_NOT_FOUND_MESSAGE)}<br><br>        try {<br>            mapper.updateRequestToEntity(request, validProduct)<br>            productRepository.save(validProduct)<br>            return mapper.entityToResponse(validProduct)<br>        } catch (exception : Exception) {<br>            throw RuntimeException(&quot;Product Could Not Be Updated !&quot;)<br>        }<br>    }<br><br>    override fun deleteProductById(productId: Long) {<br>        val validProduct = findById(productId).orElseThrow{throw RuntimeException(PRODUCT_NOT_FOUND_MESSAGE)}<br><br>        try {<br>            productRepository.delete(validProduct)<br>        } catch (exception : Exception) {<br>            throw RuntimeException(&quot;Product Could Not Be Deleted !&quot;)<br>        }<br>    }<br><br>    private fun findById(productId: Long) : Optional&lt;Product&gt; {<br>        return productRepository.findById(productId)<br>    }<br>}</pre><p>Burada productRepository ve mapper’ımızı Constructor Injection yöntemiyle private val tanımlaması yaptık. Java’da kullandığımız RequiredArgsConstructor ve private final keywordleriyle aynı mantık aslında.</p><p>IProductService adlı soyut sınıfımızı bu implementasyon sınıfımızı beslemesi için sınıfımıza implemente işlemi gerçekleştirdik. Daha sonrasında ise bir adet private fonksiyon var en aşağıda ve dönüş tipi de Optional&lt;Product&gt;. Bu fonksiyonu yukarda kullanmak için oluşturdum.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/1*oVyuTOPdySCxWVRR3K_eRA.png" /></figure><h3>8) Sunum Katmanımızı Oluşturalım</h3><p>Geldik son aşamamız olan sunum Presentation katmanına yani değerli Controller sınıfımıza. İlk önce Constructor Injection ile Servisimizi çağıralım. Yine Java’daki aynı mantık ile serviste yaptığımız implementasyonları burada çağırıp API’mizi sergiliyoruz.</p><ul><li><strong>RestController</strong> anotasyonumuzu kullanarak Presentation katmanı olduğunu işaretliyoruz.</li><li><strong>RequestMapping</strong> anotasyonunda ise servisimizin Base Path tanımını oluşturuyoruz.</li><li><strong>RequestBody</strong> anotasyonuyla verdiğimiz veri objesinin Request’imiz olduğunu söylüyoruz.</li><li><strong>Path Variable</strong> kullanarak da gönderdiğimiz parametreyi base path’imizin tamamlayıcısı olarak kullandığımızı söylüyoruz. Yani ben GET atarken Base Path’imin ardından ‘/1&#39; Path’i ile istek atarsam 1. ID’ye sahip olan veriye ulaşıyorum.</li></ul><pre>@RestController<br>@RequestMapping(&quot;/api/v1/products&quot;)<br>class ProductController(private val productService : IProductService) {<br><br>    @PostMapping<br>    fun createProduct(@RequestBody req : ProductRequest) : ResponseEntity&lt;ProductResponse&gt; {<br>        val savedProduct = productService.createProduct(req)<br>        return ResponseEntity(savedProduct, HttpStatus.CREATED)<br>    }<br><br>    @GetMapping<br>    fun receiveAllProducts() : ResponseEntity&lt;List&lt;ProductResponse&gt;&gt; {<br>        val allProducts = productService.getAllProducts()<br>        return ResponseEntity.ok(allProducts)<br>    }<br><br>    @GetMapping(&quot;/{productId}&quot;)<br>    fun receiveProduct(@PathVariable productId: Long) : ResponseEntity&lt;ProductResponse&gt;  {<br>        val validProduct = productService.receiveProductById(productId)<br>        return ResponseEntity.ok(validProduct)<br>    }<br><br>    @PutMapping(&quot;/{productId}&quot;)<br>    fun updateProduct(@PathVariable productId : Long, @RequestBody req : ProductRequest) : ResponseEntity&lt;ProductResponse&gt; {<br>        val updatedProduct = productService.updateProductById(productId, req)<br>        return ResponseEntity.ok(updatedProduct)<br>    }<br><br>    @DeleteMapping(&quot;/{productId}&quot;)<br>    fun deleteProduct(@PathVariable productId: Long) : ResponseEntity&lt;ProductResponse&gt; {<br>        productService.deleteProductById(productId)<br>        return ResponseEntity(HttpStatus.NO_CONTENT)<br>    }<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*k0K2Pl-uo06WA5PFTOy1BA.png" /></figure><h3>9) Servisimizi Test Edelim</h3><p>İlk önce DB’mize bakalım ve herhangi bir data olmadığını kontrol edelim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*7ghVH7H992axl2m-1h9WHg.png" /></figure><p>DB’mizde herhangi bir data olmadığını görüyoruz. O zaman kontrollerimize başlayabiliriz.</p><p>En başta implemente ettiğimiz Swagger’a localimizden ulaşalım.</p><p><a href="http://localhost:4000/swagger-ui/index.html#/">http://localhost:4000/swagger-ui/index.html#/</a></p><p>Bu adreste ise API Dokümantasyonumuzun arayüzü bizi karşılıyor.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*KZgwrelhHIItxXJi0XKrBA.png" /></figure><p>1) Önce POST isteği atalım ve DB’mize 2 adet ürün ekleyelim.</p><pre>{<br>  &quot;productName&quot;: &quot;Macbook Pro M2 Chip&quot;,<br>  &quot;productType&quot;: &quot;Laptop&quot;,<br>  &quot;price&quot;: 50000,<br>  &quot;secretInfo&quot;: &quot;This is so secret !&quot;<br>}</pre><pre>{<br>  &quot;productName&quot;: &quot;Logitech G305&quot;,<br>  &quot;productType&quot;: &quot;Mouse&quot;,<br>  &quot;price&quot;: 1500,<br>  &quot;secretInfo&quot;: &quot;This is so secret 2!&quot;<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*1cPLvESApCG9bfG0rblSsw.png" /></figure><p>Sonrasında ise DB’mizi kontrol edelim. Başarıyla kaydedildiğini görüyoruz.</p><p>Buraya kadar her şey çok profesyonel , çok rahat :D</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Qh2zJ4yt0IA5fwHgNUnfLw.png" /></figure><p>2) Get isteklerimizi test edelim.</p><p>İlk önce tüm ürünleri getiren Endpoint’imize istek atalım.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YKdOF4tbO48fGFrbCbeCeg.png" /></figure><p>DTO class’ında bahsettiğim gibi secretInfo verisini response’ta görmüyoruz. Ama eğer direkt Entity’i dönüş tipi verseydik görebilirdik.</p><p>Tek bir ürün getiren Endpoint’imize istek atalım.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_88uEsTBKsCwRVBVoCC72w.png" /></figure><p>3) Update isteğimizi ID’si 1 olan ürünümüzün ismini ve fiyatını değiştirerek test edelim.</p><pre>{<br>  &quot;productName&quot;: &quot;Macbook Pro 32 GB M2 Chip&quot;,<br>  &quot;productType&quot;: &quot;Laptop&quot;,<br>  &quot;price&quot;: 80000,<br>  &quot;secretInfo&quot;: &quot;Updated Secret Info&quot;<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*emxGxzbgEEt81_kvDT8nFQ.png" /></figure><p>Hemen ardından DB’mizi kontrol edip gerçekten güncellendiğini görelim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ULJmNfdlmyrTSZKeWA2jNg.png" /></figure><p>4) Son olarak da 2 numaralı ID’ye sahip olan ürünümüzü silelim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*8gy2TgP_GbBSe2RBj-FCqg.png" /></figure><p>Sildikten sonra DB’mizi kontrol edelim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*GKpu6-egVLbobfVZj6sMWQ.png" /></figure><p>Başarılı bir şekilde ürünümüzü silebiliyoruz. Son olarak Exception kısmına çok deep girmeyeceğim bu yazıda ama onu da test edelim. Silinmiş ürüne bir Get isteği atalım. Şu anlık Hatayı herhangi bir Error Response ve Global Error Handling eklemediğimiz için konsoldan okuyabiliriz. Bir sonraki yazıda ondan bahsedeceğim. Onları da ekledikten sonra Response’ta artık hata mesajlarımızı görüntüleyebileceğiz. Ama şu anlık konsoldan hatamızı görelim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*PcvlmqC-LtMqN1Cgq2W4vA.png" /></figure><p>Buraya kadar okuduysanız çok teşekkür ederim. Başka yazılarda görüşmek üzere kendinize iyi bakın. Görüşmek üzere 👋👋</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=23c40defd095" width="1" height="1" alt=""><hr><p><a href="https://medium.com/enuygun-wingie-tech/kotlin-ve-spring-boot-3-kullan%C4%B1larak-rest-api-nas%C4%B1l-geli%C5%9Ftirilir-23c40defd095">Kotlin ve Spring Boot 3 Kullanılarak REST API Nasıl Geliştirilir</a> was originally published in <a href="https://medium.com/enuygun-wingie-tech">Wingie Enuygun Tech</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Typescript ve Playwright POM Projesinin Sıfırdan Jenkins’e Entegrasyonu]]></title>
            <link>https://medium.com/@mertcanpoyraz/typescript-ve-playwright-pom-projesinin-s%C4%B1f%C4%B1rdan-jenkinse-entegrasyonu-5a9a5f000147?source=rss-d9257e6a6fa8------2</link>
            <guid isPermaLink="false">https://medium.com/p/5a9a5f000147</guid>
            <dc:creator><![CDATA[Mertcan Poyraz]]></dc:creator>
            <pubDate>Thu, 06 Apr 2023 23:17:05 GMT</pubDate>
            <atom:updated>2023-04-09T01:56:09.872Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/646/0*b2t4-vgWRTncKZ8D.png" /></figure><p>Herkese selamlar , bu yazımda POM Design Pattern kullanarak Typescript dilinde 0&#39;dan bir Playwright projesi oluşturup , bu projeyi Jenkins’e nasıl entegre edeceğimizden bahsedeceğim.</p><p>Hemen başlayalım o zaman !</p><h3>1) Visual Studio Code’a Playwright Kurulumu ve Konfigürasyonları</h3><p>Visual Studio Code’u açtık ve boş bir dosya oluşturduk. Daha sonrasında ise VSC içerisindeki terminali açıyoruz ve aşağıda verdiğim terminal komutunu giriyoruz. Sonrasında ise terminal bize projemizi Javascript’le mi yoksa Typescript’le mi yapmak istediğimizi soruyor ve biz buradan Typescrip’ti seçiyoruz.</p><pre>npm init playwright@latest</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*6WAFzzd-2znKDLXXiUmeUA.png" /></figure><p>Bu işlemden sonra ise Playwright kurulumumuz tamamlanıyor. Şimdi gelelim yapmamız gereken daha doğrusu bizim yazacağımız testi cover edecek olan konfigürasyon ayarlarına. Projemizin içinde <strong>playwright.config.ts</strong> adlı bir konfigürasyon dosyası oluştu bu dosyamızın içindeki her şeyi tamamen silip aşağıda vereceğim konfigürasyon ayarlarını girmemiz gerekiyor.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/404/1*vQGoP4XdTFvILXiqjmFbjw.png" /></figure><pre>import { defineConfig, devices } from &#39;@playwright/test&#39;;<br><br>export default defineConfig({<br>  testDir: &#39;./tests&#39;,<br>  <br>  timeout: 30 * 1000,<br><br>  reporter: &#39;html&#39;,<br><br>  use: {<br>    baseURL: &#39;https://www.enuygun.com/&#39;,<br>    screenshot: &#39;on&#39;,<br>    trace: &#39;on&#39;,<br>  },<br><br>  projects: [<br>    {<br>      name: &#39;chromium&#39;,<br>      use: { ...devices[&#39;Desktop Chrome&#39;] },<br>    },<br>  ]<br>});</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*MzZoK5ZDW1zaevAyoR-s5A.png" /></figure><p>Bu konfigürasyondan kısaca bahsetmem gerekirse, buradaki ;</p><ul><li><strong>testDir:</strong> Koşmak istediğim testlerimin projemin içerisindeki hangi dizinde olduğunu tanımlamak için.</li><li><strong>timeout:</strong> Testime verdiğim, maksimum patlamama zaman dilimi oluyor aslında ms cinsinden olduğu için 30000 yazdım yani 30 saniye olarak tanımladım aslında.</li><li><strong>baseURL:</strong> Benim ana url’im ben testimi Enuygun’daki farklı domainlerde de yapmak istediğimde sürekli baseURL/domain yazmaktan kurtulacağım.<br>Direkt domain sayfama yönlendireceğim test caselerimi.</li><li><strong>screenshot ve trace:</strong> Aslında ikisi benzer özellikler sunuyor. Testim bittikten sonra screenshot’u aktif edersem raporumda bu screenshot’u görebiliyorum. Trace ise kaydedici oluyor ve raporumda testimi izleyebiliyorum.</li><li><strong>projects:</strong> Burada testimi koşmak istediğim browser’ı ayarlıyorum.</li></ul><h3>2) Hadi Page’lerimizi Oluşturalım</h3><p>Eveet ortam kurulumu tamam ve konfigürasyonlar da yapıldı. Şimdi gelelim testimde bulunan sayfalara. Benim koşmak istediğim caseleri sıralamam gerekirse şu şekilde sıralayabilirim;</p><ul><li>Geçerli email adresi ve geçerli bir şifre kullanarak kayıt olma.</li><li>Geçersiz email adresi ve geçerli bir şifre kullanarak kayıt olma.</li><li>Geçerli email adresi ve geçersiz bir şifre kullanarak kayıt olma.</li><li>Geçersiz email ve geçersiz bir şifre kullanarak kayıt olma.</li></ul><p>Şimdii bana ne lazım bu caselere göre , bir adet HomePage classı ama ben Uçak Domain’inin anasayfasından yapacağım için bu işlemi classımın ismini FlightHomePage olarak setleyeceğim ve bir adet de RegisterPage classı. Ama bu classları oluşturmadan öncesinde Reusability metotlarımı bir üst katmanda tanımlamak istiyorum. Bunun içinde kendime bir adet BasePage oluşturuyorum. Ben sadece bu projede kullanacağım metotları oluşturdum. İsterseniz bunu daha fazla da çeşitlendirebilirsiniz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/470/1*Ktufrbv0SXlFBzp-_-vzVA.png" /></figure><pre>import { expect, Locator } from &quot;@playwright/test&quot;;<br><br>export class BasePage {<br>    <br>    async click(locator: Locator) {<br>        await locator.click();<br>    }<br><br>    async sendKeys(locator: Locator, key: string) {<br>        await locator.fill(key);<br>    }<br><br>    async validateCheckBox(locator: Locator) {<br>        await expect(locator).toBeChecked();<br>    }<br><br>    async validateText(locator: Locator, validationText: string) {<br>       await expect(locator).toHaveText(validationText);<br>    }<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*haKGvm5dE1lLy6dz5O_Rqw.png" /></figure><p>Kısaca metotlarımdan bahsetmem gerekirse</p><ul><li><strong>click</strong> metotu yazdım ve bu metota parametrik olarak bir locator vereceğimi belirttim.</li><li><strong>sendKeys</strong> metotu yazdım ve bu metota parametrik olarak bir locator ve input alanlarımı doldurması için bir string veri tipinde key tanımladım.</li><li><strong>validateCheckBox</strong> metotu yazdım ve bu metota parametrik olarak bir locator verdim. Bu metot ben checkbox’a tıkladıktan sonra checklenmiş mi onun kontrolünü yapıyor.</li><li><strong>validateText</strong> metotu yazdım ve bu metota da parametrik olarak bir locator tanımladım bu parametrik locator bana actual text’i bulacak ve parametrik olarak bir de string veri tipinde validationText parametresi oluşturdum. Bunun sebebi ise Expected mesajımı , locatordan aldığım Actual mesajla karşılaştırmak.</li></ul><p>Şimdi tekrar kullanacağım metotlarımı oluşturdum. Sıra FlightHomePage’i oluşturmakta.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*fUYoiVp-W2SlAFkb9REHlg.png" /><figcaption>Flight Domain’ine ait Ana Sayfa</figcaption></figure><p>Ana sayfada yapacağım tek bir işlem var bu da Üye Ol butonuna tıklamak. Kodsal kısma dönecek olursak.</p><pre>import { Locator, Page } from &quot;@playwright/test&quot;;<br>import { BasePage } from &#39;./BasePage&#39;;<br><br>export class FlightHomePage extends BasePage{<br><br>    private readonly page: Page;<br>    private readonly signUpButton: Locator;<br><br>    private SIGN_UP_BUTTON: string = &quot;#ctx-RegisterBtn&quot;;<br><br>        constructor(page: Page){<br>            super();<br>            this.page = page;<br>            this.signUpButton = page.locator(this.SIGN_UP_BUTTON);<br>        }<br>        <br>         async navigateToSignUpPage(){<br>            await this.click(this.signUpButton);<br>            console.log(&quot;Clicked the Sign Up Button in Flight Home Page&quot;);<br>        }<br>}</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Gy5-qkAfgRfJDb7jIrY5sw.png" /></figure><p>FlightHomePage classımı BasePage’e bağladım bunun sebebi ise az önce BasePage classımda oluşturduğum reusability metotları kullanmak.</p><p>Şimdi benim metotlarımda async ve await var bunun sebebi ise Playwright’ın senkron olmayan bir yapıda çalışması. Ben metotumu <strong>async</strong> tanımlıyorum ve <strong>await’te</strong> diyorum ki abi sen bitmeden diğer adıma geçilmesin. Yani bir işlem bitmeden diğer işleme geçilmesini önlüyorum.</p><p>Burada locator’umu private olarak tanımladım bunun sebebi ise bu locator’u ben sadece bu classta kullanacağım, yani bu locator bana sadece bu class içerisinde lazım ve başka yerde kullanmayacağım. O yüzden classı çağırdığım zaman benim bu variable’ı başka bir yerde kullanmam mantıksız olur ve görmemeliyim.</p><p>Bir sonraki işlemimize geçelim. Üye Ol butonuna tıkladık ve RegisterPage sayfasına gittik.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/855/1*1p-0XkIAbyOrUVaylfqQAA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*1yusf7BEFvSi7AajNqfvdg.png" /></figure><p>Şimdii burada ne yaptık, ilk önce constructor’da okuyacağım objeleri oluşturdum ve onları readonyle ile işaretleyip constructorda bu objelerimi hemen aşağısında aldığım locatorlar ile instance etmiş oldum.</p><p>En aşağıda ise benim Expected Mesajlarım gözüküyor.</p><p>Metotlarıma geçmeden önce burada ben metotlarımda email, password ve isAccept’i sürekli gönderiyorum. O yüzden hepsinde kullanmak için bu classa özel bir metot oluşturdum.</p><pre>private async fillInputFields(email: string, password: string, isAccept: boolean) {<br>                await this.sendKeys(this.emailInput, email);<br>                await this.sendKeys(this.passwordInput, password);<br><br>                if(isAccept) {<br>                    await this.click(this.acceptEmailCheckBox);<br>                    await this.validateCheckBox(this.acceptEmailCheckBox);<br>                }<br>                <br>                await this.click(this.signUpButton);<br>            } </pre><p>Bu metotumu ise daha sonrasında testimde kullanacağım metotlarıma dağıttım. Kısaca ne yaptığını anlatmam gerekirse de BasePage’mden sendKeys metotlarımla emailInput ve passwordInput alanlarımı parametrik olarak dolduracağımı söylüyorum. Bir adet conditional var , bu conditional’ın içerisinde ise eğer isAccept parametresini ilerde true olarak gönderirsem. Accept Email Check Box’unu işaretleyecek ve işaretlenmiş mi kontrolü yapacak. En sonda ise üye ol butonuna tıklayacak.</p><p>Bunu metotlarımda nasıl kullandığıma gelecek olursak da;</p><pre>            async fillValidEmailAndValidPassword(email: string, password: string, isAccept: boolean) {<br>                await this.fillInputFields(email, password, isAccept);<br>            }<br><br>            async fillInvalidEmailAndValidPassword(email: string, password: string, isAccept: boolean) {<br>                await this.fillInputFields(email, password, isAccept);<br>                await this.validateText(this.invalidEmailMessage, this.EMAIL_ERROR_MESSAGE);<br>            }<br><br>            async fillValidEmailAndInvalidPassword(email: string, password: string, isAccept: boolean) {<br>                await this.fillInputFields(email, password, isAccept);<br>                await this.validateText(this.invalidPasswordMessage, this.PASSWORD_ERROR_MESSAGE);<br>            }<br><br>            async fillInvalidEmailAndInvalidPassword(email: string, password: string, isAccept: boolean) {<br>                await this.fillInputFields(email, password, isAccept);<br>                await this.validateText(this.invalidEmailMessage, this.EMAIL_ERROR_MESSAGE);<br>                await this.validateText(this.invalidPasswordMessage, this.PASSWORD_ERROR_MESSAGE);<br>            }</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*GSbgtgZCqcD_FIJzyD5d0g.png" /></figure><p>Şimdi kullanacağım Pagelerimi oluşturdum. Artık bunları test classımda kullanabilirim.</p><p>tests dosyasının altında SignUpTests adında bir Typescript dosyası oluşturuyorum.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/410/1*mWf6uGXfX4abhq5T2k4hIg.png" /></figure><p>Daha sonrasında ise bir adet PageManager oluşturuyorum bunun sebebine birazdan bahsedeceğim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*qhDuRG9EdksFHpyUAe0t0w.png" /></figure><pre>import { Page } from &quot;@playwright/test&quot;;<br>import { FlightHomePage } from &quot;../pages/FlightHomePage&quot;;<br>import { RegisterPage } from &quot;../pages/RegisterPage&quot;;<br><br>export class PageManager {<br> <br>    private readonly page: Page;<br>    private readonly homePage: FlightHomePage;<br>    private readonly signUpPage: RegisterPage;<br>    <br>    constructor(page: Page) {<br>        this.page = page;<br>        this.homePage = new FlightHomePage(page);<br>        this.signUpPage = new RegisterPage(page);<br>    }<br><br>    public getHomePage() {<br>        return this.homePage;<br>    }<br><br>    public getSignUpPage() {<br>        return this.signUpPage;<br>    }<br>}</pre><p>Burada yaptığım işlem aslında ben classlarımı çağırdığım zaman her yerde newlemek yerine bu classta newleyeyim ve newlediğim metotu çağırıp instance edeyim.</p><p>Evet şimdi Test classımı yazmadan önce yapmam gereken 2 tane işlemim daha var.Bunlardan ilki , hatırlarsanız ben projeyi ilk kurduğumda baseURL tanımlamıştım. Bu baseURL’im benim normal anasayfam oluyor aslında. Ama ben her domain için test yazabileceğimi yani her domaine gidebileceğimi ön görerek bir enum yapısı tanımladım. Bu enum yapıma da Domains ismini verdim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*6pAen5ZrZ2txbYRJLvdKFw.png" /></figure><pre>export enum Domains {<br>    FLIGHT_DOMAIN = &quot;/ucak-bileti/&quot;,<br>    BUS_DOMAIN = &quot;/otobus-bileti/&quot;,<br>    HOTEL_DOMAIN = &quot;/otel/&quot;,<br>    CAR_RENTAL_DOMAIN = &quot;/arac-kiralama/&quot;<br>}</pre><p>İkincisi ise ben testimde de hatırlarsanız parametrik olarak email, password ve isAccept gönderecektim. Bu datalarımı test classında statik olarak tanımlamamam gerekiyor. Bu dataları başka bir domainde de üye olma test casemi koşarsam kullanmam gerekecek ve her test classımda aynı dataları sürekli tanımlamak yerine bir generator classında oluşturup diğer testlerimde de datalarımı buradan çekeyim. Bunun için bir adet DataGenerator classı oluşturdum.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Jrb2KqI8OSF580T3AXhb0A.png" /></figure><pre>import { faker } from &#39;@faker-js/faker&#39;;<br><br>export class DataGenerator {<br>    public static EMAIL: string = faker.internet.email();<br>    public static PASSWORD: string = faker.internet.password();<br>    public static IS_ACCEPT: boolean = faker.datatype.boolean();<br>    public static INVALID_EMAIL: string = faker.internet.userName();<br>    public static INVALID_PASSWORD: string = &quot;123&quot;;<br>}</pre><p>Faker kütüphanesi yardımıyla her test casemde farklı dummy data kullanabileceğim artık.</p><h3>3) Test Classı Oluşturmak ve Testleri Yazmak</h3><p>Evett artık projemizin son stepine geldik yani testleri yazma aşamasına.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lhhsd_f7375wKriuCBwsrA.png" /></figure><pre>import test, { Page } from &quot;@playwright/test&quot;;<br>import { DataGenerator } from &quot;../data/DataGenerator&quot;;<br>import { FlightHomePage } from &quot;../pages/FlightHomePage&quot;;<br>import { RegisterPage } from &quot;../pages/RegisterPage&quot;;<br>import { PageManager } from &quot;../pagemanager/PageManager&quot;;<br>import { Domains } from &quot;../data/Domains&quot;;<br><br>let homePage: FlightHomePage;<br>let signUpPage: RegisterPage;<br>    <br>test.describe(&quot;Sign Up Test Cases&quot;, () =&gt; {<br>    test.beforeEach(async ({page}) =&gt; {<br>        const pageManager = new PageManager(page);<br>        homePage = pageManager.getHomePage();<br>        signUpPage = pageManager.getSignUpPage();<br><br>        await page.goto(Domains.FLIGHT_DOMAIN);<br>    })<br><br>    test(&quot;Successfully Sign Up Test&quot;, async () =&gt; {<br>        await homePage.navigateToSignUpPage();<br>        await signUpPage.fillValidEmailAndValidPassword(DataGenerator.EMAIL, DataGenerator.PASSWORD, DataGenerator.IS_ACCEPT);<br>    })<br><br>    test(&quot;Failure Sign Up Test With Invalid Email&quot;, async () =&gt; {<br>        await homePage.navigateToSignUpPage();<br>        await signUpPage.fillInvalidEmailAndValidPassword(DataGenerator.INVALID_EMAIL, DataGenerator.PASSWORD, DataGenerator.IS_ACCEPT);<br>    })<br><br>    test(&quot;Failure Sign Up Test With Invalid Password&quot;, async () =&gt; {<br>        await homePage.navigateToSignUpPage();<br>        await signUpPage.fillValidEmailAndInvalidPassword(DataGenerator.EMAIL, DataGenerator.INVALID_PASSWORD, DataGenerator.IS_ACCEPT);<br>    })<br><br>    test(&quot;Failure Sign Up Test With Invalid Email And Invalid Password&quot;, async () =&gt; {<br>        await homePage.navigateToSignUpPage();<br>        await signUpPage.fillInvalidEmailAndInvalidPassword(DataGenerator.INVALID_EMAIL, DataGenerator.INVALID_PASSWORD, DataGenerator.IS_ACCEPT);<br>    })<br>})<br><br></pre><p>Test describe benim test senaryomun başlığı oluyor ve ben senaryomun altında farklı test caselerimi giriyorum. Yani benim başlığım Kayıt Olma Testleri olsun. Altına da başarılı başarısız caselerimi oluşturayım.</p><p>beforeEach metotunda ise PageManager’ımı çağırdım ve PageManager yardımıyla bu testimde kullanacağım classlarımı instance ettim.</p><p>Daha sonrasında Uçak Domain’ine gittim ve gerisi de Page’lerimde yazdığım metotlarımı senaryolarımda kullanmak oldu.</p><p>Testlerimizi çalıştırmak için ise terminali açıyoruz. Aşağıdaki terminal komutunu girerek testleri çalıştırıyoruz.</p><pre>npx playwright test</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*_sss4e8LP8EfzCfo19ShEg.png" /></figure><p>Test bittikten sonra ise aşağıdaki terminal komutumuzu girerek raporumuzu açıyoruz.</p><pre>npx playwright show-report</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*2ds6Bxwx2YrU0VeLq0W78Q.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*KsAe2KblwJNkadB2DkFhaQ.png" /></figure><h3>4) Jenkins Entegrasyonu</h3><p>Projemizdeki son adıma geçiyoruz. Jenkins entegrasyonu yaparak, testi localimizden istediğimiz zaman tetikleyerek rapor çıktısını görebileceğiz.</p><p>Bunun için ilk önce projemde npm komutları oluşturmam gerekiyor bunu da şu şekilde yapıyoruz. Projemizi ilk kurduğumuzda otomatik olarak gelen <strong>package.json</strong> adlı dosyamızın içine gidelim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/962/1*ck6ImMfhI7ZJigE-TXyzFA.png" /></figure><p>Json dosyamızın default hali bu şekildedir. Ve şu eklemeleri yapıp npm komutları oluşturuyorum.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*TvNG_O1fiE3yEgdlxuWa9g.png" /></figure><pre>    &quot;signUpTests&quot;: &quot;npx playwright test /tests/SignUpTests.spec.ts&quot;,<br>    &quot;openReport&quot;: &quot;npx playwright show-report&quot;</pre><p>Sonrasında ise localimdeki Jenkins’e gidiyorum.</p><p>Yeni Öğe diyorum.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/912/1*XEVIwCcmceEkfmQ3FSo47A.png" /></figure><p>Öğeme isim veriyorum ve Serbest-Stil’i seçiyorum.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/912/1*HXIm_l0qawPdbcbcT8LPWg.png" /></figure><p>Genel ayarlardan özel çalışma alanını kullan diyerek projemin pathini veriyorum.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Cnh03VX5H0LqJ1ilTpkpfg.png" /></figure><p>En sonunda ise az önce json altında oluşturduğum npm komutlarını Build Aşamalarıma giriyorum. npm command yapılandırma adımları ekliyorum ve kaydet diyorum.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*e54ZIatV8Zx_OnD31SfpTQ.png" /></figure><p>Daha sonrasında ise şimdi yapılandır diyerek build oluşturuyorum.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/825/1*kmrGJRpuplxm1owhymnGzQ.png" /></figure><p>#1 de Buildimin başladığını görüyorum ve üzerine tıklıyorum. Ve Console Output’tan konsol çıktılarını görüyorum.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*I-9QXeT32iNTg1vcFQg-Sw.png" /></figure><p>Testimin tetiklendiğini görüyorum ve en son aşamada ise otomatik olarak html formatlı raporumun localhostumda 9323 portuma geldiğini görüyorum.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*feAirGq5-TzH314SEef-Rw.png" /></figure><p>Eveet 0&#39;dan Typescript kullanarak bir adet Playwright projesi oluşturduk ve daha sonrasında bunu Jenkins’te tetikledik.</p><p>Buraya kadar okuduysanız çok teşekkür ederim. Başka yazılarda görüşmek üzere kendinize iyi bakın. Görüşmek üzere 👋👋</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=5a9a5f000147" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Cypress ve Allure Report Entegrasyonu]]></title>
            <link>https://medium.com/@mertcanpoyraz/cypress-ve-allure-report-entegrasyonu-932234e05aad?source=rss-d9257e6a6fa8------2</link>
            <guid isPermaLink="false">https://medium.com/p/932234e05aad</guid>
            <dc:creator><![CDATA[Mertcan Poyraz]]></dc:creator>
            <pubDate>Fri, 17 Mar 2023 07:21:31 GMT</pubDate>
            <atom:updated>2023-03-17T07:27:51.993Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*M8Ca8SeW4GJ_vqnt.png" /></figure><p>Herkese selamlar , bu yazımda Cypress otomasyon caselerimize Allure Report’u nasıl entegre edeceğimizden bahsedeceğim. Keyifli okumalar dilerim.</p><h4>Allure Report Nedir ?</h4><p>Allure Report otomasyon caselerimizi koştuktan sonra bu caselerimizin sonucunda bize her aşama için Log’larımızın çıktısını göstermeye yarayan bir raporlama Plugin’idir.</p><h4>Cypress Projemize Allure Report Kurulumu</h4><p>Öncelikle Cypress projemizin içindeyken terminalimizi açarak şu sihirli sözcükleri terminalimize söylemeliyiz. IDE olarak Visual Studio Code kullanıyorsak VSC’nin kendi terminalini kullanabiliriz bu kurulum için.</p><pre>npm i -D @shelex/cypress-allure-plugin</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/694/1*7P6RE7S5kqN15UJiEctYMA.png" /></figure><p>Eveet kurulumumuz tamam ama hala hazır değiliz. Yapmamız gereken bir kaç konfigürasyon işlemimiz daha var. Bir sonraki adıma geçelim.</p><h4>Cypress Allure Report Konfigürasyonları</h4><p>Cypress projemizin file’ının içerisinde <strong>cypress.config.js </strong>isminde bir konfigürasyon dosyamız bulunmaktadır. Bu konfigürasyon dosyamızın içerisine de şu sihirli sözcükleri fısıldayalım. File’ımıza bu sihirli sözcükleri fısıldamadan önce konfigürasyonsuz default halini görelim.</p><pre>const { defineConfig } = require(&quot;cypress&quot;);<br>module.exports = defineConfig({<br>  e2e: {<br>    defaultCommandTimeout: 10000,<br>    pageLoadTimeout: 10000,<br>    videosFolder: &#39;cypress/videos&#39;,<br>    baseUrl: &#39;https://www.enuygun.com/&#39;,<br><br>setupNodeEvents(on, config) {<br>    },<br>    <br>    specPattern: &#39;./cypress/enuygunE2E/*.js&#39;<br>  },<br>});</pre><p>Daha sonrasında ise konfigürasyon yaptığımız haline bakalım.</p><pre>const { defineConfig } = require(&quot;cypress&quot;);<br>const allureWriter = require(&quot;@shelex/cypress-allure-plugin/writer&quot;);<br>module.exports = defineConfig({<br>  e2e: {<br>    defaultCommandTimeout: 10000,<br>    pageLoadTimeout: 10000,<br>    videosFolder: &quot;cypress/videos&quot;,<br>    baseUrl: &quot;https://www.enuygun.com/&quot;,<br>setupNodeEvents(on, config) {<br>      allureWriter(on, config);<br>      return config;<br>    },<br>    env: {<br>      allureReuseAfterSpec: true,<br>    },<br>    specPattern: &quot;./cypress/enuygunE2E/*.js&quot;,<br>  },<br>});</pre><p>Evet konfigürasyonlarımızı ekledik ama yapmamız gereken son bir adım daha var. O adıma geçecek olursak da projemizin içerisinde support adlı bir klasörümüz var. Bu support adlı klasör Cypress kurulumuyla birlikte projemize otomatik eklenmektedir. Bu support adlı dosyamızın içinde e2e.js adlı bir Javascript dosyamız bulunmaktadır.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/205/1*1hU-ltGSKhx1PsRe5tOV0Q.png" /></figure><p>e2e.js dosyamızın içine de aşağıda vereceğim konfigürasyon kodunu da girdikten sonra entegrasyonumuzu tamamlamış oluyoruz.</p><pre>require(&#39;@shelex/cypress-allure-plugin&#39;);</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/330/1*xCP5mHhQZ2LJr-Mp1Cya0A.png" /></figure><p>Şimdi Cypress projemize Allure Report’u entegre ettiğimize göre raporlamamızı kontrol edebiliriz. Raporlamada logların gözükmesi için cy.log() komutundan faydalanabiliriz. Yani aşağıdaki gibi adımlarımızda log() fonksiyonunu çağırıp doldurursak raporumuzda da o logları görebiliriz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/864/1*aGahVzGM180wUVMMEYXJ6g.png" /></figure><p>Bu bizim örnek bir casemiz olsun ve casemizi çalıştırıp rapor nasıl gözüküyor kontrol edelim. Projemizi çalıştırdık ve testimiz tamamlandı. Terminalimize allure serve yazmamız raporu görmek için yeterli olmaktadır. Bu raporumuzu manuel bir işlem yapmadan HTML olarak formatlayıp her case bittiğinde otomatik rapor çıktısı alabilecek şekilde bir konfigürasyon da yapabiliriz ama bundan başka bir yazımda bahsedeceğim. O yüzden şimdilik terminalimize allure serve yazarak raporumuzun çıktısına bakalım.</p><pre>allure serve</pre><figure><img alt="" src="https://cdn-images-1.medium.com/max/532/1*9mVVqPtiaQ_szz1_0ormfA.png" /></figure><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*vBxtdXbHtESeSLFvCMO3kw.png" /><figcaption>Projemizin Allure Report ile raporlanmış hali</figcaption></figure><p>Evet gördüğümüz gibi bu entegrasyonu yapmamız çok rahat , çok profesyonel.</p><p>Okuduğunuz için çok teşekkür ederim. Başka yazılarımızda görüşmek üzere , sağlıcakla kalın 👋</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=932234e05aad" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Spring Boot API Validasyon Mesajları]]></title>
            <link>https://medium.com/@mertcanpoyraz/spring-boot-api-validasyon-mesajlar%C4%B1-175a771f9ccc?source=rss-d9257e6a6fa8------2</link>
            <guid isPermaLink="false">https://medium.com/p/175a771f9ccc</guid>
            <dc:creator><![CDATA[Mertcan Poyraz]]></dc:creator>
            <pubDate>Thu, 02 Mar 2023 17:30:58 GMT</pubDate>
            <atom:updated>2023-03-02T17:40:59.488Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/900/1*o5FmjKTPdJTbhGE2MIjo6w.jpeg" /></figure><p>Herkese selamlar , bu yazımda Spring Boot’la yazdığımız API’ler için validasyon mesajlarını nasıl manipüle edeceğimizden bahsedeceğim.</p><h4><strong>Nedir bu Validation Mesajları ya ?</strong></h4><p>Validasyon mesajları API’mize doğru ya da yanlış request attığımızda , response’un bize döndürdüğü mesajlardır.</p><h4><strong>O zaman başlayalım</strong></h4><p>Ben bu yazı için com.enuygun projesi adında bir Sign Up API’si yazmıştım.<br>Bu Sign Up API’sinin requesti için de 4 tane obje tanımladım. Bunlar ;<br>- Username,<br>- Firstname,<br>- Email,<br>- Password<br>adlı 4 adet objeden oluşmaktadır.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*i3ihFcw7Ff8hm95pZf_KZw.png" /><figcaption>Sign Up API’si için Request Body</figcaption></figure><p>API mesajlarının validasyonu için Hibernate Validator Binary’si altındaki default ValidationMessages.properties kullanılabilir fakat ben bunları kendime göre manipüle etmek istedim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/728/1*unKdkX3ZQI8H2GhgSQ4nZg.png" /></figure><p>Bu manipülasyon için de resources altında ValidationMessages adında bir Resource Bundle oluşturdum ve burada kendi properties dosyalarımı oluşturdum.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/728/1*Ga1h9pRLxSYavnJucjBMrA.png" /></figure><p>Properties dosyalarımızı oluştururken hangi dili desteklemesini istiyorsak ,isim yazım kurallarına göre properties dosyamıza dil kodunu girmemiz gerekiyor. Bakalım properties dosyalarımızın içine neler yazmışız.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*npzI-nSFy5M85_Hmt9sXqg.png" /></figure><p>Burada \u015E gibi kodlar görüyoruz. Nedir ya bunlar ?<br>Bu kodların ismi Unicode’dur. Unicode’ları buradaki kullanma amacımız ise Türkçe karakterleri response’ta düzgün görüntüleyebilmek için.</p><p>Unicode’ları bulabilmek için ben bu siteyi kullanıyorum. Dilerseniz siz de bu siteyi kullanabilirsiniz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*JC9lmTJzbcFtcvgHE_PknA.png" /></figure><p>Bu mesajları yazdıktan sonra POJO classımızın içine gidiyoruz. Ve objelerimize bu mesajları tanımlıyoruz.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*uZUrpizHZRmc9OvXKey_dA.png" /><figcaption>Objelerimizi içeren POJO classımız</figcaption></figure><p>Şimdi bu mesajlarımızı yanlış attığımız bir requestle kontrol edelim.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*UCQFNKX5KLJZgHeHDm0Qfg.png" /></figure><p>Şimdi de doğru bir request atalım.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-vaVByRYY-rFfV4TU2YJ0g.png" /></figure><p>Ve son olarak da doğru request attıktan sonra DB’mizi kontrol ederek yazımızı da bitirmiş olalım.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*T5Kb9x_oUMegA4pB_YAeTw.png" /></figure><p>Doğru requestimizin DB’mize başarıyla kayıt olduğunu görmüş olduk.</p><p>Okuyan herkese çok teşekkür ederim. Başka yazılarda görüşmek üzere hoşçakalın 👋👋</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=175a771f9ccc" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>