Miten poikkeuksia käsitellään globaalisti @ControllerAdvicella?

Question

IT Interview Practice · Accepted Answer

Sen sijaan että kietoisit jokaisen controller-metodin try/catchiin, Spring antaa keskittää virheenkäsittelyn yhteen luokkaan, joka on annotoitu `@ControllerAdvice` (tai `@RestControllerAdvice`). `@ExceptionHandler`illa merkityt metodit nappaavat poikkeukset, jotka heitetään missä tahansa controllereissasi, ja muuttavat ne johdonmukaisiksi HTTP-vastauksiksi.

## Globaali handler

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

// Catches this exception from ANY controller and returns 404.
    @ExceptionHandler(EntityNotFoundException.class)
    @ResponseStatus(HttpStatus.NOT_FOUND)
    public ApiError notFound(EntityNotFoundException ex) {
        return new ApiError("NOT_FOUND", ex.getMessage());
    }

// Validation failures (@Valid) throw this — turn field errors into 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);
    }
}
```

Mikä tahansa controller voi nyt vain heittää `throw new EntityNotFoundException(...)` ja luottaa siihen, että advice muotoilee vastauksen.

## Moderni vaihtoehto: ProblemDetail

Spring 6 / Boot 3 tuovat RFC 9457 `ProblemDetail`in, standardoidun virherungon:

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

## Miksi se on tärkeää

Johdonmukaiset, koneluettavat virhevastaukset erottavat ammattimaisen API:n sellaisesta, joka vuotaa stack traceja. Haastattelijat haluavat nähdä, että keskität käsittelyn (DRY), kartoitat poikkeukset *oikeisiin* status-koodeihin etkä koskaan paljasta sisäisiä yksityiskohtia clienteille. `ProblemDetail`in mainitseminen osoittaa, että olet ajan tasalla Boot 3:n kanssa.

Globaali handler

Moderni vaihtoehto: ProblemDetail

Miksi se on tärkeää

Aiheeseen liittyvät kysymykset