როგორ ამუშავებ გამონაკლისებს გლობალურად @ControllerAdvice-ით?

Question

IT Interview Practice · Accepted Answer

იმის ნაცვლად, რომ ყოველი კონტროლერის მეთოდი try/catch-ში გახვიო, Spring საშუალებას გაძლევს, შეცდომების დამუშავება ერთ კლასში მოაქციო, რომელიც `@ControllerAdvice`-ით (ან `@RestControllerAdvice`-ით) არის annotate-ებული. `@ExceptionHandler`-ით მონიშნული მეთოდები იჭერენ გამონაკლისებს, რომლებიც კონტროლერებში სადმე გადაიგდება, და მათ თანმიმდევრულ HTTP პასუხებად აქცევენ.

## გლობალური 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);
    }
}
```

ნებისმიერ კონტროლერს ახლა უბრალოდ `throw new EntityNotFoundException(...)` შეუძლია და ენდობა advice-ს, რომ პასუხს ის მოაწესრიგებს.

## თანამედროვე ვარიანტი: ProblemDetail

Spring 6 / Boot 3 მოაქვთ RFC 9457 `ProblemDetail`, სტანდარტიზებული შეცდომის სხეული:

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

## რატომ არის ეს მნიშვნელოვანი

თანმიმდევრული, მანქანურად წასაკითხი შეცდომის პასუხები არის ის, რაც პროფესიონალურ API-ს განასხვავებს იმისგან, რომელიც stack trace-ებს აჟონებს. ინტერვიუერებს სურთ დაინახონ, რომ დამუშავებას აცენტრალებ (DRY), გამონაკლისებს *სწორ* სტატუს-კოდებზე ასახავ და შიდა დეტალებს კლიენტებს არასოდეს უჩენ. `ProblemDetail`-ის ხსენება აჩვენებს, რომ Boot 3-ის კურსში ხარ.

გლობალური handler

თანამედროვე ვარიანტი: ProblemDetail

რატომ არის ეს მნიშვნელოვანი

დაკავშირებული კითხვები