<?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 Çiğdem Akcan on Medium]]></title>
        <description><![CDATA[Stories by Çiğdem Akcan on Medium]]></description>
        <link>https://medium.com/@cigdemakcan3?source=rss-20e416d2ec3d------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/1*9E61VsLTw1G-kKLMJC4nBg.jpeg</url>
            <title>Stories by Çiğdem Akcan on Medium</title>
            <link>https://medium.com/@cigdemakcan3?source=rss-20e416d2ec3d------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Tue, 17 Nov 2026 18:28:26 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@cigdemakcan3/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[Bir Exception @ControllerAdvice’ı Nasıl Buluyor? Spring MVC’nin Exception Resolver Zinciri]]></title>
            <link>https://medium.com/@cigdemakcan3/bir-exception-controlleradvice%C4%B1-nas%C4%B1l-buluyor-spring-mvc-nin-exception-resolver-zinciri-23ce7b4dbe1c?source=rss-20e416d2ec3d------2</link>
            <guid isPermaLink="false">https://medium.com/p/23ce7b4dbe1c</guid>
            <category><![CDATA[spring-boot]]></category>
            <category><![CDATA[spring-framework]]></category>
            <category><![CDATA[java]]></category>
            <category><![CDATA[exception-handling]]></category>
            <category><![CDATA[backend-development]]></category>
            <dc:creator><![CDATA[Çiğdem Akcan]]></dc:creator>
            <pubDate>Mon, 31 Aug 2026 10:33:54 GMT</pubDate>
            <atom:updated>2026-08-31T10:38:55.321Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*-zF2oltHOE8ebv2Ym5S8Ig.jpeg" /></figure><h3>Peki bu yapı gerçekten nasıl çalışıyor?</h3><p>Spring Boot’ta global exception handling kullanmak kolaydır.</p><p>Bir sınıfa:</p><pre>@RestControllerAdvice</pre><p>yazarız.</p><p>Sonra:</p><pre>@ExceptionHandler(UserNotFoundException.class)</pre><p>gibi handler metodları ekleriz.</p><p>Ama burada genelde atlanan bir soru var:</p><blockquote><em>Spring, fırlatılan exception’ın hangi </em><em>@ExceptionHandler metoduna gitmesi gerektiğini nasıl biliyor?</em></blockquote><p>Yani aslında olan şey yalnızca:</p><pre>Exception oluştu<br>→ @ControllerAdvice yakaladı</pre><p>değil.</p><p>Arka planda Spring MVC’nin exception çözümleme mekanizması çalışıyor.</p><p>Bu yazıda tam olarak bu zincire bakacağız.</p><h3>Basit Bir Örnekle Başlayalım</h3><p>Bir kullanıcıyı id ile aradığımızı düşünelim:</p><pre>@Service<br>public class UserService {<br><br>    private final UserRepository userRepository;<br><br>    public UserService(UserRepository userRepository) {<br>        this.userRepository = userRepository;<br>    }<br><br>    public UserResponse getUser(Long id) {<br><br>        User user = userRepository.findById(id)<br>                .orElseThrow(() -&gt;<br>                        new UserNotFoundException(<br>                                &quot;Kullanıcı bulunamadı&quot;<br>                        )<br>                );<br><br>        return toResponse(user);<br>    }<br>}</pre><p>Controller tarafı ise oldukça sade:</p><pre>@GetMapping(&quot;/users/{id}&quot;)<br>public ResponseEntity&lt;UserResponse&gt; getUser(<br>        @PathVariable Long id) {<br><br>    return ResponseEntity.ok(<br>            userService.getUser(id)<br>    );<br>}</pre><p>Global handler:</p><pre>@RestControllerAdvice<br>public class GlobalExceptionHandler {<br><br>    @ExceptionHandler(UserNotFoundException.class)<br>    public ResponseEntity&lt;ErrorResponse&gt; handleUserNotFound(<br>            UserNotFoundException ex) {<br><br>        ErrorResponse response =<br>                new ErrorResponse(<br>                        404,<br>                        ex.getMessage()<br>                );<br><br>        return ResponseEntity<br>                .status(HttpStatus.NOT_FOUND)<br>                .body(response);<br>    }<br>}</pre><p>Kullanıcı bulunamazsa şu satır çalışır:</p><pre>throw new UserNotFoundException(<br>        &quot;Kullanıcı bulunamadı&quot;<br>);</pre><p>ve client sonunda şöyle bir response alır:</p><pre>{<br>  &quot;status&quot;: 404,<br>  &quot;message&quot;: &quot;Kullanıcı bulunamadı&quot;<br>}</pre><p>Buraya kadar tanıdık.</p><p>Ama asıl soru şu:</p><p>UserService, GlobalExceptionHandler sınıfını bilmiyor.</p><p>Controller da gidip bu handler metodunu çağırmıyor.</p><p>Peki Spring doğru metoda nasıl ulaşıyor?</p><h3>Exception Önce Yukarı Doğru Yayılır</h3><p>Exception service içinde fırlatıldığında ve orada yakalanmadığında çağrı zincirinde yukarı doğru yayılır.</p><p>Basitleştirirsek:</p><pre>UserService<br>     |<br>     X UserNotFoundException<br>     |<br>     v<br>UserController<br>     |<br>     | burada da yakalanmadı<br>     v<br>DispatcherServlet</pre><p>Spring MVC’de gelen request’lerin merkezinde DispatcherServlet bulunur.</p><p>Normal durumda request’i uygun controller metoduna yönlendirir.</p><p>Ama controller çalışırken bir exception oluşursa bu sefer exception çözümleme mekanizmasını devreye sokar.</p><h3>HandlerExceptionResolver Zinciri</h3><p>Spring MVC exception’ları çözmek için HandlerExceptionResolver mekanizmasını kullanır.</p><p>Bunu tek bir handler gibi değil, exception için uygun çözümü arayan bir zincir olarak düşünebiliriz.</p><pre>Exception<br>    |<br>    v<br>DispatcherServlet<br>    |<br>    v<br>HandlerExceptionResolver Chain<br>    |<br>    v<br>Uygun çözüm<br>    |<br>    v<br>HTTP Response</pre><p>@ExceptionHandler kullandığımızda bizi özellikle ilgilendiren resolver:</p><pre>ExceptionHandlerExceptionResolver</pre><p>dır.</p><p>Bu resolver, controller’larda ve @ControllerAdvice sınıflarında tanımlanmış @ExceptionHandler metodlarını dikkate alır.</p><h3>Spring Doğru Handler’ı Nasıl Buluyor?</h3><p>Şöyle bir yapı düşünelim:</p><pre>@RestControllerAdvice<br>public class GlobalExceptionHandler {<br><br>    @ExceptionHandler(UserNotFoundException.class)<br>    public ResponseEntity&lt;ErrorResponse&gt; handleUserNotFound(<br>            UserNotFoundException ex) {<br>        ...<br>    }<br><br>    @ExceptionHandler(BusinessRuleException.class)<br>    public ResponseEntity&lt;ErrorResponse&gt; handleBusinessRule(<br>            BusinessRuleException ex) {<br>        ...<br>    }<br><br>    @ExceptionHandler(Exception.class)<br>    public ResponseEntity&lt;ErrorResponse&gt; handleUnexpected(<br>            Exception ex) {<br>        ...<br>    }<br>}</pre><p>Service tarafında:</p><pre>throw new UserNotFoundException(<br>        &quot;Kullanıcı bulunamadı&quot;<br>);</pre><p>fırlatıldığında Spring uygun handler’ı arar.</p><p>Akış kabaca şöyledir:</p><pre>UserNotFoundException<br>        |<br>        v<br>ExceptionHandlerExceptionResolver<br>        |<br>        | uygun handler ara<br>        v<br>handleUserNotFound(...)<br>        |<br>        v<br>404 Not Found</pre><p>Buradaki önemli nokta şu:</p><blockquote><em>Controller exception’ı </em><em>@ControllerAdvice sınıfına kendisi göndermez.</em></blockquote><p>Bu yönlendirmeyi Spring MVC yapar.</p><h3>Birden Fazla Handler Uygunsa Ne Olur?</h3><p>Şimdi daha ilginç bir durum düşünelim.</p><pre>@ExceptionHandler(UserNotFoundException.class)<br>public ResponseEntity&lt;?&gt; handleUserNotFound(...) {<br>    ...<br>}<br><br>@ExceptionHandler(RuntimeException.class)<br>public ResponseEntity&lt;?&gt; handleRuntime(...) {<br>    ...<br>}<br><br>@ExceptionHandler(Exception.class)<br>public ResponseEntity&lt;?&gt; handleException(...) {<br>    ...<br>}</pre><p>UserNotFoundException, RuntimeException üzerinden Exception sınıfından türemiş olsun.</p><p>Yani üç handler da type hierarchy açısından uyumlu görünebilir.</p><p>Ama Spring rastgele seçim yapmaz.</p><p>Daha spesifik exception eşleşmesini tercih eder.</p><p>Bu yüzden:</p><pre>@ExceptionHandler(UserNotFoundException.class)</pre><p>çalışır.</p><p>Genel:</p><pre>@ExceptionHandler(Exception.class)</pre><p>handler’ı ise daha spesifik bir eşleşme bulunamadığında devreye giren fallback gibi düşünülebilir.</p><p>Bu yüzden handler metodlarının dosyada hangi sırayla yazıldığına bakarak “önce bu çalışır” demek doğru değildir.</p><h3>Validation Hatalarında Her Alan İçin Ayrı Handler mı Yazılır?</h3><p>Hayır.</p><p>Örneğin kayıt request’imiz şöyle olsun:</p><pre>public record RegisterRequest(<br><br>        @NotBlank<br>        String name,<br><br>        @Email<br>        String email,<br><br>        @Size(min = 8)<br>        String password<br><br>) {<br>}</pre><p>Kullanıcı şu request’i gönderirse:</p><pre>{<br>  &quot;name&quot;: &quot;&quot;,<br>  &quot;email&quot;: &quot;yanlis-email&quot;,<br>  &quot;password&quot;: &quot;123&quot;<br>}</pre><p>aynı anda birden fazla validation hatası oluşabilir.</p><p>Ama her annotation için ayrı @ExceptionHandler yazmayız.</p><p>Spring bu validation sonuçlarını MethodArgumentNotValidException üzerinden bize sunabilir.</p><pre>@ExceptionHandler(MethodArgumentNotValidException.class)<br>public ResponseEntity&lt;?&gt; handleValidation(<br>        MethodArgumentNotValidException ex) {<br><br>    Map&lt;String, String&gt; errors = new HashMap&lt;&gt;();<br><br>    ex.getBindingResult()<br>            .getFieldErrors()<br>            .forEach(error -&gt;<br>                    errors.put(<br>                            error.getField(),<br>                            error.getDefaultMessage()<br>                    )<br>            );<br><br>    return ResponseEntity<br>            .badRequest()<br>            .body(errors);<br>}</pre><p>Yani:</p><pre>@NotBlank<br>@Email<br>@Size<br>   |<br>   v<br>MethodArgumentNotValidException<br>   |<br>   v<br>Tek handler</pre><p>Bu yüzden validation tarafında da merkezi exception handling oldukça kullanışlıdır.</p><h3>Aynı Email ile Tekrar Kayıt Olunursa?</h3><p>Burada validation ile business rule arasındaki fark da netleşir.</p><p>Şu email:</p><pre>cigdem@gmail.com</pre><p>format olarak tamamen geçerli olabilir.</p><p>Yani:</p><pre>@Email</pre><p>kontrolünden geçer.</p><p>Ama sistemde aynı email zaten kayıtlıysa bu artık validation değil, business rule problemidir.</p><p>Service tarafında:</p><pre>if (userRepository.existsByEmail(request.email())) {<br>    throw new BusinessRuleException(<br>            &quot;Bu email zaten kullanılıyor&quot;<br>    );<br>}</pre><p>diyebiliriz.</p><p>Global handler:</p><pre>@ExceptionHandler(BusinessRuleException.class)<br>public ResponseEntity&lt;ErrorResponse&gt; handleBusinessRule(<br>        BusinessRuleException ex) {<br><br>    return ResponseEntity<br>            .status(HttpStatus.CONFLICT)<br>            .body(<br>                    new ErrorResponse(<br>                            409,<br>                            ex.getMessage()<br>                    )<br>            );<br>}</pre><p>Böylece iki farklı hata:</p><pre>Geçersiz email formatı<br>        ↓<br>MethodArgumentNotValidException<br></pre><pre>Email sistemde zaten var<br>        ↓<br>BusinessRuleException</pre><p>farklı sebeplerle oluşsa da aynı merkezi exception mekanizmasından geçebilir.</p><h3>@ControllerAdvice Global Bir try-catch Değil</h3><p>@ControllerAdvice bazen şöyle açıklanıyor:</p><blockquote><em>Uygulamanın global try-catch bloğu.</em></blockquote><p>Başlangıç için anlaşılır bir benzetme ama mekanizmayı tam anlatmıyor.</p><p>Gerçekte:</p><pre>Exception<br>    ↓<br>DispatcherServlet<br>    ↓<br>HandlerExceptionResolver<br>    ↓<br>ExceptionHandlerExceptionResolver<br>    ↓<br>@ExceptionHandler</pre><p>şeklinde bir çözümleme süreci var.</p><p>Yani controller:</p><pre>globalExceptionHandler.handleUserNotFound(...);</pre><p>gibi bir çağrı yapmıyor.</p><p>Aradaki bağlantıyı Spring kuruyor.</p><p>Bu ayrımı bilmek önemli, çünkü @ControllerAdvice’ın neden bazı exception’ları yakalayamadığını anlamak da buradan başlıyor.</p><h3>Her Exception Buraya Ulaşır mı?</h3><p>Hayır.</p><p>Buraya kadar konuştuğumuz yapı Spring MVC tarafındaydı:</p><pre>Request<br>   ↓<br>DispatcherServlet<br>   ↓<br>Controller</pre><p>Ama Spring Security eklendiğinde request daha controller’a ulaşmadan önce filter chain’den geçer:</p><pre>Request<br>   ↓<br>Security Filter Chain<br>   ↓<br>DispatcherServlet<br>   ↓<br>Controller</pre><p>Eğer bir hata Security Filter Chain içinde oluşursa, exception henüz Spring MVC’nin resolver mekanizmasına ulaşmamış olabilir.</p><p>Bu yüzden @ControllerAdvice bütün uygulamadaki bütün exception’lar için evrensel bir çözüm değildir.</p><p>JWT tarafına geçildiğinde bu ayrım çok daha önemli hale gelir.</p><h3>Akışı Tek Şemada Toparlayalım</h3><p>Kullanıcı bulunamadığını düşünelim:</p><pre>HTTP Request<br>     |<br>     v<br>DispatcherServlet<br>     |<br>     v<br>UserController<br>     |<br>     v<br>UserService<br>     |<br>     X<br>UserNotFoundException<br>     |<br>     v<br>Exception çağrı zincirinde yukarı yayılır<br>     |<br>     v<br>DispatcherServlet<br>     |<br>     v<br>HandlerExceptionResolver Chain<br>     |<br>     v<br>ExceptionHandlerExceptionResolver<br>     |<br>     v<br>En uygun @ExceptionHandler seçilir<br>     |<br>     v<br>handleUserNotFound(...)<br>     |<br>     v<br>404 Not Found<br>     |<br>     v<br>Client</pre><p>@ControllerAdvice kullanırken genellikle görmediğimiz asıl mekanizma budur.</p><h4>📌 <strong>Günün Özeti:</strong></h4><blockquote><em>@ControllerAdvice kullanınca hata yönetimi merkezileşiyor; ama işin asıl mantığı, exception’ın Spring MVC içinde nasıl çözülüp doğru </em><em>@ExceptionHandler metoduna yönlendirildiğinde saklı.</em></blockquote><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=23ce7b4dbe1c" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[@Valid Her Şeyi Çözmez: Spring Boot’ta Validation ve İş Kuralları Nasıl Ayrılır?]]></title>
            <link>https://medium.com/@cigdemakcan3/valid-her-%C5%9Feyi-%C3%A7%C3%B6zmez-spring-bootta-validation-ve-i%CC%87%C5%9F-kurallar%C4%B1-nas%C4%B1l-ayr%C4%B1l%C4%B1r-aef4ba525184?source=rss-20e416d2ec3d------2</link>
            <guid isPermaLink="false">https://medium.com/p/aef4ba525184</guid>
            <category><![CDATA[backend-development]]></category>
            <category><![CDATA[software-architecture]]></category>
            <category><![CDATA[bean-validation]]></category>
            <category><![CDATA[java]]></category>
            <category><![CDATA[spring-boot]]></category>
            <dc:creator><![CDATA[Çiğdem Akcan]]></dc:creator>
            <pubDate>Thu, 27 Aug 2026 16:46:53 GMT</pubDate>
            <atom:updated>2026-08-31T11:18:48.443Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*sbuP84DEB9dsPSvoevicNQ.jpeg" /></figure><p>Spring Boot ile REST API geliştirmeye başladığınızda ilk öğrendiğiniz koruma katmanlarından biri @Valid olur. DTO üzerine @NotNull, @NotBlank veya @Email gibi anotasyonlar ekler, Controller parametresinde @Valid kullanırsınız. Geçersiz request’ler daha Service katmanına ulaşmadan durdurulur.</p><p>İlk başta bu oldukça güçlü görünür. Sanki validation problemi tek satırla çözülmüş gibidir.</p><p>Fakat gerçek bir projede kısa sürede şu soruyla karşılaşırsınız:</p><blockquote><strong><em>E-posta adresinin biçimi doğru, peki bu adres sistemde zaten kayıtlıysa ne olacak?</em></strong></blockquote><p>İşte burada @Valid’in sınırı ortaya çıkar. Çünkü @Valid, gelen verinin biçimsel olarak constraint’lere uyup uymadığını kontrol eder; sistemin mevcut durumunu veya veritabanındaki veriyi tek başına bilemez.</p><p><em>İşte bu farkı ve katmanların sorumluluklarını somutlaştırmak için basit bir kullanıcı kayıt senaryosu üzerinden ilerleyelim.</em></p><h3>Senaryo: Yeni kullanıcı kaydı</h3><p>Uygulamamız şu isteği kabul etsin:</p><pre>POST /api/users/register<br>Content-Type: application/json</pre><pre>{<br>  &quot;name&quot;: &quot;Çiğdem&quot;,<br>  &quot;email&quot;: &quot;cigdem@example.com&quot;,<br>  &quot;password&quot;: &quot;gucluParola123&quot;,<br>  &quot;passwordConfirmation&quot;: &quot;gucluParola123&quot;<br>}</pre><p>Kayıt işlemi için kurallarımız şunlar olsun:</p><ul><li>İsim boş bırakılamaz.</li><li>E-posta boş bırakılamaz ve geçerli bir biçimde olmalıdır.</li><li>Parola en az sekiz karakter olmalıdır.</li><li>Parola ile parola tekrarı eşleşmelidir.</li><li>Aynı e-posta adresiyle ikinci bir hesap oluşturulamamalıdır.</li></ul><p>Bu kuralların tamamı “validation” gibi görünse de aynı türde değildir.</p><h3>@Valid gerçekte ne yapıyor?</h3><p>Spring Boot 3, jakarta.validation paketindeki Jakarta Bean Validation API’sini kullanır. Kullanıcı kayıt isteğimizi bir DTO ile karşılayabiliriz:</p><pre>public record RegisterUserRequest(<br>        @NotBlank(message = &quot;İsim boş olamaz&quot;)<br>        @Size(max = 100, message = &quot;İsim 100 karakteri geçemez&quot;)<br>        String name,<br><br>        @NotBlank(message = &quot;E-posta boş olamaz&quot;)<br>        @Email(message = &quot;Geçerli bir e-posta adresi giriniz&quot;)<br>        String email,<br><br>        @NotBlank(message = &quot;Parola boş olamaz&quot;)<br>        @Size(min = 8, message = &quot;Parola en az 8 karakter olmalıdır&quot;)<br>        String password,<br><br>        @NotBlank(message = &quot;Parola tekrarı boş olamaz&quot;)<br>        String passwordConfirmation<br>) {<br>}</pre><p>Controller’da DTO’yu @Valid ile karşılarız:</p><pre>@PostMapping(&quot;/register&quot;)<br>public ResponseEntity&lt;UserResponse&gt; register(<br>        @Valid @RequestBody RegisterUserRequest request) {<br><br>    UserResponse response = userService.register(request);<br><br>    return ResponseEntity<br>            .status(HttpStatus.CREATED)<br>            .body(response);<br>}</pre><p>Spring önce JSON’u RegisterUserRequest nesnesine dönüştürür. Ardından @Valid, DTO üzerindeki constraint’lerin çalıştırılmasını sağlar.</p><p>Kurallardan biri başarısız olursa Controller metodunun gövdesi çalışmaz ve Service çağrılmaz. Spring MVC bu durumda MethodArgumentNotValidException oluşturur. Varsayılan hata yönetimi veya bizim yazdığımız global handler bu hatayı 400 Bad Request cevabına dönüştürebilir.</p><p>Akış kısaca şöyledir:</p><pre>JSON isteği<br>→ RegisterUserRequest<br>→ @Valid<br>→ @NotBlank / @Email / @Size<br>→ MethodArgumentNotValidException<br>→ 400 Bad Request</pre><p>Burada önemli bir ayrıntı var: @Valid kendi başına bir kural veya hata mesajı tanımlamaz. DTO üzerindeki kuralları çalıştırır. Mesajlar ilgili constraint’in içinde bulunur:</p><pre>@Email(message = &quot;Geçerli bir e-posta adresi giriniz&quot;)</pre><h3>Request validation nerede biter?</h3><p>Bean Validation, gelen request’in içeriği üzerinden cevaplanabilecek sorular için uygundur:</p><ul><li>İsim boş mu?</li><li>E-posta biçimi geçerli mi?</li><li>Parola yeterince uzun mu?</li><li>Sayısal değer izin verilen aralıkta mı?</li><li>Tarih geçmişte mi?</li></ul><p>Fakat @Email, yalnızca metnin e-posta biçimine uyup uymadığına bakabilir. Adresin veritabanında daha önce kullanılıp kullanılmadığını bilemez.</p><p>Bu noktada artık request’in şekliyle değil, uygulamanın mevcut durumuyla ilgileniyoruz.</p><h3>Parola eşleşmesi hangi tarafta olmalı?</h3><p>Parola ile parola tekrarının eşleşmesi, iki alan arasında bir kuraldır. Ancak karar verebilmek için veritabanına veya oturum bilgisine ihtiyacımız yoktur; iki değer de aynı request’in içindedir.</p><p>Bu nedenle kontrolü Service’e taşımak zorunda değiliz. Basit bir örnekte @AssertTrue, daha kapsamlı projelerde ise sınıf seviyesinde custom Bean Validation constraint’i kullanılabilir:</p><pre>public record RegisterUserRequest(<br>        String name,<br>        String email,<br>        String password,<br>        String passwordConfirmation<br>) </pre><pre>@AssertTrue(message = &quot;Parolalar eşleşmiyor&quot;)<br>    public boolean isPasswordConfirmed() {<br>        return Objects.equals(password, passwordConfirmation);<br>    }<br>}</pre><p>Gerçek DTO’da alanların üzerindeki @NotBlank, @Email ve @Size constraint’leri de korunur; burada yalnızca çapraz alan kontrolünü göstermek için kısaltılmış bir sürüm kullandık.</p><p>Bu örnek önemli bir ayrımı gösterir:</p><p><strong>Yalnızca request’in içeriğine bakmak yeterli mi?</strong><br> → Bean Validation veya custom validator</p><p><strong>Veritabanı, oturum ya da sistemin mevcut durumu gerekiyor mu?</strong><br> → Service katmanındaki iş kuralı</p><h3>Aynı e-posta daha önce kullanılmış mı?</h3><p>Şu e-posta DTO’daki bütün validation kurallarını geçebilir:</p><pre>cigdem@example.com</pre><p>Biçimi doğrudur ve boş değildir. Fakat aynı adresle daha önce hesap oluşturulmuşsa yeni kayıt reddedilmelidir.</p><p>Bu artık bir request validation kuralı değil, iş kuralıdır:</p><blockquote><em>Sistemde aynı e-posta adresine sahip iki kullanıcı bulunamaz.</em></blockquote><p>Önce Repository’de yalnızca kaydın var olup olmadığını döndüren bir derived query tanımlayabiliriz:</p><pre>public interface UserRepository extends JpaRepository&lt;User, Long&gt; {<br><br>    boolean existsByEmailIgnoreCase(String email);<br><br>}</pre><p>Metodun gövdesini yazmayız. Spring Data JPA, metot isminden e-posta alanına göre büyük-küçük harf duyarsız bir varlık sorgusu üretir.</p><p>Ardından Service içinde kullanıcıyı kaydetmeden önce kontrol ederiz:</p><pre>@Transactional<br>public UserResponse register(RegisterUserRequest request) {<br><br>    String normalizedEmail = request.email()<br>            .trim()<br>            .toLowerCase(Locale.ROOT);<br><br>    if (userRepository.existsByEmailIgnoreCase(normalizedEmail)) {<br>        throw new DuplicateEmailException(&quot;Bu e-posta zaten kullanılıyor&quot;);<br>    }<br><br>    User user = User.builder()<br>            .name(request.name())<br>            .email(normalizedEmail)<br>            .password(passwordEncoder.encode(request.password()))<br>            .build();<br><br>    User savedUser = userRepository.save(user);<br><br>    return userMapper.toResponse(savedUser);<br>}</pre><p>Burada @Valid tarafından yapılmış kontrolleri Service içinde tekrar etmiyoruz. Service yalnızca uygulamanın mevcut durumuna bağlı kararı veriyor.</p><p>Controller HTTP isteğini karşılar; Service ise işlemin yapılıp yapılamayacağına karar verir.</p><h3>DuplicateEmailException nereden geliyor?</h3><p>DuplicateEmailException, Spring’in hazır exception’larından biri değildir. Uygulamanın iş kuralını açıkça ifade etmek için oluşturduğumuz custom exception’dır:</p><pre>public class DuplicateEmailException extends RuntimeException {<br><br>    public DuplicateEmailException(String message) {<br>        super(message);<br>    }<br><br>}</pre><p>Generic bir RuntimeException fırlatmak yerine anlamlı bir exception tipi kullanmak, hatanın nedenini hem Service kodunda hem de global hata yönetiminde açıkça ayırt etmemizi sağlar.</p><h3>Service kontrolü neden tek başına yeterli değildir?</h3><p>existsByEmailIgnoreCase() kullanıcıya erken ve anlaşılır bir hata döndürmemizi sağlar. Ancak veri bütünlüğünü tek başına kesin olarak garanti etmez.</p><p>Aynı anda gelen iki kayıt isteği şu sırayla ilerleyebilir:</p><ol><li>Birinci istek e-postayı sorgular ve kayıt bulamaz.</li><li>İkinci istek de henüz kayıt oluşmadığı için aynı sonucu alır.</li><li>İki istek de kullanıcıyı kaydetmeye çalışır.</li></ol><p>Bu nedenle veritabanında da unique constraint bulunmalıdır:</p><pre>@Column(nullable = false, unique = true)<br>private String email;</pre><p>Production projelerinde bu constraint genellikle Flyway veya Liquibase migration’ı ile açıkça oluşturulur.</p><p>İki kontrolün sorumluluğu farklıdır:</p><ul><li>Service kontrolü, kullanıcıya erken ve anlaşılır bir hata verebilmemizi sağlar.</li><li>Veritabanı constraint’i, eşzamanlı isteklerde veri bütünlüğünü koruyan son savunma hattıdır.</li></ul><h3>Exception fırlatmak otomatik olarak 409 döndürür mü?</h3><p>Hayır. DuplicateEmailException fırlatmak, Spring’in kendiliğinden 409 Conflict döneceği anlamına gelmez.</p><p>Bu exception ile HTTP durum kodu arasındaki eşlemenin @RestControllerAdvice içindeki bir @ExceptionHandler metodunda açıkça yapılması gerekir. Böyle bir handler bulunmazsa custom RuntimeException çoğunlukla 500 Internal Server Error olarak sonuçlanır.</p><p>Bu senaryo için hedeflediğimiz hata sözleşmesi şöyledir:</p><ul><li>Boş isim, geçersiz e-posta veya kısa parola: 400 Bad Request</li><li>Daha önce kullanılmış e-posta: 409 Conflict</li></ul><p>Bir sonraki yazıda DuplicateEmailException hatasını 409 Conflict cevabına nasıl dönüştüreceğimizi ve validation hatalarını standart bir response yapısında nasıl toplayacağımızı ele alacağız.</p><h3>📌 Özetle</h3><p>@Valid’i bir binanın ön kapısı gibi düşünebiliriz. İçeri girecek verinin en azından tanımladığımız kurallara uygun olmasını sağlar. Fakat kapıdan geçen veriyle belirli bir işlemin yapılıp yapılamayacağı farklı bir sorumluluktur.</p><p>Kullanıcı kayıt örneğinde görev dağılımı şöyle oldu:</p><p><strong>Kullanıcı kayıt örneğinde görev dağılımı şöyle olur:</strong></p><ul><li>RegisterUserRequest → isim, e-posta ve parola constraint’leri</li><li>Controller + @Valid → validation sürecini başlatır</li><li>UserService → duplicate e-posta iş kuralını kontrol eder</li><li>UserRepository → e-posta için veritabanı sorgusunu yapar</li><li>DuplicateEmailException → iş kuralı ihlalini ifade eder</li><li>Database unique constraint → veri bütünlüğünü son katmanda korur</li></ul><p>Kısacası @Valid her şeyi çözmez; zaten çözmesi de beklenmemelidir. Önemli olan her kuralı, ihtiyaç duyduğu bilgiye ve taşıdığı sorumluluğa göre doğru katmana yerleştirmektir.</p><h3>Kaynaklar</h3><ul><li><a href="https://docs.spring.io/spring-framework/reference/core/validation/beanvalidation.html">Spring Framework — Bean Validation</a></li><li><a href="https://docs.spring.io/spring-framework/reference/web/webmvc/mvc-controller/ann-validation.html">Spring Framework — Validation in Spring MVC</a></li><li><a href="https://docs.spring.io/spring-framework/reference/web/webmvc/mvc-ann-rest-exceptions.html">Spring Framework — Error Responses</a></li><li><a href="https://jakarta.ee/specifications/bean-validation/">Jakarta Bean Validation</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=aef4ba525184" width="1" height="1" alt="">]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Spring Boot’ta Dirty Checking Nedir? save() Olmadan Güncelleme Nasıl Yapılır?]]></title>
            <link>https://medium.com/@cigdemakcan3/spring-bootta-dirty-checking-nedir-save-olmadan-g%C3%BCncelleme-nas%C4%B1l-yap%C4%B1l%C4%B1r-f019cd677e44?source=rss-20e416d2ec3d------2</link>
            <guid isPermaLink="false">https://medium.com/p/f019cd677e44</guid>
            <category><![CDATA[backend-development]]></category>
            <category><![CDATA[spring-boot]]></category>
            <category><![CDATA[spring-data-jpa]]></category>
            <category><![CDATA[java]]></category>
            <category><![CDATA[hibernate]]></category>
            <dc:creator><![CDATA[Çiğdem Akcan]]></dc:creator>
            <pubDate>Mon, 24 Aug 2026 16:10:57 GMT</pubDate>
            <atom:updated>2026-08-24T16:10:57.859Z</atom:updated>
            <content:encoded><![CDATA[<figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*LznrsU55nHKQQr9NHLjevA.png" /></figure><p>Spring Boot ile bir güncelleme metodu yazarken genellikle ilgili kaydı veritabanından getirir, alanlarını değiştirir ve ardından save() metodunu çağırırız.</p><p>Peki <strong>@Transactional</strong> ile çalışan bir metotta save() kullanmadan da veritabanının güncellenebildiğini biliyor muydunuz?</p><p>Bu davranışın arkasında Hibernate’in <strong>Dirty Checking (Kirli Kontrolü)</strong> mekanizması bulunur.</p><h3>Dirty Checking Nedir?</h3><p><strong>Dirty Checking</strong>, Hibernate’in <em>Persistence Context</em> tarafından yönetilen entity’lerde meydana gelen değişiklikleri takip etmesi ve bu değişiklikleri veritabanına otomatik olarak yansıtmasıdır.</p><ol><li><strong>Managed Durum:</strong> Bir entity, transaction içerisinde veritabanından getirildiğinde Persistence Context’e bağlanır ve <em>managed</em> duruma geçer. Hibernate, entity’nin veritabanından getirildiği andaki durumunun bir kopyasını (snapshot) saklar.</li><li><strong>Değişiklik Algılama:</strong> Entity’nin bir alanını değiştirdiğimizde güncelleme hemen veritabanına gönderilmez. Değişiklik önce Java nesnesi üzerinde gerçekleşir.</li><li><strong>Flush Aşaması:</strong> Flush sırasında — genellikle transaction commit edilmeden hemen önce — Hibernate entity’nin ilk durumu ile güncel durumunu karşılaştırır. Bir değişiklik tespit ederse gerekli UPDATE sorgusunu otomatik olarak oluşturur.</li></ol><h3>Örnek Üzerinden İnceleyelim</h3><p>Aşağıdaki metot, bir kullanıcının e-posta adresini güncellemektedir:</p><pre>@Transactional<br>public void updateUserEmail(Long id, String newEmail) {<br>    User user = userRepository.findById(id)<br>            .orElseThrow(() -&gt;<br>                    new ResourceNotFoundException(&quot;Kullanıcı bulunamadı&quot;));<br><br>    user.setEmail(newEmail);<br>}</pre><p>Metotta userRepository.save(user) çağrısı bulunmamasına rağmen kullanıcının yeni e-posta adresi veritabanına kaydedilir.</p><p>Çünkü findById() ile getirilen user nesnesi, transaction içerisinde <em>managed</em> durumdadır. user.setEmail(newEmail) çağrısı yapıldığında değişiklik önce Java nesnesi üzerinde gerçekleşir. Transaction tamamlanırken Hibernate değişikliği tespit eder ve gerekli UPDATE sorgusunu otomatik olarak veritabanına gönderir.</p><p><strong>📌 Önemli Not:</strong> Dirty Checking’in çalışabilmesi için entity’nin <em>Persistence Context</em> tarafından yönetilen (<strong>managed</strong>) durumda olması gerekir. Yeni oluşturulan (<em>transient</em>) veya context dışında kalan (<em>detached</em>) entity’lerde değişikliklerin veritabanına yansıması için save() metoduna ihtiyaç duyulur.</p><h4><strong>Kaynaklar</strong></h4><ul><li><a href="https://docs.jboss.org/hibernate/orm/current/userguide/html_single/Hibernate_User_Guide.html">Hibernate ORM Documentation</a></li><li><a href="https://www.google.com/search?q=https://www.baeldung.com/hibernate-dirty-checking">Baeldung — Hibernate Dirty Checking</a></li></ul><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=f019cd677e44" width="1" height="1" alt="">]]></content:encoded>
        </item>
    </channel>
</rss>