Modern web uygulamalar\u0131nda istisna y\u00f6netimi, kullan\u0131c\u0131 deneyimini do\u011frudan etkileyen ve uygulaman\u0131n istikrar\u0131n\u0131 sa\u011flayan kritik bir konudur. Spring Boot, bu karma\u015f\u0131k s\u00fcreci basitle\u015ftirmek ve merkezi bir \u015fekilde y\u00f6netmek i\u00e7in g\u00fc\u00e7l\u00fc mekanizmalar sunar. Bu makalede, Spring Boot projelerinizde istisnalar\u0131 k\u00fcresel olarak nas\u0131l ele alaca\u011f\u0131n\u0131z\u0131, en iyi uygulamalar\u0131 ve s\u0131k\u00e7a kar\u015f\u0131la\u015f\u0131lan senaryolar\u0131 detayl\u0131 kod \u00f6rnekleriyle birlikte inceleyece\u011fiz. Amac\u0131m\u0131z, uygulaman\u0131z\u0131n beklenmedik durumlar kar\u015f\u0131s\u0131nda dahi tutarl\u0131 ve anla\u015f\u0131l\u0131r hata yan\u0131tlar\u0131 \u00fcretmesini sa\u011flamakt\u0131r.<\/p>\n
Uygulamalar\u0131m\u0131zda hata ve istisnalar\u0131n meydana gelmesi ka\u00e7\u0131n\u0131lmazd\u0131r. Bir veritaban\u0131 ba\u011flant\u0131 hatas\u0131, ge\u00e7ersiz kullan\u0131c\u0131 giri\u015fi veya bir a\u011f zaman a\u015f\u0131m\u0131, uygulaman\u0131n normal ak\u0131\u015f\u0131n\u0131 bozabilir. Bu t\u00fcr durumlar\u0131 etkili bir \u015fekilde y\u00f6netmek, uygulaman\u0131n \u00e7\u00f6kmesini engellemek, kullan\u0131c\u0131ya anlaml\u0131 geri bildirim sa\u011flamak ve g\u00fcvenlik a\u00e7\u0131klar\u0131n\u0131 \u00f6nlemek i\u00e7in hayati \u00f6neme sahiptir.<\/p>\n
\u0130stisnalar, program\u0131n \u00e7al\u0131\u015fma zaman\u0131nda ortaya \u00e7\u0131kan ve normal ak\u0131\u015f\u0131 bozan olaylard\u0131r. Do\u011fru y\u00f6netilmediklerinde, kullan\u0131c\u0131ya anlams\u0131z hata mesajlar\u0131 g\u00f6sterebilir, uygulaman\u0131n tamamen durmas\u0131na neden olabilir veya hassas sistem bilgilerini a\u00e7\u0131\u011fa \u00e7\u0131karabilirler. \u0130yi bir istisna y\u00f6netimi stratejisi, uygulaman\u0131n esnekli\u011fini art\u0131r\u0131r ve daha sa\u011flam bir yap\u0131 sunar.<\/p>\n
Her metot i\u00e7inde ayr\u0131 ayr\u0131 Spring Framework, istisna y\u00f6netimi i\u00e7in \u00e7e\u015fitli ara\u00e7lar sunar. Bunlar aras\u0131nda en pop\u00fcler ve g\u00fc\u00e7l\u00fc olan\u0131 Spring Boot’ta k\u00fcresel istisna y\u00f6netiminin kalbinde <\/code><\/p>\n Yukar\u0131daki \u00f6rnekte, Belirli istisnalar\u0131 yakalaman\u0131n yan\u0131 s\u0131ra, daha genel istisnalar\u0131 da ele alabilirsiniz. <\/code><\/p>\n Bu metot, \u00f6zel olarak ele al\u0131nmayan t\u00fcm istisnalar\u0131 yakalayarak, kullan\u0131c\u0131ya genel bir hata mesaj\u0131 sunar ve sunucu taraf\u0131nda detayl\u0131 loglama yap\u0131lmas\u0131n\u0131 sa\u011flar.<\/p>\n Uygulaman\u0131z\u0131n i\u015f mant\u0131\u011f\u0131na \u00f6zg\u00fc hatalar\u0131 daha anlaml\u0131 bir \u015fekilde y\u00f6netmek i\u00e7in \u00f6zel istisna s\u0131n\u0131flar\u0131 olu\u015fturmak iyi bir pratiktir. Bu, kodunuzun daha okunabilir olmas\u0131n\u0131 sa\u011flar ve istisna i\u015fleme mant\u0131\u011f\u0131n\u0131 daha spesifik hale getirir.<\/p>\n Standart Java istisnalar\u0131 (\u00f6rne\u011fin Spring Boot'ta genellikle <\/code><\/p>\n \u00d6zel istisna s\u0131n\u0131flar\u0131n\u0131za ek olarak, hata kodlar\u0131 veya ek ba\u011flam bilgileri i\u00e7eren alanlar ekleyebilirsiniz. Bu, istemcinin hatay\u0131 daha iyi anlamas\u0131na ve uygun \u015fekilde tepki vermesine yard\u0131mc\u0131 olabilir.<\/p>\n <\/code><\/p>\n Bu \u00f6zel istisnay\u0131 \u0130stemciye d\u00f6n\u00fclen hata yan\u0131t\u0131n\u0131n sadece bir mesajdan ibaret olmamas\u0131, hatan\u0131n t\u00fcr\u00fc, detaylar\u0131 ve olas\u0131 \u00e7\u00f6z\u00fcmleri hakk\u0131nda bilgi i\u00e7ermesi \u00f6nemlidir. Bu, API'nizin daha kullan\u0131\u015fl\u0131 olmas\u0131n\u0131 sa\u011flar.<\/p>\n RESTful API'lerde hata yan\u0131tlar\u0131 i\u00e7in RFC 7807 (Problem Details for HTTP APIs) standard\u0131 yayg\u0131n olarak kullan\u0131l\u0131r. Bu standart, hata yan\u0131tlar\u0131 i\u00e7in tutarl\u0131 bir yap\u0131 \u00f6nerir:<\/p>\n * Bu standard\u0131 veya kendi \u00f6zel hata yan\u0131t\u0131 yap\u0131n\u0131z\u0131 uygulamak i\u00e7in bir POJO (Plain Old Java Object) s\u0131n\u0131f\u0131 tan\u0131mlayabilirsiniz.<\/p>\n <\/code><\/p>\n Ard\u0131ndan, <\/code><\/p>\n \u00c7ok dilli uygulamalar i\u00e7in hata mesajlar\u0131n\u0131 yerelle\u015ftirmek \u00f6nemlidir. Spring'in Spring Boot'ta <\/code><\/p>\n Bu \u00f6rnekte, Do\u011frulama hata mesajlar\u0131n\u0131n kullan\u0131c\u0131 dostu olmas\u0131 \u00f6nemlidir. Bean Validation (JSR 380) anotasyonlar\u0131na \u00f6zel mesajlar ekleyerek bu mesajlar\u0131 \u00f6zelle\u015ftirebilirsiniz:<\/p>\n <\/code><\/p>\n Bu \u015fekilde, Yukar\u0131daki Spring Boot uygulamalar\u0131nda sadece i\u015f mant\u0131\u011f\u0131na ait istisnalar de\u011fil, ayn\u0131 zamanda g\u00fcvenlik, a\u011f veya uygulama altyap\u0131s\u0131yla ilgili \u00e7e\u015fitli istisnalar da ortaya \u00e7\u0131kabilir. Bu istisnalar\u0131 da k\u00fcresel olarak ele almak, uygulaman\u0131n genel sa\u011flaml\u0131\u011f\u0131n\u0131 art\u0131r\u0131r.<\/p>\n Spring Security kullan\u0131yorsan\u0131z, yetkilendirme veya kimlik do\u011frulama hatalar\u0131 \u00f6zel istisnalar olarak f\u0131rlat\u0131l\u0131r:<\/p>\n * Bu istisnalar\u0131 Spring MVC'nin varsay\u0131lan istisna i\u015fleme mekanizmalar\u0131n\u0131n yakalayamad\u0131\u011f\u0131 baz\u0131 istisnalar da vard\u0131r:<\/p>\n * Bu istisnalar\u0131 da genel hata y\u00f6neticinize ekleyerek tutarl\u0131 404 veya 503 (Service Unavailable) yan\u0131tlar\u0131 sa\u011flayabilirsiniz.<\/p>\n A\u015fa\u011f\u0131daki tabloda, Spring Boot uygulamalar\u0131nda s\u0131k\u00e7a kar\u015f\u0131la\u015f\u0131lan baz\u0131 istisnalar ve bunlara kar\u015f\u0131l\u0131k gelen tipik HTTP durum kodlar\u0131 listelenmi\u015ftir:<\/p>\n Bu tablo, yayg\u0131n istisnalar i\u00e7in h\u0131zl\u0131 bir ba\u015fvuru noktas\u0131 sunar ve k\u00fcresel hata y\u00f6neticinizi tasarlarken size yol g\u00f6sterebilir.<\/p>\n Spring Boot'ta k\u00fcresel istisna y\u00f6netimi, modern ve sa\u011flam bir API geli\u015ftirmenin temel ta\u015flar\u0131ndan biridir. \u0130stisna detaylar\u0131n\u0131 (stack trace dahil) sunucu taraf\u0131nda loglamak, hatalar\u0131n k\u00f6k nedenini bulmak ve uygulamadaki sorunlar\u0131 gidermek i\u00e7in kritik \u00f6neme sahiptir. Kullan\u0131c\u0131ya genel bir hata mesaj\u0131 d\u00f6nerken, arka planda loglanan detaylar geli\u015ftiricilerin sorunu h\u0131zl\u0131ca tespit etmesine yard\u0131mc\u0131 olur. Hassas bilgilerin (\u00f6rn. veritaban\u0131 \u015fifreleri) loglara s\u0131zmad\u0131\u011f\u0131ndan emin olmak \u00f6nemlidir.<\/p>\n Kullan\u0131c\u0131lara g\u00f6sterilen hata mesajlar\u0131, teknik detaylardan ar\u0131nd\u0131r\u0131lm\u0131\u015f, anla\u015f\u0131l\u0131r ve eyleme d\u00f6n\u00fc\u015ft\u00fcr\u00fclebilir olmal\u0131d\u0131r. \u00d6rne\u011fin, bir veritaban\u0131 hatas\u0131 yerine \"\u0130\u015flem tamamlanamad\u0131, l\u00fctfen daha sonra tekrar deneyin\" gibi genel bir mesaj tercih edilmelidir. Do\u011frulama hatalar\u0131 gibi kullan\u0131c\u0131 girdisine ba\u011fl\u0131 hatalar i\u00e7in ise \"E-posta adresi ge\u00e7ersiz\" gibi spesifik ve y\u00f6nlendirici mesajlar verilmelidir.<\/p>\n Geli\u015ftirme ortam\u0131nda (Dev), istisna detaylar\u0131n\u0131 (stack trace dahil) istemciye d\u00f6nd\u00fcrmek hata ay\u0131klamay\u0131 kolayla\u015ft\u0131rabilir. Ancak \u00fcretim ortam\u0131nda (Prod), bu t\u00fcr detaylar g\u00fcvenlik riski olu\u015fturabilir ve kullan\u0131c\u0131 deneyimini k\u00f6t\u00fcle\u015ftirebilir. Bu durumu y\u00f6netmek i\u00e7in, try-catch<\/code> bloklar\u0131 kullanmak, kod tekrar\u0131na yol a\u00e7ar ve okunabilirli\u011fi d\u00fc\u015f\u00fcr\u00fcr. \u00d6zellikle b\u00fcy\u00fck projelerde, bu yakla\u015f\u0131m s\u00fcrd\u00fcr\u00fclemez hale gelir. Her bir kontrolc\u00fc veya servis katman\u0131nda ayn\u0131 hata i\u015fleme mant\u0131\u011f\u0131n\u0131 tekrarlamak yerine, Spring Boot’un sundu\u011fu merkezi mekanizmalarla bu s\u00fcreci otomatikle\u015ftirmek \u00e7ok daha verimlidir.<\/p>\nSpring’in \u0130stisna Y\u00f6netimi Mekanizmalar\u0131<\/h4>\n
@ControllerAdvice<\/code> ve @ExceptionHandler<\/code> anotasyonlar\u0131d\u0131r. Bu anotasyonlar, t\u00fcm kontrolc\u00fclerde veya belirli kontrolc\u00fclerde meydana gelen istisnalar\u0131 tek bir merkezi noktadan ele almam\u0131z\u0131 sa\u011flar.<\/p>\n@ControllerAdvice ve @ExceptionHandler Kullan\u0131m\u0131<\/h3>\n
@ControllerAdvice<\/code> ve @ExceptionHandler<\/code> anotasyonlar\u0131 bulunur. Bu ikili, uygulaman\u0131zdaki t\u00fcm kontrolc\u00fclerden f\u0131rlat\u0131lan istisnalar\u0131 tek bir yerde toplaman\u0131z\u0131 ve \u00f6zel olarak i\u015flemenizi sa\u011flar.<\/p>\n@ControllerAdvice Nedir?<\/h4>\n
@ControllerAdvice<\/code> (veya RESTful servisler i\u00e7in @RestControllerAdvice<\/code>), Spring’in @Controller<\/code> anotasyonlu s\u0131n\u0131flar\u0131na (yani kontrolc\u00fclere) genel bir davran\u0131\u015f eklemek i\u00e7in kullan\u0131lan bir anotasyondur. Bir @ControllerAdvice<\/code> s\u0131n\u0131f\u0131, uygulaman\u0131zdaki t\u00fcm kontrolc\u00fcler i\u00e7in istisna yakalama, veri ba\u011flama veya model niteliklerini y\u00f6netme gibi i\u015flemleri merkezi olarak ger\u00e7ekle\u015ftirebilir. Bir nevi, t\u00fcm kontrolc\u00fcler i\u00e7in bir vekil g\u00f6revi g\u00f6r\u00fcr.<\/p>\n@ExceptionHandler ile Belirli \u0130stisnalar\u0131 Yakalama<\/h4>\n
@ExceptionHandler<\/code> anotasyonu, bir @ControllerAdvice<\/code> s\u0131n\u0131f\u0131 i\u00e7inde belirli bir istisna t\u00fcr\u00fcn\u00fc yakalamak i\u00e7in kullan\u0131l\u0131r. Bu anotasyonla i\u015faretlenmi\u015f bir metot, belirtilen istisna f\u0131rlat\u0131ld\u0131\u011f\u0131nda otomatik olarak \u00e7a\u011fr\u0131l\u0131r. Metot, istisnay\u0131 yakalar, uygun bir HTTP durum koduyla bir hata yan\u0131t\u0131 olu\u015fturur ve istemciye geri d\u00f6ner.<\/p>\n\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.ResponseEntity;\nimport org.springframework.web.bind.annotation.ControllerAdvice;\nimport org.springframework.web.bind.annotation.ExceptionHandler;\n\n@ControllerAdvice\npublic class GlobalExceptionHandler {\n\n @ExceptionHandler(ResourceNotFoundException.class)\n public ResponseEntityResourceNotFoundException<\/code> f\u0131rlat\u0131ld\u0131\u011f\u0131nda handleResourceNotFoundException<\/code> metodu, IllegalArgumentException<\/code> f\u0131rlat\u0131ld\u0131\u011f\u0131nda ise handleIllegalArgumentException<\/code> metodu devreye girer.<\/p>\nGeni\u015f Kapsaml\u0131 \u0130stisna Yakalama (Exception.class)<\/h4>\n
Exception.class<\/code> tipindeki istisnalar\u0131 yakalamak, uygulaman\u0131zda \u00f6nceden tan\u0131mlanmam\u0131\u015f veya beklenmedik t\u00fcm di\u011fer istisnalar\u0131 ele almak i\u00e7in \"catch-all\" bir mekanizma sa\u011flar. Bu, uygulaman\u0131z\u0131n beklenmedik bir hata durumunda dahi tutarl\u0131 bir yan\u0131t vermesini garanti eder.<\/p>\n\n \/\/ ... di\u011fer @ExceptionHandler metotlar\u0131 ...\n\n @ExceptionHandler(Exception.class)\n public ResponseEntityHata Yan\u0131t\u0131 Formatlama (ResponseEntity)<\/h4>\n
@ExceptionHandler<\/code> metotlar\u0131 genellikle ResponseEntity<\/code> d\u00f6ner. ResponseEntity<\/code>, HTTP yan\u0131t\u0131n\u0131n tamam\u0131n\u0131 (durum kodu, ba\u015fl\u0131klar ve g\u00f6vde) kontrol etmenizi sa\u011flar. Bu sayede, hata durumunda istemciye sadece bir mesaj de\u011fil, ayn\u0131 zamanda uygun bir HTTP durum kodu (\u00f6rne\u011fin, 404 Not Found, 400 Bad Request, 500 Internal Server Error) ve hatta \u00f6zel hata nesneleri g\u00f6nderebilirsiniz.<\/p>\n\u00d6zel \u0130stisna S\u0131n\u0131flar\u0131 Olu\u015fturma<\/h3>\n
Neden \u00d6zel \u0130stisnalara \u0130htiya\u00e7 Duyar\u0131z?<\/h4>\n
IllegalArgumentException<\/code>, IllegalStateException<\/code>) \u00e7o\u011fu zaman yeterli olsa da, uygulaman\u0131z\u0131n i\u015f kurallar\u0131na \u00f6zg\u00fc hatalar\u0131 ifade etmek i\u00e7in yetersiz kalabilirler. \u00d6rne\u011fin, \"Kullan\u0131c\u0131 bulunamad\u0131\" veya \"Yetersiz bakiye\" gibi durumlar i\u00e7in \u00f6zel istisnalar tan\u0131mlamak, hata mesajlar\u0131n\u0131 daha net hale getirir ve @ExceptionHandler<\/code> metotlar\u0131nda daha spesifik yakalamalar yapman\u0131z\u0131 sa\u011flar.<\/p>\nRuntimeException'dan T\u00fcretme<\/h4>\n
RuntimeException<\/code> s\u0131n\u0131f\u0131ndan t\u00fcretilen \u00f6zel istisnalar olu\u015fturulur. RuntimeException<\/code>'dan t\u00fcretilen istisnalar \"unchecked\" (i\u015faretlenmemi\u015f) istisnalard\u0131r, yani bunlar\u0131 f\u0131rlatan metotlar\u0131n throws<\/code> anahtar kelimesini kullanmas\u0131 gerekmez. Bu, kod karma\u015f\u0131kl\u0131\u011f\u0131n\u0131 azalt\u0131r.<\/p>\n\npublic class ResourceNotFoundException extends RuntimeException {\n public ResourceNotFoundException(String message) {\n super(message);\n }\n}\n\npublic class InsufficientBalanceException extends RuntimeException {\n public InsufficientBalanceException(String message) {\n super(message);\n }\n}\n<\/pre>\n\u00d6zel Hata Kodlar\u0131 ve Mesajlar\u0131<\/h4>\n
\npublic class CustomValidationException extends RuntimeException {\n private final String errorCode;\n\n public CustomValidationException(String message, String errorCode) {\n super(message);\n this.errorCode = errorCode;\n }\n\n public String getErrorCode() {\n return errorCode;\n }\n}\n<\/pre>\n@ControllerAdvice<\/code> i\u00e7inde yakalayarak, hata kodunu da i\u00e7eren zengin bir yan\u0131t olu\u015fturabilirsiniz.<\/p>\nHata Detaylar\u0131n\u0131 \u0130stemciye D\u00f6nme<\/h3>\n
Standart Hata Yan\u0131t\u0131 Yap\u0131s\u0131 (RFC 7807 Problem Details)<\/h4>\n
type<\/code>: Hata t\u00fcr\u00fcn\u00fc tan\u0131mlayan URI (iste\u011fe ba\u011fl\u0131).
\n* title<\/code>: \u0130nsan taraf\u0131ndan okunabilir, k\u0131sa bir \u00f6zet.
\n* status<\/code>: HTTP durum kodu.
\n* detail<\/code>: \u0130nsan taraf\u0131ndan okunabilir, hatan\u0131n spesifik detaylar\u0131.
\n* instance<\/code>: Hatan\u0131n meydana geldi\u011fi belirli \u00f6rnek i\u00e7in URI (iste\u011fe ba\u011fl\u0131).<\/p>\n\u00d6zel Hata Yan\u0131t\u0131 Nesneleri<\/h4>\n
\npublic class ErrorResponse {\n private int status;\n private String error;\n private String message;\n private String path;\n private long timestamp;\n\n \/\/ Constructor, getters, setters\n public ErrorResponse(int status, String error, String message, String path) {\n this.status = status;\n this.error = error;\n this.message = message;\n this.path = path;\n this.timestamp = System.currentTimeMillis();\n }\n\n \/\/ Getters...\n public int getStatus() { return status; }\n public String getError() { return error; }\n public String getMessage() { return message; }\n public String getPath() { return path; }\n public long getTimestamp() { return timestamp; }\n}\n<\/pre>\n@ExceptionHandler<\/code> metotlar\u0131n\u0131zda bu ErrorResponse<\/code> nesnesini kullanabilirsiniz:<\/p>\n\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.ResponseEntity;\nimport org.springframework.web.bind.annotation.ControllerAdvice;\nimport org.springframework.web.bind.annotation.ExceptionHandler;\nimport jakarta.servlet.http.HttpServletRequest;\n\n@RestControllerAdvice \/\/ RESTful servisler i\u00e7in daha uygun\npublic class GlobalExceptionHandler {\n\n @ExceptionHandler(ResourceNotFoundException.class)\n public ResponseEntityHata Mesajlar\u0131n\u0131 Yerelle\u015ftirme<\/h4>\n
MessageSource<\/code> aray\u00fcz\u00fcn\u00fc kullanarak hata mesajlar\u0131n\u0131 farkl\u0131 dillerde sunabilirsiniz. @ControllerAdvice<\/code> i\u00e7inde MessageSource<\/code>'u enjekte edip, istisna mesajlar\u0131n\u0131 bu kaynaktan alarak dinamik olarak \u00e7evirebilirsiniz.<\/p>\nVeri Do\u011frulama \u0130stisnalar\u0131n\u0131 Y\u00f6netme (@Valid\/@Validated)<\/h3>\n
@Valid<\/code> veya @Validated<\/code> anotasyonlar\u0131 ile gelen istek g\u00f6vdelerindeki (request body) verileri do\u011frulamak yayg\u0131n bir senaryodur. Bu do\u011frulama ba\u015far\u0131s\u0131z oldu\u011funda MethodArgumentNotValidException<\/code> istisnas\u0131 f\u0131rlat\u0131l\u0131r. Bu istisnay\u0131 k\u00fcresel olarak ele almak, API'nizin kullan\u0131c\u0131 giri\u015f hatalar\u0131na kar\u015f\u0131 sa\u011flam olmas\u0131n\u0131 sa\u011flar.<\/p>\nMethodArgumentNotValidException Yakalama<\/h4>\n
MethodArgumentNotValidException<\/code>, bir metot arg\u00fcman\u0131 @Valid<\/code> veya @Validated<\/code> ile i\u015faretlendi\u011finde ve do\u011frulama kurallar\u0131 ihlal edildi\u011finde f\u0131rlat\u0131l\u0131r. Bu istisnay\u0131 @ControllerAdvice<\/code> i\u00e7inde yakalayarak, do\u011frulama hatalar\u0131n\u0131 istemciye anla\u015f\u0131l\u0131r bir formatta d\u00f6nd\u00fcrebiliriz.<\/p>\n\nimport org.springframework.http.HttpStatus;\nimport org.springframework.http.ResponseEntity;\nimport org.springframework.validation.FieldError;\nimport org.springframework.web.bind.MethodArgumentNotValidException;\nimport org.springframework.web.bind.annotation.ExceptionHandler;\nimport org.springframework.web.bind.annotation.RestControllerAdvice;\nimport jakarta.servlet.http.HttpServletRequest;\n\nimport java.util.HashMap;\nimport java.util.Map;\n\n@RestControllerAdvice\npublic class GlobalValidationExceptionHandler {\n\n @ExceptionHandler(MethodArgumentNotValidException.class)\n public ResponseEntityMethodArgumentNotValidException<\/code> yakaland\u0131\u011f\u0131nda, t\u00fcm do\u011frulama hatalar\u0131 bir Map<\/code> i\u00e7ine toplan\u0131r ve alan ad\u0131 ile hata mesaj\u0131 e\u015fle\u015fmeleri olarak istemciye geri d\u00f6ner.<\/p>\nHata Mesajlar\u0131n\u0131 Anla\u015f\u0131l\u0131r Hale Getirme<\/h4>\n
\nimport jakarta.validation.constraints.Email;\nimport jakarta.validation.constraints.NotBlank;\nimport jakarta.validation.constraints.Size;\n\npublic class UserDto {\n @NotBlank(message = \"Kullan\u0131c\u0131 ad\u0131 bo\u015f olamaz\")\n @Size(min = 3, max = 20, message = \"Kullan\u0131c\u0131 ad\u0131 3 ile 20 karakter aras\u0131nda olmal\u0131d\u0131r\")\n private String username;\n\n @Email(message = \"Ge\u00e7erli bir e-posta adresi girin\")\n @NotBlank(message = \"E-posta bo\u015f olamaz\")\n private String email;\n\n \/\/ Getters and Setters\n}\n<\/pre>\nMethodArgumentNotValidException<\/code> yakaland\u0131\u011f\u0131nda, istemciye do\u011frudan bu \u00f6zelle\u015ftirilmi\u015f mesajlar d\u00f6necektir.<\/p>\nTek Bir Hata Yan\u0131t\u0131nda Birden Fazla Do\u011frulama Hatas\u0131<\/h4>\n
handleValidationExceptions<\/code> metodu, birden fazla do\u011frulama hatas\u0131n\u0131 tek bir JSON yan\u0131t\u0131nda d\u00f6nd\u00fcrerek istemcinin t\u00fcm hatalar\u0131 ayn\u0131 anda g\u00f6rmesini sa\u011flar. Bu, kullan\u0131c\u0131 deneyimini iyile\u015ftirir \u00e7\u00fcnk\u00fc kullan\u0131c\u0131 her bir hatay\u0131 d\u00fczeltmek i\u00e7in ayr\u0131 ayr\u0131 istek g\u00f6ndermek zorunda kalmaz.<\/p>\nSpring G\u00fcvenlik \u0130stisnalar\u0131 ve Di\u011fer \u00d6zel Durumlar<\/h3>\n
AccessDeniedException ve AuthenticationException<\/h4>\n
AuthenticationException<\/code>: Kullan\u0131c\u0131 kimlik do\u011frulama ba\u015far\u0131s\u0131z oldu\u011funda (\u00f6rn. yanl\u0131\u015f parola). Genellikle 401 Unauthorized durum kodu ile e\u015fle\u015fir.
\n* AccessDeniedException<\/code>: Kullan\u0131c\u0131n\u0131n belirli bir kayna\u011fa eri\u015fim yetkisi olmad\u0131\u011f\u0131nda f\u0131rlat\u0131l\u0131r. Genellikle 403 Forbidden durum kodu ile e\u015fle\u015fir.<\/p>\n@ControllerAdvice<\/code> i\u00e7inde yakalayarak, g\u00fcvenlik hatalar\u0131na \u00f6zel yan\u0131tlar verebilirsiniz. Ancak, Spring Security'nin kendi istisna i\u015fleme mekanizmalar\u0131 (\u00f6rne\u011fin AuthenticationEntryPoint<\/code> ve AccessDeniedHandler<\/code>) genellikle daha uygun bir yakla\u015f\u0131md\u0131r.<\/p>\nNoHandlerFoundException ve AsyncRequestTimeoutException<\/h4>\n
NoHandlerFoundException<\/code>: \u0130stemcinin istedi\u011fi bir URL i\u00e7in uygun bir kontrolc\u00fc metodu bulunamad\u0131\u011f\u0131nda f\u0131rlat\u0131l\u0131r (404 Not Found). Bu istisnay\u0131 yakalamak i\u00e7in spring.mvc.throw-exception-if-no-handler-found=true<\/code> ve spring.web.resources.add-mappings=false<\/code> \u00f6zelliklerini application.properties<\/code> dosyan\u0131zda etkinle\u015ftirmeniz gerekebilir.
\n* AsyncRequestTimeoutException<\/code>: Asenkron bir iste\u011fin zaman a\u015f\u0131m\u0131na u\u011framas\u0131 durumunda f\u0131rlat\u0131l\u0131r.<\/p>\nDi\u011fer S\u0131k Kar\u015f\u0131la\u015f\u0131lan \u0130stisnalar<\/h4>\n
\n\n
\n \n\u0130stisna T\u00fcr\u00fc<\/th>\n Tipik HTTP Durum Kodu<\/th>\n A\u00e7\u0131klama<\/th>\n<\/tr>\n<\/thead>\n \n ResourceNotFoundException<\/code> (\u00d6zel)<\/td>\n404 Not Found<\/td>\n \u0130stenen kaynak bulunamad\u0131.<\/td>\n<\/tr>\n \n IllegalArgumentException<\/code><\/td>\n400 Bad Request<\/td>\n Metoda ge\u00e7ersiz bir arg\u00fcman verildi.<\/td>\n<\/tr>\n \n IllegalStateException<\/code><\/td>\n400 Bad Request \/ 500 Internal Server Error<\/td>\n Nesne ge\u00e7ersiz bir durumda.<\/td>\n<\/tr>\n \n DataIntegrityViolationException<\/code><\/td>\n409 Conflict \/ 400 Bad Request<\/td>\n Veritaban\u0131 b\u00fct\u00fcnl\u00fc\u011f\u00fc ihlali (\u00f6rn. benzersizlik k\u0131s\u0131tlamas\u0131).<\/td>\n<\/tr>\n \n MethodArgumentNotValidException<\/code><\/td>\n400 Bad Request<\/td>\n \u0130stek g\u00f6vdesindeki veri do\u011frulama hatas\u0131.<\/td>\n<\/tr>\n \n HttpRequestMethodNotSupportedException<\/code><\/td>\n405 Method Not Allowed<\/td>\n \u0130stek i\u00e7in HTTP metodu desteklenmiyor.<\/td>\n<\/tr>\n \n HttpMediaTypeNotSupportedException<\/code><\/td>\n415 Unsupported Media Type<\/td>\n \u0130stek g\u00f6vdesi medya t\u00fcr\u00fc desteklenmiyor.<\/td>\n<\/tr>\n \n NoHandlerFoundException<\/code><\/td>\n404 Not Found<\/td>\n \u0130stenen URL i\u00e7in bir kontrolc\u00fc bulunamad\u0131.<\/td>\n<\/tr>\n \n AccessDeniedException<\/code><\/td>\n403 Forbidden<\/td>\n Kullan\u0131c\u0131n\u0131n eri\u015fim yetkisi yok.<\/td>\n<\/tr>\n \n AuthenticationException<\/code><\/td>\n401 Unauthorized<\/td>\n Kimlik do\u011frulama ba\u015far\u0131s\u0131z oldu.<\/td>\n<\/tr>\n \n Exception<\/code> (Genel)<\/td>\n500 Internal Server Error<\/td>\n Beklenmedik genel bir hata.<\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n Sonu\u00e7 B\u00f6l\u00fcm\u00fc<\/h3>\n
@ControllerAdvice<\/code> ve @ExceptionHandler<\/code> mekanizmalar\u0131 sayesinde, uygulaman\u0131zdaki t\u00fcm istisnalar\u0131 merkezi bir noktadan ele alabilir, kod tekrar\u0131n\u0131 \u00f6nleyebilir ve tutarl\u0131 hata yan\u0131tlar\u0131 \u00fcretebilirsiniz. \u00d6zel istisna s\u0131n\u0131flar\u0131 olu\u015fturmak, hata yan\u0131tlar\u0131n\u0131 RFC 7807 gibi standartlara uygun hale getirmek ve veri do\u011frulama hatalar\u0131n\u0131 detayl\u0131 bir \u015fekilde sunmak, uygulaman\u0131z\u0131n hem geli\u015ftiriciler hem de son kullan\u0131c\u0131lar i\u00e7in daha anla\u015f\u0131l\u0131r ve y\u00f6netilebilir olmas\u0131n\u0131 sa\u011flar. Unutmay\u0131n, iyi bir istisna y\u00f6netimi stratejisi sadece hatalar\u0131 gizlemekle kalmaz, ayn\u0131 zamanda uygulaman\u0131z\u0131n g\u00fcvenilirli\u011fini ve kullan\u0131c\u0131 deneyimini de \u00f6nemli \u00f6l\u00e7\u00fcde art\u0131r\u0131r.<\/p>\nSSS (S\u0131k Sorulan Sorular)<\/h3>\n
@ControllerAdvice ile @RestControllerAdvice Aras\u0131ndaki Fark Nedir?<\/h4>\n
@ControllerAdvice<\/code>, @Controller<\/code> anotasyonlu s\u0131n\u0131flar i\u00e7in genel istisna y\u00f6netimi, veri ba\u011flama veya model nitelikleri gibi i\u015flemleri merkezi olarak sa\u011flamak i\u00e7in kullan\u0131l\u0131r. @RestControllerAdvice<\/code> ise @ControllerAdvice<\/code>'\u0131n \u00f6zel bir versiyonudur ve otomatik olarak @ResponseBody<\/code> davran\u0131\u015f\u0131n\u0131 i\u00e7erir. Bu, metotlar\u0131n d\u00f6nd\u00fcrd\u00fc\u011f\u00fc de\u011ferlerin do\u011frudan HTTP yan\u0131t g\u00f6vdesine d\u00f6n\u00fc\u015ft\u00fcr\u00fclece\u011fi anlam\u0131na gelir, bu da RESTful API'ler i\u00e7in idealdir. \u00c7o\u011fu RESTful Spring Boot uygulamas\u0131 i\u00e7in @RestControllerAdvice<\/code> kullanmak daha uygun olacakt\u0131r.<\/p>\n\u0130stisna Detaylar\u0131n\u0131 Loglamak Neden \u00d6nemlidir?<\/h4>\n
Hata Mesajlar\u0131n\u0131 Kullan\u0131c\u0131lara Nas\u0131l G\u00f6stermeliyim?<\/h4>\n
Farkl\u0131 Ortamlar \u0130\u00e7in (Dev\/Prod) Farkl\u0131 Hata Yan\u0131tlar\u0131 Nas\u0131l Y\u00f6netilir?<\/h4>\n
@ControllerAdvice<\/code> i\u00e7indeki @ExceptionHandler<\/code> metotlar\u0131n\u0131zda Spring'in Environment<\/code> nesnesini enjekte edebilir ve mevcut profilin (\u00f6rne\u011fin \"dev\" veya \"prod\") ne oldu\u011funa g\u00f6re farkl\u0131 yan\u0131tlar olu\u015fturabilirsiniz. Alternatif olarak, application.properties<\/code> veya application-prod.properties<\/code> gibi dosyalarda farkl\u0131 hata ay\u0131klama seviyeleri tan\u0131mlayabilirsiniz.<\/p>\n","protected":false},"excerpt":{"rendered":"Spring Boot’ta K\u00fcresel \u0130stisna Y\u00f6netimi: En \u0130yi Uygulamalar\nModern web uygulamalar\u0131nda istisna y\u00f6netimi, kullan\u0131c\u0131 deneyimini do\u011frudan etkileyen ve…","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"csco_page_header_type":"","csco_page_load_nextpost":"","csco_page_subscribe_form":"","csco_page_contact_form":"","footnotes":""},"categories":[1],"tags":[],"class_list":{"0":"post-36664","1":"post","2":"type-post","3":"status-publish","4":"format-standard","6":"category-genel","7":"cs-entry","8":"cs-video-wrap"},"yoast_head":"\n