jak zrobic kontroler w spring
- User
jak zrobic kontroler w spring
Assistant
Świetne pytanie! W Springu kontroler (ang. Controller) to klasa odpowiedzialna za obsługę żądań HTTP przychodzących do Twojej aplikacji. Kontroler przyjmuje żądanie, wywołuje odpowiednią logikę biznesową (często za pomocą serwisów) i zwraca odpowiedź do klienta. Poniżej znajdziesz kroki, jak stworzyć prosty kontroler w Spring Boot (najpopularniejsza odmiana Springa obecnie).
Krok 1: Przygotuj środowisko
Upewnij się, że:
- Masz zainstalowane JDK (przynajmniej wersja 11).
- Zainstalowany jest Maven lub Gradle (w przykładach użyję Mavena).
- Ściągnąłeś/wygenerowałeś projekt Spring Boot (np. ze strony Spring Initializr).
- Wybierz:
- Project: Maven Project
- Language: Java
- Spring Boot wersja stabilna (np. 3.x)
- Project Metadata: wypełnij wedle uznania (Group, Artifact itp.)
- Dependencies: Dodaj Spring Web (to wystarczy, aby zacząć zabawę z kontrolerami).
- Wybierz:
Krok 2: Stwórz kontroler
W pakiecie głównym Twojego projektu (np.
com.example.mojprojekt) utwórz nowy pakiet o nazwiecontroller(lubwebalborest, w zależności od Twojej konwencji).W pakiecie
controllerstwórz nową klasę Java, np.HelloWorldController.java:package com.example.mojprojekt.controller; import org.springframework.web.bind.annotation.GetMapping; import org.springframework.web.bind.annotation.RestController; @RestController // <--- To oznacza, że ta klasa jest kontrolerem REST public class HelloWorldController { @GetMapping("/hello") // <--- Adnotacja mapująca żądanie GET na metodę public String sayHello() { return "Witaj, świecie Springa!"; } }Wyjaśnienie adnotacji:
@RestController:- Oznacza, że klasa jest kontrolerem, w którym każda metoda zwraca dane bezpośrednio w odpowiedzi (domyślnie w formacie JSON).
- To połączenie
@Controller+@ResponseBodyna poziomie klasy.
@GetMapping("/hello"):- Mapuje HTTP GET /hello na metodę
sayHello(). - Możesz użyć też
@RequestMapping(method = RequestMethod.GET, value = "/hello"), ale@GetMappingjest krótsze.
- Mapuje HTTP GET /hello na metodę
Krok 3: Uruchom aplikację
- Otwórz główną klasę projektu (np.
MojprojektApplication.java, wygenerowaną przez Spring Initializr). - Uruchom metodę
mainw tej klasie (adnotacja@SpringBootApplicationtam znajduje się):
package com.example.mojprojekt; import org.springframework.boot.SpringApplication; import org.springframework.boot.autoconfigure.SpringBootApplication; @SpringBootApplication public class MojprojektApplication { public static void main(String[] args) { SpringApplication.run(MojprojektApplication.class, args); } }Krok 4: Sprawdź efekt
- Aplikacja startuje na domyślnym porcie 8080.
- Otwórz przeglądarkę lub Postman i wpisz adres:
http://localhost:8080/hello - Powinieneś zobaczyć odpowiedź: "Witaj, świecie Springa!"
Co się stało?
- Spring skanuje pakiety (bo główna klasa
MojprojektApplicationma@SpringBootApplication, które "w środku" zawiera@ComponentScan). - Znalazł bean oznaczony
@RestController. - Zmapował
/hellona metodęsayHello(). - Gdy przyszło żądanie HTTP GET, Spring wywołał Twoją metodę i odesłał
returnjako body odpowiedzi HTTP.
Przykład bardziej skomplikowany: CRUD dla encji
BookTeraz wyobraźmy sobie, że chcesz zrobić kontroler REST dla encji
Book(książka). Będą operacje:GET /books,GET /books/{id},POST /books,PUT /books/{id},DELETE /books/{id}.Krok 1: Dodaj encję
BookUtwórz pakiet
modeli dodaj:package com.example.mojprojekt.model; public class Book { private Long id; private String title; private String author; // Konstruktory, gettery, settery public Book() {} public Book(Long id, String title, String author) { this.id = id; this.title = title; this.author = author; } // Gettery i settery public Long getId() { return id; } public void setId(Long id) { this.id = id; } public String getTitle() { return title; } public void setTitle(String title) { this.title = title; } public String getAuthor() { return author; } public void setAuthor(String author) { this.author = author; } }Krok 2: Stwórz prosty serwis (logika biznesowa)
Pakiet
service:package com.example.mojprojekt.service; import com.example.mojprojekt.model.Book; import org.springframework.stereotype.Service; import java.util.ArrayList; import java.util.List; import java.util.Optional; import java.util.concurrent.atomic.AtomicLong; @Service public class BookService { private final List<Book> books = new ArrayList<>(); private final AtomicLong counter = new AtomicLong(1); public BookService() { books.add(new Book(counter.getAndIncrement(), "Pan Tadeusz", "Adam Mickiewicz")); books.add(new Book(counter.getAndIncrement(), "Lalka", "Bolesław Prus")); } public List<Book> findAll() { return books; } public Optional<Book> findById(Long id) { return books.stream().filter(b -> b.getId().equals(id)).findFirst(); } public Book save(Book book) { if (book.getId() == null) { book.setId(counter.getAndIncrement()); books.add(book); } else { books.removeIf(b -> b.getId().equals(book.getId())); books.add(book); } return book; } public void deleteById(Long id) { books.removeIf(b -> b.getId().equals(id)); } }Krok 3: Kontroler
BookControllerTeraz w pakiecie
controllerstwórz:package com.example.mojprojekt.controller; import com.example.mojprojekt.model.Book; import com.example.mojprojekt.service.BookService; import org.springframework.beans.factory.annotation.Autowired; import org.springframework.http.HttpStatus; import org.springframework.http.ResponseEntity; import org.springframework.web.bind.annotation.*; import java.util.List; @RestController @RequestMapping("/books") // Wspólny prefix URL dla wszystkich metod public class BookController { private final BookService bookService; @Autowired // Wstrzykiwanie zależności public BookController(BookService bookService) { this.bookService = bookService; } @GetMapping public List<Book> getAllBooks() { return bookService.findAll(); } @GetMapping("/{id}") public ResponseEntity<Book> getBookById(@PathVariable Long id) { return bookService.findById(id) .map(ResponseEntity::ok) .orElseGet(() -> ResponseEntity.notFound().build()); } @PostMapping @ResponseStatus(HttpStatus.CREATED) public Book createBook(@RequestBody Book book) { return bookService.save(book); } @PutMapping("/{id}") public Book updateBook(@PathVariable Long id, @RequestBody Book book) { book.setId(id); // Ustawiamy ID z URL, bo klient nie musi go przysyłać w body return bookService.save(book); } @DeleteMapping("/{id}") @ResponseStatus(HttpStatus.NO_CONTENT) public void deleteBook(@PathVariable Long id) { bookService.deleteById(id); } }Wyjaśnienie nowych rzeczy:
@RequestMapping("/books")na poziomie klasy: ustala wspólny prefix URL.@PathVariable: pobiera zmienną z URL (np./books/{id}→id).@RequestBody: mówi Springowi: "Odczytaj obiektBookz treści żądania HTTP (JSON)".ResponseEntity: elastyczna klasa do budowania pełnej odpowiedzi HTTP (kod, nagłówki, treść).@ResponseStatus: ustala domyślny kod odpowiedzi (np. 201 Created po@PostMapping).
Testuj API:
GET http://localhost:8080/books→ lista książek.GET http://localhost:8080/books/1→ konkretna książka.POST http://localhost:8080/booksz treścią JSON:
→ tworzy nową książkę.{"title": "Ogniem i mieczem", "author": "Henryk Sienkiewicz"}PUT http://localhost:8080/books/1z JSON-em → modyfikuje książkę o ID=1.DELETE http://localhost:8080/books/1→ usuwa rekord.
Do testów użyj Postmana, cURL albo Swagger (możesz do projektu dodać
springdoc-openapi).To wszystko! Właśnie stworzyłeś kontroler REST w Spring Boot. Od teraz możesz rozbudowywać projekt o:
- Połączenie z bazą danych (JPA/Hibernate + MySQL/PostgreSQL).
- Zabezpieczenia (Spring Security).
- Walidację danych wejściowych (
@Valid). - Testy jednostkowe (
@WebMvcTest).
Miłego kodowania!
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.