REST APIs — Controller & Endpoints

REST APIs mit Spring Boot

Spring Boot macht REST trivial: eine Annotation, eine Methode, fertig.

Lektion 11: @RestController

@RestController = @Controller + @ResponseBody. Jeder Rückgabewert wird direkt als JSON serialisiert (via Jackson).

@RestController
@RequestMapping("/api/products")
public class ProductController {
    @GetMapping
    public List<Product> all() { return service.findAll(); }
}

Lektion 12: HTTP-Methoden

Lektion 13: Path-Variablen & Request-Parameter

@GetMapping("/{id}")
public Product byId(@PathVariable Long id) { return service.findById(id); }

@GetMapping("/search")
public List<Product> search(@RequestParam String q) { return service.search(q); }

Lektion 14: Request-Body & DTOs

record ProductDto(String name, double price) {}

@PostMapping
@ResponseStatus(HttpStatus.CREATED)
public ProductDto create(@Valid @RequestBody ProductDto dto) {
    return service.create(dto);
}

record DTos sind immutable, kompakt und automatisch JSON-serialisierbar.

Lektion 15: Status-Codes & Content Negotiation

@PostMapping
public ResponseEntity<ProductDto> create(@Valid @RequestBody ProductDto dto) {
    ProductDto saved = service.create(dto);
    return ResponseEntity.created(URI.create("/api/products/" + saved.id())).body(saved);
}