EntityGraph и Join Fetch — это два способа управления загрузкой связанных сущностей в JPA, но они отличаются по применению и гибкости.

Join Fetch — это директива в JPQL или Criteria API, которая указывает на необходимость выполнить SQL JOIN и загрузить связанные сущности сразу. Пример:

TypedQuery<Person> query = em.createQuery(
    "SELECT p FROM Person p JOIN FETCH p.address WHERE p.id = :id", Person.class);
query.setParameter("id", 1L);
Person person = query.getSingleResult();

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

Простота использования в конкретном запросе.
Явное указание, какие связи загружать.

Недостатки:

Жёстко привязан к конкретному запросу.
При большом количестве связей может привести к сложным и громоздким запросам.

EntityGraph — это декларативный способ описания графа загрузки сущностей, который можно применять как к запросам, так и к методам репозитория. Позволяет гибко управлять загрузкой связей без изменения JPQL.

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

EntityGraph<Person> graph = em.createEntityGraph(Person.class);
graph.addAttributeNodes("address");

Map<String, Object> props = new HashMap<>();
props.put("javax.persistence.fetchgraph", graph);

Person person = em.find(Person.class, 1L, props);

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

Повторное использование графов загрузки.
Отделение логики загрузки от запроса.
Можно комбинировать с разными запросами.

Недостатки:

Требует дополнительной настройки.
Могут быть ограничения в сложных случаях.

Итог: Join Fetch — это явный способ указать загрузку связей в запросе, а EntityGraph — более гибкий и декларативный механизм управления графом загрузки, который можно применять независимо от запроса.

Чем отличается EntityGraph от Join Fetch?