Для чего применяется Criteria API?

Question

Criteria API используется для построения динамических запросов к базе данных. Запросы собираются программно, а не строками. Это снижает риск ошибок в именах полей и упрощает рефакторинг. Criteria API особенно полезен, когда условия запроса заранее неизвестны. Однако код получается более многословным, чем JPQL.

YeaHub · Accepted Answer

Criteria API решает задачу построения сложных и динамических запросов в JPA, когда невозможно заранее написать фиксированный JPQL.ОпределениеCriteria API — это типобезопасный программный API для построения запросов JPA, в котором запрос формируется через Java-объекты и методы, а не через строки.Зачем нужен Criteria API1) Динамические условияЧасто фильтры зависят от пользовательского ввода или набора параметров.Типичный сценарийпользователь указал часть фильтровостальные фильтры отсутствуютзапрос нужно собрать на летуПреимуществонет сложной конкатенации строкпроще добавлять или убирать условия2) ТипобезопасностьCriteria API работает с метамоделью сущностей.Что это даётошибки в именах полей ловятся на этапе компиляциирефакторинг не ломает запросыКонтраст с JPQLJPQL — строкиошибки видны только в рантайме3) Интеграция со Spring DataCriteria API часто используется через Specification.Это позволяеткомбинировать условияпереиспользовать части запросовписать чистый и расширяемый кодПример идеи использованияCriteriaBuilder cb = entityManager.getCriteriaBuilder(); CriteriaQuery query = cb.createQuery(User.class); Root root = query.from(User.class); List predicates = new ArrayList<>(); // условия добавляются динамически predicates.add(cb.equal(root.get("status"), "ACTIVE")); query.where(predicates.toArray(new Predicate[0])); Недостатки Criteria APIКод более многословныйСложнее читать, чем JPQLНе всегда оправдан для простых запросовКраткий выводCriteria API стоит применять для сложных и динамических запросов, особенно когда важна типобезопасность и переиспользуемость условий.