Endpoint REST w Spring Boot to metoda w @RestController, zmapowana na czasownik HTTP i ścieżkę. @RestController = @Controller + @ResponseBody, więc zwracane wartości są serializowane wprost do treści odpowiedzi (JSON przez Jackson), zamiast być rozwiązywane do widoku.
@RestController
@RequestMapping("/api/users") // base path for every method below
public class UserController {
private final UserService service;
public UserController(UserService service) { this.service = service; }
@GetMapping("/{id}") // GET /api/users/42
public UserDto get(@PathVariable Long id) { // bind {id} from the URL
return service.findById(id); // returned object -> JSON
}
@PostMapping // POST /api/users
@ResponseStatus(HttpStatus.CREATED) // 201 instead of 200
public UserDto create(@Valid @RequestBody UserDto body) { // JSON -> object
return service.create(body);
}
@GetMapping // GET /api/users?role=admin
public List<UserDto> list(@RequestParam(required = false) String role) {
return service.findByRole(role);
}
}
Kluczowe adnotacje: @PathVariable wyciąga wartość ze ścieżki, @RequestParam czyta parametr query-string, a @RequestBody deserializuje payload JSON. Dodanie @Valid uruchamia Bean Validation (@NotNull, @Email…) na przychodzącym DTO, zanim uruchomi się twoja metoda.
@GetMapping("/{id}")
public ResponseEntity<UserDto> get(@PathVariable Long id) {
return service.find(id)
.map(ResponseEntity::ok) // 200 + body
.orElse(ResponseEntity.notFound().build()); // 404, no body
}
To chleb powszedni pracy backendowej, więc rekruterzy oczekują biegłości. Mocne odpowiedzi wspominają o używaniu DTO zamiast ujawniania encji JPA, walidacji wejścia przez @Valid oraz zwracaniu poprawnych kodów statusu z ResponseEntity — to różnica między zabawkowym endpointem a prawdziwym API.
Biblioteka pytań rekrutacyjnych IT ze szczegółowymi odpowiedziami — od Juniora do Seniora.
Wesprzyj