Java Academy · Lekcja

Mapowanie encji za pomocą adnotacji JPA

Proszę definiować @Entity, @Table, @Id, @GeneratedValue, @Column i @Embedded, aby projektować przejrzyste encje.

Mapowanie encji za pomocą adnotacji JPA to bezpłatna lekcja Java Academy na CoddyKit. To lekcja 1 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej Java Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs Java Academy zawiera 4 lekcji w sumie.

Czym jest mapowanie encji JPA?

JPA (Jakarta Persistence API) mapuje klasy Java na tabele baz danych za pomocą adnotacji. Hibernate jest najczęściej używanym dostawcą JPA. Nie trzeba pisać SQL DDL — JPA generuje schematy na podstawie adnotacji.

@Entity i @Table

@Entity oznacza klasę jako encję JPA. @Table pozwala dostosować nazwę tabeli, schemat i ograniczenia unikatowości. Każda encja musi mieć konstruktor bezargumentowy (może on mieć modyfikator protected).

@Entity
@Table(name = "users", uniqueConstraints = @UniqueConstraint(columnNames = "email"))
public class User {
    // ...
    protected User() {} // required by JPA
}

@Id i @GeneratedValue

@Id oznacza pole klucza głównego. @GeneratedValue konfiguruje strategię automatycznego generowania: IDENTITY (automatyczne zwiększanie wartości przez bazę danych), SEQUENCE (sekwencja bazy danych, lepsza przy wstawianiu zbiorczym) lub AUTO.

@Entity
public class User {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
}

@Column: Dostosowywanie kolumn

@Column określa nazwę kolumny, jej długość, dopuszczalność wartości null oraz unikatowość. Jeśli adnotacja nie zostanie użyta, nazwa pola stanie się nazwą kolumny.

@Column(name = "full_name", nullable = false, length = 100)
private String name;
@Column(name = "email", unique = true, nullable = false)
private String email;
@Column(name = "created_at", updatable = false)
private LocalDateTime createdAt;

@Embedded i @Embeddable

Grupę kolumn należy wydzielić do wielokrotnego użytku obiektu wartości opatrzonego adnotacją @Embeddable. Aby uwzględnić jego pola w encji, należy użyć @Embedded.

@Embeddable
public class Address {
    private String street, city, country;
    @Column(name = "zip_code") private String zipCode;
}
@Entity
public class User {
    @Embedded private Address address;
}

@Enumerated: Zapisywanie enumów

Enumy należy zapisywać jako ciąg znaków będący ich nazwą (STRING) lub jako liczbę całkowitą będącą ich wartością porządkową (ORDINAL). Zawsze należy używać STRING — wartości porządkowe przestają działać poprawnie po zmianie kolejności wartości enuma.

@Enumerated(EnumType.STRING)
@Column(nullable = false)
private UserStatus status; // stored as "ACTIVE", "INACTIVE", etc.

@CreationTimestamp i @UpdateTimestamp

Adnotacje specyficzne dla Hibernate, które automatycznie ustawiają znacznik czasu odpowiednio podczas wstawiania i aktualizowania — nie ma potrzeby ręcznego używania @PrePersist.

@CreationTimestamp
@Column(updatable = false)
private LocalDateTime createdAt;
@UpdateTimestamp
private LocalDateTime updatedAt;

@Transient: Wykluczanie pól

Pola opatrzone adnotacją @Transient nie są utrwalane. Należy jej używać w przypadku pól pochodnych lub obliczanych, których nie powinno się przechowywać w bazie danych.

@Transient
public String getFullName() { return firstName + " " + lastName; }

@Lob: Duże obiekty

Adnotacji @Lob należy używać do mapowania dużych kolumn tekstowych (TEXT/CLOB) lub binarnych (BLOB). PostgreSQL mapuje @Lob String na TEXT.

@Lob
@Column(name = "content")
private String content; // maps to TEXT in PostgreSQL

Kontrakt equals i hashCode

Encje JPA używane w kolekcjach muszą implementować equals / hashCode na podstawie klucza biznesowego, a nie wygenerowanego identyfikatora, który przed utrwaleniem ma wartość null. Należy użyć @NaturalId lub zastępczego klucza UUID.

@Override public boolean equals(Object o) {
    if (this == o) return true;
    if (!(o instanceof User u)) return false;
    return email != null && email.equals(u.email);
}
@Override public int hashCode() { return getClass().hashCode(); }

@Version — blokowanie optymistyczne

Należy dodać pole z adnotacją @Version. Hibernate zwiększa jego wartość przy każdej aktualizacji. Jeśli dwie transakcje równocześnie zaktualizują ten sam wiersz, druga zgłosi wyjątek OptimisticLockException.

@Version
private Long version; // auto-managed by Hibernate

Szybkie sprawdzenie

Dlaczego adnotacja @Enumerated powinna używać STRING zamiast ORDINAL?

Podsumowanie

Do mapowania klasy na tabelę należy używać @Entity/@Table. @Id+@GeneratedValue służą do definiowania kluczy głównych. @Column służy do określania ograniczeń. @Embedded służy do obsługi obiektów wartości. Zawsze należy używać @Enumerated(STRING). Do blokowania optymistycznego należy dodać @Version.

Często zadawane pytania

Czy lekcja „Mapowanie encji za pomocą adnotacji JPA” jest bezpłatna?

Tak — pełny tekst „Mapowanie encji za pomocą adnotacji JPA” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu Java Academy, przejdź na CoddyKit PRO. Kurs Java Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Mapowanie encji za pomocą adnotacji JPA”?

Proszę definiować @Entity, @Table, @Id, @GeneratedValue, @Column i @Embedded, aby projektować przejrzyste encje. Ćwiczysz Java Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć Java Academy?

Nie wymagamy żadnego doświadczenia. Java Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 1 z 4.

Ile czasu zajmuje lekcja „Mapowanie encji za pomocą adnotacji JPA”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji Java Academy?

Tak. Każda lekcja Java Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

Mapowanie encji za pomocą adnotacji JPA
Repozytoria Spring Data i metody zapytań
Relacje jeden-do-wielu i wiele-do-wielu
Paginacja, sortowanie i projekcje

← Powrót do Java Academy