Si i trajton exception-et globalisht me @ControllerAdvice?

Question

IT Interview Practice · Accepted Answer

Në vend që të mbështillni çdo metodë controller-i në try/catch, Spring ju lejon ta centralizoni trajtimin e error-eve në një klasë të anotuar `@ControllerAdvice` (ose `@RestControllerAdvice`). Metodat e shënuara `@ExceptionHandler` kapin exception-et e hedhura kudo në controller-ët tuaj dhe i kthejnë ato në përgjigje HTTP konsistente.

## Një handler global

```java
@RestControllerAdvice // = @ControllerAdvice + @ResponseBody
public class GlobalExceptionHandler {

// Kap këtë exception nga ÇDO controller dhe kthen 404.
    @ExceptionHandler(EntityNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public ApiError notFound(EntityNotFoundException ex) {
        return new ApiError("NOT_FOUND", ex.getMessage());
    }

// Dështimet e validimit (@Valid) hedhin këtë — kthe error-et e fushave në 400.
    @ExceptionHandler(MethodArgumentNotValidException.class)
    @ResponseStatus(HttpStatus.BAD_REQUEST)
    public ApiError invalid(MethodArgumentNotValidException ex) {
        String msg = ex.getBindingResult().getFieldErrors().stream()
            .map(e -> e.getField() + " " + e.getDefaultMessage())
            .collect(Collectors.joining(", "));
        return new ApiError("VALIDATION", msg);
    }
}
```

Çdo controller tani mund thjesht të `throw new EntityNotFoundException(...)` dhe t'i besojë advice-it që ta formësojë përgjigjen.

## Opsioni modern: ProblemDetail

Spring 6 / Boot 3 vijnë me `ProblemDetail` të RFC 9457, një trup error-i i standardizuar:

```java
@ExceptionHandler(PaymentDeclinedException.class)
public ProblemDetail declined(PaymentDeclinedException ex) {
    var pd = ProblemDetail.forStatusAndDetail(HttpStatus.PAYMENT_REQUIRED, ex.getMessage());
    pd.setTitle("Payment declined");
    return pd; // serializohet si application/problem+json
}
```

## Pse ka rëndësi

Përgjigjet e error-eve konsistente e të lexueshme nga makina janë ato që ndajnë një API profesional nga një që nxjerr stack trace. Intervistuesit duan të shohin se e centralizoni trajtimin (DRY), i mapuni exception-et te status codes *të sakta*, dhe s'i ekspozoni kurrë detajet e brendshme te klientët. Përmendja e `ProblemDetail` tregon se jeni në hap me Boot 3.

Një handler global

Opsioni modern: ProblemDetail

Pse ka rëndësi

Pyetje të ngjashme