Kako globalno obravnavaš izjeme z @ControllerAdvice?

Question

IT Interview Practice · Accepted Answer

Namesto da vsako metodo kontrolerja oviješ v try/catch, Spring omogoča, da obravnavo napak centraliziraš v enem razredu, anotiranem z `@ControllerAdvice` (ali `@RestControllerAdvice`). Metode, označene z `@ExceptionHandler`, ujamejo izjeme, vržene kjerkoli v tvojih kontrolerjih, in jih spremenijo v dosledne HTTP odgovore.

## Globalni obravnavalec

```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);
    }
}
```

Vsak kontroler lahko zdaj preprosto `throw new EntityNotFoundException(...)` in zaupa, da bo advice oblikoval odgovor.

## Sodobna možnost: ProblemDetail

Spring 6 / Boot 3 prinašata RFC 9457 `ProblemDetail`, standardizirano telo napake:

```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
}
```

## Zakaj je to pomembno

Dosledni, strojno berljivi odgovori na napake so tisto, kar loči profesionalen API od takega, ki pušča sledi sklada. Izpraševalci želijo videti, da obravnavo centraliziraš (DRY), izjeme preslikaš na *pravo* statusno kodo in nikoli ne izpostaviš notranjih podrobnosti odjemalcem. Omemba `ProblemDetail` kaže, da si na tekočem z Boot 3.

Globalni obravnavalec

Sodobna možnost: ProblemDetail

Zakaj je to pomembno

Povezana vprašanja