Что такое JPA (Java Persistence API)?

JPA - это спецификация API для управления персистентностью данных в Java приложениях. Она предоставляет стандартный способ отображения Java объектов в реляционные базы данных (или другие хранилища данных) и обратно. JPA является частью платформы Java EE (сейчас Jakarta EE) и также может использоваться в standalone приложениях.

Ключевые компоненты JPA:

• Entity: Обычные Java классы (POJO), помеченные аннотацией @Entity, представляющие данные в базе данных.
• EntityManager: Интерфейс для взаимодействия с персистентным контекстом. Используется для поиска, создания, обновления и удаления сущностей.
• Persistence Context: Набор сущностей, управляемых EntityManager. В нем отслеживаются изменения сущностей перед синхронизацией с базой данных.
• JPQL (Java Persistence Query Language): Объектно-ориентированный язык запросов, похожий на SQL, но оперирующий сущностями и их связями вместо таблиц и столбцов.
• Criteria API: Объектно-ориентированный API для выполнения динамических запросов.
• persistence.xml: Файл конфигурации, описывающий единицы персистентности (persistence units) и их свойства (например, информация о подключении к базе данных, стратегии маппинга).

JPA не является конкретной реализацией ORM (Object-Relational Mapping), а лишь определяет контракты и API. Существуют различные провайдеры JPA, реализующие эту спецификацию, самые популярные из которых:

• Hibernate
• EclipseLink
• Apache OpenJPA

Пример определения сущности:

// Сущность, представляющая запись в таблице `products`
@Entity
// Название таблицы в базе данных
@Table(name = "products")
public class Product {

    // Первичный ключ
    @Id
    // Стратегия генерации первичного ключа
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    // Столбец `name` в таблице
    private String name;

    // Столбец `price` в таблице
    private BigDecimal price;

    // Конструкторы, геттеры и сеттеры
    // ...
}

Пример использования EntityManager:

// Получение EntityManager из EntityManagerFactory
EntityManagerFactory emf = Persistence.createEntityManagerFactory("myPersistenceUnit");
EntityManager em = emf.createEntityManager();

try {
    // Начало транзакции
    em.getTransaction().begin();

    // Создание новой сущности
    Product newProduct = new Product();
    newProduct.setName("Laptop");
    newProduct.setPrice(new BigDecimal("1200.00"));

    // Сохранение сущности в базе данных
    em.persist(newProduct);

    // Поиск сущности по первичному ключу
    Product foundProduct = em.find(Product.class, 1L);
    System.out.println("Найденный продукт: " + foundProduct.getName());

    // Выполнение JPQL запроса
    List<Product> allProducts = em.createQuery("SELECT p FROM Product p", Product.class).getResultList();
    for (Product p : allProducts) {
        System.out.println(p.getName());
    }

    // Коммит транзакции
    em.getTransaction().commit();

} catch (Exception e) {
    // Откат транзакции в случае ошибки
    if (em.getTransaction().isActive()) {
        em.getTransaction().rollback();
    }
    e.printStackTrace();
} finally {
    // Закрытие EntityManager
    em.close();
    // Закрытие EntityManagerFactory
    emf.close();
}

Основная цель JPA - упростить разработку приложений, работающих с базами данных, путем абстрагирования низкоуровневых деталей работы с JDBC и SQL, предоставляя объектно-ориентированный подход к персистентности. Это повышает переносимость кода и снижает его связанность с конкретной базой данных.