Back-end

JPA - zarządzanie relacjami między encjami

JPA to narzędzie do zarządzania relacjami między encjami w aplikacji Java. Dzięki niemu można łatwo i efektywnie zarządzać danymi w bazie danych, mapując je na obiekty Java. Pozwala to na uniknięcie pisania skomplikowanych zapytań SQL, co znacznie przyspiesza proces tworzenia aplikacji i zwiększa jej skalowalność.

Tomasz Kozon - CEO Boring Owl

Tomasz Kozon

CEO

06 cze 2023

JPA (Java Persistence API) to standardowa specyfikacja służąca do mapowania obiektowo-relacyjnego (ORM) w aplikacjach Javy. Umożliwia programistom przenoszenie danych między relacyjną bazą danych a obiektami aplikacji bez konieczności pisania zapytań SQL.

Dzięki JPA aplikacja może komunikować się z bazą danych poprzez encje – klasy reprezentujące tabele w bazie. Programista może pracować z danymi w sposób obiektowy, a szczegóły techniczne, takie jak SQL, są zarządzane automatycznie przez framework.

JPA jest specyfikacją – najczęściej wykorzystywaną implementacją JPA jest Hibernate, ale dostępne są też inne, jak EclipseLink czy OpenJPA.

 

Powiązane case studies

Encje i relacje

Encje to obiekty, które mapujemy na rekordy w bazie danych. W JPA mamy różne strategie mapowania pól encji na kolumny w tabeli. Relacje między encjami pozwalają nam definiować jak poszczególne encje ze sobą współpracują. Wyróżniamy relacje wiele do jednego, wiele do wielu i jeden do jednego. Dobre zarządzanie relacjami między encjami ma kluczowe znaczenie w projektach, gdzie pracujemy z dużą ilością danych. W JPA mamy kilka sposobów definiowania relacji między encjami.

 

Powiązana usługa

Web development

Projektujemy i tworzymy dedykowane aplikacje webowe - od MVP, które pozwala szybko zweryfikować pomysł, po rozbudowane platformy i systemy rozwijane przez lata. Budujemy zarówno warstwę frontendową, jak i backend, API, bazy danych, panele administracyjne oraz integracje z zewnętrznymi systemami. Pracujemy m.in. z Next.js, React, Node.js, NestJS, Pythonem, PostgreSQL i MongoDB. Tworzymy rozwiązania dopasowane do konkretnego procesu biznesowego: aplikacje SaaS, systemy wewnętrzne, platformy sprzedażowe, serwisy internetowe, marketplace’y i systemy CMS.

Typy relacji

W JPA mamy cztery główne typy relacji:

  • @ManyToOne (wiele-do-jednego) – wiele encji może być powiązanych z jedną encją po drugiej stronie relacji.
  • @OneToMany (jeden-do-wielu) – jedna encja może być powiązana z wieloma encjami.
  • @OneToOne (jeden-do-jednego) – jedna encja jest powiązana z dokładnie jedną inną encją.
  • @ManyToMany (wiele-do-wielu) – wiele encji może być powiązanych z wieloma innymi encjami.

 

Uwaga: W relacjach dwukierunkowych należy ustalić stronę właścicielską relacji (mappedBy), co wpływa na sposób zarządzania danymi i zapisów do bazy.

BoringOwl_programming_developer_in_front_of_computer_in_simple__5b5f1e11-9a6b-4d82-ba3e-ebf8e0140cec (1).png

Tworzenie relacji między encjami

Tworzenie relacji między encjami jest jednym z najważniejszych aspektów JPA. Aby umożliwić skuteczne zarządzanie danymi, encje muszą być w stanie odwoływać się do siebie nawzajem. W tym celu wykorzystuje się adnotacje, takie jak @OneToOne, @OneToMany, @ManyToOne i @ManyToMany. Kiedy dodajemy relacje między encjami, możemy wykorzystać język zapytań JPQL do wykonywania zaawansowanych operacji na danych, takich jak pobieranie wyników z kilku tabel jednocześnie. Dzięki temu JPA umożliwia elastyczne zarządzanie danymi w bazie.

 

Operacje CRUD na relacjach

W kontekście relacji między encjami, operacje CRUD (Create, Read, Update, Delete) wymagają dodatkowej ostrożności:

  • W relacjach wiele-do-wielu konieczne jest zarządzanie tabelą łączącą (ang. join table)
  • W relacjach dwukierunkowych, obie strony relacji muszą być odpowiednio zsynchronizowane
  • Operacje mogą być kaskadowane za pomocą CascadeType, np. CascadeType.ALL

 

Serializacja do JSON

Podczas używania JSON (np. z Spring Boot + Jackson) w kontekście relacji dwukierunkowych może dojść do błędu cyklicznej serializacji. Aby temu zapobiec, stosuje się:

  • @JsonManagedReference i @JsonBackReference
  • @JsonIgnore dla jednej ze stron
  • Mapowanie danych do specjalnych klas DTO

FAQ

Najczęstsze pytania

  • JPA (Java Persistence API) to standardowa specyfikacja służąca do mapowania obiektowo-relacyjnego (ORM) w aplikacjach Javy. Umożliwia przenoszenie danych między relacyjną bazą danych a obiektami aplikacji bez pisania zapytań SQL — aplikacja komunikuje się z bazą poprzez encje, czyli klasy reprezentujące tabele. Najczęściej używaną implementacją JPA jest Hibernate, ale dostępne są też EclipseLink czy OpenJPA.

  • Cztery główne typy: @ManyToOne (wiele-do-jednego), @OneToMany (jeden-do-wielu), @OneToOne (jeden-do-jednego) oraz @ManyToMany (wiele-do-wielu). W relacjach dwukierunkowych należy ustalić stronę właścicielską relacji (mappedBy), co wpływa na sposób zarządzania danymi i zapisów do bazy.

  • W relacjach wiele-do-wielu konieczne jest zarządzanie tabelą łączącą (join table), w relacjach dwukierunkowych obie strony relacji muszą być odpowiednio zsynchronizowane, a operacje mogą być kaskadowane za pomocą CascadeType, np. CascadeType.ALL.

  • Podczas używania JSON (np. ze Spring Boot i Jacksonem) stosuje się adnotacje @JsonManagedReference i @JsonBackReference, @JsonIgnore dla jednej ze stron relacji lub mapowanie danych do specjalnych klas DTO.

Blog

Powiązane artykuły

Czytaj więcej
Back-end

Hibernate: czym jest i do czego służy

Hibernate to popularne narzędzie do obsługi baz danych dla aplikacji Java. Jest to framework, który umożliwia łatwą i skuteczną komunikację z bazami danych, umożliwiając programistom unikanie pisania skomplikowanego kodu SQL. Hibernate jest bardzo elastyczne i może być dostosowywane do potrzeb różnych projektów, co czyni go atrakcyjnym wyborem dla wielu programistów Java.

Tomasz Kozon
02 sty 2023
Back-end

GraalVM: Rewolucja w świecie wirtualnych maszyn

GraalVM wprowadza przełom w świecie wirtualnych maszyn, oferując wyjątkową uniwersalność i wydajność. Zaprojektowany z myślą o współczesnych wymaganiach programistycznych, umożliwia uruchamianie kodu napisanego w wielu językach, w tym Java, JavaScript, Python, i innych, na jednej platformie.

Tomasz Kozon
06 lut 2024
Back-end

Czym jest SOAP i jak działa?

SOAP to protokół służący do wymiany informacji między różnymi systemami. Dzięki niemu możliwe jest przesłanie kompleksowych danych w formacie XML za pomocą sieci. W artykule dowiesz się, jak działa SOAP i jakie ma zastosowania.

Tomasz Kozon
10 maj 2023
Back-end

MERN Stack – charakterystyka i zastosowanie

MERN Stack to jeden z najpopularniejszych zestawów technologii wykorzystywanych do tworzenia nowoczesnych aplikacji webowych. Dzięki połączeniu MongoDB, Express, React oraz Node.js umożliwia on budowę wydajnych i skalowalnych rozwiązań opartych w całości na języku JavaScript. Stack ten jest chętnie wybierany zarówno przez startupy, jak i doświadczone zespoły developerskie.

Tomasz Kozon
14 gru 2025
Back-end

Biome w praktyce: nowoczesne narzędzie do formatowania i lintowania kodu

Utrzymanie spójnego stylu i wysokiej jakości kodu to jedno z największych wyzwań w nowoczesnych projektach programistycznych. Wraz z rozwojem ekosystemu JavaScript i TypeScript deweloperzy coraz częściej muszą korzystać z wielu narzędzi do formatowania i lintowania, co prowadzi do złożonej konfiguracji i potencjalnych konfliktów. Biome powstało jako odpowiedź na te problemy, oferując jedno, szybkie i spójne rozwiązanie typu all-in-one.

Tomasz Kozon
04 gru 2025
Back-end

Bazel – szybkie i skalowalne budowanie projektów

Bazel to jedno z najszybszych i najbardziej niezawodnych narzędzi do budowania projektów, stworzone z myślą o pracy na dużą skalę. Dzięki inteligentnemu zarządzaniu zależnościami i zaawansowanym mechanizmom cache’owania znacząco skraca czas kompilacji, nawet w bardzo rozbudowanych repozytoriach. Pozwala zespołom pracować szybciej, stabilniej i bardziej przewidywalnie, niezależnie od stosowanych języków programowania.

Tomasz Kozon
04 gru 2025