Definiowanie encji i repozytoriów

W tej lekcji nauczą się Państwo łączyć aplikację Java z bazą danych za pomocą Spring Boot. Nazywa się to trwałością danych i oznacza, że dane pozostają dostępne nawet po zatrzymaniu aplikacji.

Skupimy się na dwóch podstawowych pojęciach:

• Encje: obiekty Javy mapowane na tabele bazy danych.
• Repozytoria: interfejsy udostępniające łatwe sposoby pracy z encjami i bazą danych.

Encja JPA to zwykła klasa Javy reprezentująca tabelę w relacyjnej bazie danych. Każda instancja tej klasy odpowiada jednemu wierszowi w tej tabeli.

Java Persistence API (JPA) to standard zarządzania danymi relacyjnymi w aplikacjach Java. Spring Data JPA bazuje na nim, aby jeszcze bardziej uprościć interakcję z bazami danych.

Aby oznaczyć klasę Javy jako encję JPA, należy użyć adnotacji @Entity. Trzeba również zdefiniować klucz główny za pomocą @Id.

Utwórzmy prostą encję Product:

Ręczne przypisywanie identyfikatorów może być uciążliwe i podatne na błędy. Bazy danych mogą automatycznie generować dla Państwa unikalne identyfikatory!

Należy użyć adnotacji @GeneratedValue wraz ze strategią strategy. GenerationType.IDENTITY jest często używana w bazach danych, które automatycznie zwiększają wartości identyfikatorów (takich jak MySQL i H2).

Domyślnie JPA mapuje pola na kolumny o takich samych nazwach. Można to dostosować za pomocą adnotacji @Column.

Pozwala ona określić nazwę kolumny, to, czy może przyjmować wartość null, jej długość i inne właściwości:

Skoro mamy już encję, jak zapisać ją w bazie danych lub ją pobrać? Właśnie do tego służą repozytoria Spring Data!

Repozytorium to interfejs udostępniający gotowe, zaawansowane metody do typowych operacji na bazie danych, takich jak tworzenie, odczytywanie, aktualizowanie i usuwanie danych (CRUD). Nie trzeba pisać kodu SQL — Spring Data JPA wygeneruje go za Państwa.

Aby utworzyć repozytorium dla encji, wystarczy zdefiniować interfejs rozszerzający interfejs JpaRepository biblioteki Spring Data JPA.

Interfejs JpaRepository przyjmuje dwa parametry typów: typ encji oraz typ jej klucza głównego.

Oto sposób definiowania repozytorium dla naszej encji Product:

import org.springframework.data.jpa.repository.JpaRepository;
import org.springframework.stereotype.Repository;

// Assuming 'Product' entity is defined in the same package or imported
@Repository
public interface ProductRepository extends JpaRepository<Product, Long> {
    // Spring Data JPA automatically provides CRUD methods here!
    // You can add custom query methods if needed, e.g.,
    // List<Product> findByName(String name);
}

Uwaga: adnotacja @Repository jest opcjonalna, ale jej użycie poprawia czytelność kodu.

Rozszerzając interfejs JpaRepository, Państwa ProductRepository automatycznie dziedziczy wiele zaawansowanych metod. Oto kilka z nich:

• save(entity): zapisuje podaną encję (wstawia ją, jeśli jest nowa, lub aktualizuje, jeśli już istnieje).
• findById(id): pobiera encję na podstawie jej identyfikatora, zwracając obiekt Optional.
• findAll(): zwraca wszystkie wystąpienia danego typu encji.
• delete(entity) lub deleteById(id): usuwa encję.

Oznacza to, że otrzymują Państwo pełną funkcjonalność CRUD bez pisania ani jednej linii kodu implementacji!

W rzeczywistej aplikacji Spring Boot repozytorium zostanie wstrzyknięte do serwisu lub kontrolera za pomocą @Autowired, a następnie będzie można wywoływać jego metody.

Nie możemy tutaj uruchomić kompletnej aplikacji Spring Boot z bazą danych, ale poniższy fragment pokazuje sposób użycia repozytorium w typowym komponencie Spring Boot:

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;
import java.util.List;

// Assuming Product and ProductRepository are defined

@Service
public class ProductService {

    private final ProductRepository productRepository;

    @Autowired
    public ProductService(ProductRepository productRepository) {
        this.productRepository = productRepository;
    }

    public Product createProduct(String name, double price) {
        Product newProduct = new Product(name, price);
        return productRepository.save(newProduct);
    }

    public List<Product> getAllProducts() {
        return productRepository.findAll();
    }

    public Product getProductById(Long id) {
        return productRepository.findById(id).orElse(null);
    }
}

Ten ProductService byłby następnie używany przez inne części aplikacji.

Świetnie! Poznali Państwo podstawy utrwalania danych za pomocą Spring Data JPA:

• Encje to klasy Java opatrzone adnotacją @Entity, które mapują się na tabele bazy danych.
• @Id oznacza klucz główny, a @GeneratedValue pozwala bazie danych obsługiwać generowanie identyfikatorów.
• @Column umożliwia dostosowanie mapowania pól na kolumny.
• Repozytoria to interfejsy rozszerzające JpaRepository<Entity, ID>, które udostępniają zaawansowane, gotowe metody CRUD bez konieczności pisania kodu SQL.

W następnej części dokładniej zajmą się Państwo wykonywaniem różnych operacji CRUD!