Kun suunnittelimme uudelleen yritysalustan, opimme, että tärkein asia, joka teki asiakkaat tyytymättömiksi, ei ollut suorituskyky tai käyttöliittymä; se oli virheitä, joita ei korjattu, jotka tuhosivat prosesseja. Spring Bootissa tai vastaavissa malleissa muissa kehyksissä varmistetaan, että järjestelmät käyttäytyvät odotetulla tavalla, kun ne ovat stressin alla. @ControllerAdvice Why This Matters Kun rakennat REST API:t , kohtaat nopeasti tämän ongelman: Spring Boot “ ” How do I handle errors neatly without writing repetitive try-catch blocks everywhere? Kuvittele, että sinulla Jokainen voi epäonnistua a virheellinen syöttö tai puuttuva resurssi. Sen sijaan, että palautettaisiin sotkuisia pinoja, haluat . 50+ endpoints Pointer Pointer poikkeus consistent, meaningful, and client-friendly error responses Tämä on missä tulee - se keskittää kaikki virheiden käsittelyn yhteen paikkaan. Katsotaanpa sitten Tätä kehitetään askel askeleelta reaalimaailman esimerkin avulla. @ControllerAdvice how Use Case — User Management REST API Me luomme a Tämä tukee: simple User API 
 
 
 
 
 
 Fetching users 
 
 Creating users 
 
 
 Simulating failures for testing Our goal → build a   that returns clean JSON responses. unified global error-handling layer Step 1: Project Setup Dependencies (Maven): <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-web</artifactId>
    </dependency>
    
    <dependency>
      <groupId>org.springframework.boot</groupId>
      <artifactId>spring-boot-starter-validation</artifactId>
    </dependency>
 This brings in web + validation support. Then create your main app: @SpringBootApplication
public class ExceptionHandlerDemoApplication {
    public static void main(String[] args) {
        SpringApplication.run(ExceptionHandlerDemoApplication.class, args);
    }
}
 Step 2: Define the Entity — User.java @Data
@AllArgsConstructor
@NoArgsConstructor
public class User {
    private int id;
    @NotBlank(message = "Name cannot be blank")
    private String name;
    @Min(value = 18, message = "Age must be at least 18")
    private int age;
}
 • Miksi: ** Lisäämme yksinkertaisia validointeja, jotta Spring voi laukaista menetelmäargumentin Ei pätevää poikkeusta automaattisesti, kun syöttö on pätemätön. Step 3: Custom Exception for Missing Data public class ResourceNotFoundException extends RuntimeException {
    public ResourceNotFoundException(String message) {
        super(message);
    }
}
public class InvalidRequestException extends RuntimeException {
    public InvalidRequestException(String message) {
        super(message);
    }
}
 • Miksi: **Esittele ”käyttäjä ei löydy” tilanne puhtaasti yleisten poikkeusten sijaan. Step 4: Build the Controller @RestController
@RequestMapping("/api/users")
public class UserController {
    // Simple GET that throws ResourceNotFoundException for id > 100
    @GetMapping("/{id}")
    public String getUser(@PathVariable("id") @Min(1) Integer id) {
        if (id > 100) {
            throw new ResourceNotFoundException("User with id " + id + " not found");
        }
        return "User-" + id;
    }
    // Create user example to demonstrate validation
    public static record CreateUserRequest(
            @NotBlank(message = "name is required") String name,
            @Min(value = 18, message = "age must be >= 18") int age) {}
    @PostMapping
    @ResponseStatus(HttpStatus.CREATED)
    public String createUser(@RequestBody @Valid CreateUserRequest body) {
        if ("bad".equalsIgnoreCase(body.name())) {
            throw new InvalidRequestException("Name 'bad' is not allowed");
        }
        return "created:" + body.name();
    }
    // Endpoint to force a server error for demo
    @GetMapping("/boom")
    public void boom() {
        throw new IllegalStateException("simulated server error");
    }
}
 • Miksi: ** Luomme realistisia skenaarioita – ei löydy, vahvistusvirheitä ja suoritusajan virheitä – joita globaali käsittelijämme hallitsee. Step 5: Create a Standard Error Model @Data
@AllArgsConstructor
@NoArgsConstructor
public class ErrorResponse {
    private OffsetDateTime timestamp;
    private int status;
    private String error;
    private String message;
    private String path;
    private List<FieldError> fieldErrors;}
 • Miksi: **Kaikkien API:ien pitäisi palauttaa virheitä samassa rakenteessa – tämä parantaa tuotannon seurantaa ja vianmääritystä. Step 6: Implement @ControllerAdvice (Global Handler) @ControllerAdvice
public class GlobalExceptionHandler {
    private final Logger log = LoggerFactory.getLogger(GlobalExceptionHandler.class);
    // Handle custom validation exceptions
    @ExceptionHandler(InvalidRequestException.class)
    public ResponseEntity<ErrorResponse> handleInvalidRequest(InvalidRequestException ex, HttpServletRequest req) {
        log.debug("InvalidRequestException: {}", ex.getMessage());
        ErrorResponse body = new ErrorResponse(OffsetDateTime.now(), HttpStatus.BAD_REQUEST.value(),
                HttpStatus.BAD_REQUEST.getReasonPhrase(), ex.getMessage(), req.getRequestURI());
        return ResponseEntity.status(HttpStatus.BAD_REQUEST).body(body);
    }
    // Resource not found -> 404
    @ExceptionHandler(ResourceNotFoundException.class)
    public ResponseEntity<ErrorResponse> handleNotFound(ResourceNotFoundException ex, HttpServletRequest req) {
        log.debug("ResourceNotFoundException: {}", ex.getMessage());
        ErrorResponse body = new ErrorResponse(OffsetDateTime.now(), HttpStatus.NOT_FOUND.value(),
                HttpStatus.NOT_FOUND.getReasonPhrase(), ex.getMessage(), req.getRequestURI());
        return ResponseEntity.status(HttpStatus.NOT_FOUND).body(body);
    }
    // Validation errors from @Valid on request bodies
    @ExceptionHandler(MethodArgumentNotValidException.class)
    public ResponseEntity<ErrorResponse> handleValidation(MethodArgumentNotValidException ex, HttpServletRequest req) {
        log.debug("Validation failed: {}", ex.getMessage());
        List<ErrorResponse.FieldError> fieldErrors = ex.getBindingResult().getFieldErrors().stream()
                .map(fe -> new ErrorResponse.FieldError(fe.getField(), fe.getRejectedValue(), fe.getDefaultMessage()))
                .collect(Collectors.toList());
        ErrorResponse body = new ErrorResponse(OffsetDateTime.now(), HttpStatus.BAD_REQUEST.value(),
                HttpStatus.BAD_REQUEST.getReasonPhrase(), "Validation failed", req.getRequestURI());
        body.setFieldErrors(fieldErrors);
        return ResponseEntity.badRequest().body(body);
    }
    // Type mismatch for method args (?id=abc)
    @ExceptionHandler(MethodArgumentTypeMismatchException.class)
    public ResponseEntity<ErrorResponse> handleTypeMismatch(MethodArgumentTypeMismatchException ex, HttpServletRequest req) {
        log.debug("Type mismatch: {}", ex.getMessage());
        ErrorResponse body = new ErrorResponse(OffsetDateTime.now(), HttpStatus.BAD_REQUEST.value(),
                HttpStatus.BAD_REQUEST.getReasonPhrase(), ex.getMessage(), req.getRequestURI());
        return ResponseEntity.badRequest().body(body);
    }
    // No handler found (404 for unmatched endpoints)
    @ExceptionHandler(NoHandlerFoundException.class)
    public ResponseEntity<ErrorResponse> handleNoHandler(NoHandlerFoundException ex, HttpServletRequest req) {
        log.debug("NoHandlerFound: {} {}", ex.getHttpMethod(), ex.getRequestURL());
        ErrorResponse body = new ErrorResponse(OffsetDateTime.now(), HttpStatus.NOT_FOUND.value(),
                HttpStatus.NOT_FOUND.getReasonPhrase(), "Endpoint not found", req.getRequestURL().toString());
        return ResponseEntity.status(HttpStatus.NOT_FOUND).body(body);
    }
    // Generic fallback
    @ExceptionHandler(Exception.class)
    public ResponseEntity<ErrorResponse> handleAll(Exception ex, HttpServletRequest req) {
        log.error("Unhandled exception: ", ex);
        ErrorResponse body = new ErrorResponse(OffsetDateTime.now(), HttpStatus.INTERNAL_SERVER_ERROR.value(),
                HttpStatus.INTERNAL_SERVER_ERROR.getReasonPhrase(), "An internal error occurred", req.getRequestURI());
        return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body(body);
    }
}
 Why: 
 
 
 
 @ControllerAdvice → Tekee siitä globaalin kaikissa ohjaimissa. @ExceptionHandler → Tallentaa tiettyjä poikkeustyyppejä. buildResponse() -apuohjelma pitää koodin kuivana ja puhtaana. Step 7: Test Scenarios   GET /api/users/1 Vastauskoodi: 200 - Menestys * ja * ja GET /api/users/999 Vastauskoodi: 404 Resource Not Found * ja * ja Validation Error POST / API / Käyttäjät {"name":"", "age": 15} Response: * ja * ja Unexpected Error GET /api/käyttäjät / boom * ja * ja Why This Approach Works in Real Projects 
 
 
 
 
 
 
 
 
 
 Problem 
 Solution 
 
 
 
 Too many try-catch blocks 
 Centralized handling with @ControllerAdvice 
 
 
 
 Inconsistent responses 
 Unified ErrorResponse structure 
 
 
 
 Hard to debug 
 Standardized messages with timestamps and paths 
 
 
 
 Client confusion 
 Clear, meaningful messages for each failure type Liian monta try-catch -blokkia Keskitetty käsittely @ControllerAdvice Epäjohdonmukaisia vastauksia Yhtenäinen ErrorResponse -rakenne Vaikea tehdä debug Standardisoidut viestit aikaleimilla ja reiteillä Asiakkaan hämmennys Selkeät, merkitykselliset viestit jokaiselle epäonnistumistyylille Real-World Usage Scenarios 
 
 
 
 
 Pankki-API: Varmista, että vahvistusvirheet (kuten virheellinen tilinumero) eivät häiritse palvelua. Sähköinen kaupankäynti: Käsittele tuotteiden löytämättömiä tai maksuvirheitä kohteliaasti. Data Microservices: Palauttaa jäsenneltyjä viestejä, kun syöttötiedot eivät validoi. API Gateway: Johdonmukaiset vastaukset useissa mikroservikoissa. Final Thoughts Yhdistämällä @ControllerAdvice, @ExceptionHandler ja yksinkertainen Error Response -malli saat: 
 
 
 
 Puhdas koodi Johdonmukainen API-kokemus Helpompi asentaa tuotantoon Se on yksi yksinkertaisimmista mutta tehokkaimmista design-malleista Spring Boot -kehityksessä.

This story contains AI-generated text. The author has used AI either for research, to generate outlines, or write the text itself. 

Walkthroughs, tutorials, guides, and tips. This story will teach you how to do something new or how to do something better.

Read My Stories

Tämä ääni on tuotettu tarinan alkuperäisellä kielellä!

Luotettavien API-järjestelmien suunnittelu: Poikkeuksen käsittely Spring Bootin ohjaimella

About Author

KOMMENTIT

RIPUTA TAGSIA

TÄMÄ ARTIKKELI ESITETTIIN

Related Stories

Web 2.5: HackerNoon's Vision for a New Wave Internet

2.5 Reasons to Watch HackerNoon's Self-made Documentary

Dear Public Relations Manager, Here’s How to Use HackerNoon for Your Clients

How Apex Fusion Achieved FINMA Qualification Without Compromising Decentralization

Web 2.5: HackerNoon's Vision for a New Wave Internet

2.5 Reasons to Watch HackerNoon's Self-made Documentary

Dear Public Relations Manager, Here’s How to Use HackerNoon for Your Clients

How Apex Fusion Achieved FINMA Qualification Without Compromising Decentralization

Light-Mode

Classic

Newspaper

Minty

Dark-Mode

Neon Noir

Minty

HN StartUps