Что такое Criteria API и как его использовать в Java для работы с базами данных?

Criteria API — это объектно-ориентированный способ построения запросов к базе данных. Он предоставляет набор классов и интерфейсов для программного создания запросов, что делает запросы типабезопасными и облегчает их динамическое построение. Это альтернатива HQL (Hibernate Query Language) и нативным SQL-запросам в JPA (Java Persistence API).

Преимущества:

• Типобезопасность: Ошибки типа обнаруживаются на этапе компиляции, а не выполнения.
• Объектно-ориентированный: Запросы строятся с использованием Java объектов.
• Динамическое построение: Удобно создавать запросы с переменным набором условий.
• Читаемость: Запрос, написанный с использованием Criteria API, более понятен, чем форматированная строка SQL.

Основные компоненты:

• CriteriaBuilder: Фабрика для создания объектов CriteriaQuery, Path, выражений и предикатов.
• CriteriaQuery: Представляет собой выполняемый запрос.
• Root: Представляет корневую сущность в запросе.
• Path: Представляет навигацию по свойствам сущности.
• Predicate: Представляет условие в запросе (например, равенство, больше, меньше).
• Expression: Представляет операцию или значение в запросе.

Пример использования для выборки всех сущностей:

// получение CriteriaBuilder
CriteriaBuilder cb = entityManager.getCriteriaBuilder();
// создание CriteriaQuery для типа сущности MyEntity
CriteriaQuery<MyEntity> query = cb.createQuery(MyEntity.class);
// определение корневой сущности
Root<MyEntity> root = query.from(MyEntity.class);
// выполнение запроса
List<MyEntity> resultList = entityManager.createQuery(query).getResultList();

Пример с условием WHERE:

CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<MyEntity> query = cb.createQuery(MyEntity.class);
Root<MyEntity> root = query.from(MyEntity.class);
// создание предиката для условия "propertyName = value"
Predicate condition = cb.equal(root.get("propertyName"), "value");
// добавление предиката в запрос
query.where(condition);
List<MyEntity> resultList = entityManager.createQuery(query).getResultList();

Пример с JOIN:

CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<AnotherEntity> query = cb.createQuery(AnotherEntity.class);
Root<MyEntity> myRoot = query.from(MyEntity.class);
// выполнение JOIN с другой сущностью
Join<MyEntity, AnotherEntity> anotherJoin = myRoot.join("anotherEntityProperty");
query.select(anotherJoin); // выборка другой сущности
List<AnotherEntity> resultList = entityManager.createQuery(query).getResultList();