Как мне использовать CriteriaBuilder для написания левого внешнего соединения, когда отношение идет другим путем?

Вы можете сделать что-то вроде этого.

final Root<Message> messageRoot = criteriaQuery.from(Message.class);
Join<Message, MessageReadDate> join1 = messageRoot .join("joinColumnName", JoinType.LEFT);

Predicate predicate = criteriaBuilder.equal(MessageReadDate.<String> get("recipient"), recepientValue;
criteria.add(predicate);
criteriaQuery.where(predicate);
criteriaQuery.distinct(true);

Я надеюсь, что это решит ваш вопрос.

Если между двумя объектами нет явной связи (двунаправленной ассоциации), то условие JOIN помещается в предложение WHERE.

Подход JPQL может выглядеть следующим образом:

SELECT DISTINCT m 
FROM Message m, MessageReadDate mr 
WHERE m.id = mr.message.id AND mr.recipient.name = 'USER1'

следовательно, Criteria API может выглядеть следующим образом:

CriteriaBuilder cb = em.getCriteriaBuilder();
CriteriaQuery<Message> cq = cb.createQuery(Message.class);
Root<Message> m = cq.from(Message.class);
Root<MessageReadDate> mr = cq.from(MessageReadDate.class);

Predicate p1 = cb.equal(mr.get("recipient").get("name"), cb.literal("USER1"));
Predicate p2 = cb.equal(mr.get("message").get("id"), m.get("id"));
Predicate criteria = cb.conjunction();
criteria = cb.and(criteria, p1);
criteria = cb.and(criteria, p2);

cq.where(criteria);
cq.select(m).distinct(true);

List<Message> messages = em.createQuery(cq).getResultList();

вы не можете сделать это в JPA 2.0 (в запросах критериев). вам нужно либо сделать это через JPQL, либо перейти на JPA 2.2. в JPA 2.2 они представили оператор .on(), который позволяет выполнять произвольные внешние соединения.

javax.persistence.criteria.Join.on() взято из JPA 2.1. Тем не менее, вам не разрешено присоединяться к несвязанным объектам, как указано разработчиками Hibernate:

https://vladmihalcea.com/how-to-join-unrelated-entities-with-jpa-and-hibernate/

Присоединение несвязанных сущностей возможно только при использовании JPQL или HQL. Эта функция недоступна при использовании JPA Criteria API.

Единственный способ сделать соединение — добавить отсутствующую ассоциацию (вероятно, LAZY) к объекту, потому что Criteria API не позволяет: root.join("id", JoinType.LEFT), это не удается с:

org.hibernate.query.criteria.internal.BasicPathUsageException:
Cannot join to attribute of basic type

и безуспешно переопределять соединение с Join.on().

Другой способ — использовать JPQL. Если ваш запрос динамический - используйте String.format() небезопасный, но старый подход для построения запроса JPQL ))

Альтернативный подход состоит в том, чтобы основать root на другом объекте и сделать ПРАВОЕ ПРИСОЕДИНЕНИЕ!

Сущность «Сообщение» не имеет никакой ссылки на MessageReadDate. Поэтому было бы лучше использовать начало «MessageReadDate» в качестве корня, а затем перейти к «Сообщению».

CriteriaBuilder cb = em.getCriteriaBuilder();
CriteriaQuery<Message> query = cb.createQuery(Message.class);
Root<MessageReadDate> root = query.from(MessageReadDate.class);
final Join<MessageReadDate, Message> msg = root.join("message");

query.select(root);
query.where(cb.equal(root.get("recipient"),
                              "USER1"));
List<Message> = em.createQuery(query)
                  .getResultList();