如何使用标准JPA API从原生查询初始化ElementCollection？

标准JPA完全支持通过@SqlResultSetMapping实现原生查询结果到带@ElementCollection的实体的映射，核心是使用@ElementCollectionResult关联集合属性。

步骤1：定义ResultSet映射 #

在Message实体类上添加@SqlResultSetMapping，明确主实体和集合属性的映射规则：

@Entity
@Table(name = "message")
@SqlResultSetMapping(
    name = "MessageWithTagsMapping",
    entities = [
        EntityResult(
            entityClass = Message::class.java,
            fields = [
                FieldResult(name = "id", column = "id"),
                FieldResult(name = "title", column = "title"),
                FieldResult(name = "body", column = "body"),
                FieldResult(name = "receivedAt", column = "received_at")
            ]
        )
    ],
    elementCollections = [
        ElementCollectionResult(
            targetClass = Tag::class.java,
            parentEntity = Message::class.java,
            joinColumns = [JoinColumn(name = "message_id", referencedColumnName = "id")],
            fields = [FieldResult(name = "label", column = "label")],
            collectionProperty = "tags"
        )
    ]
)
class Message(
    // 实体属性保持不变
)

步骤2：执行原生查询 #

通过EntityManager调用定义好的映射执行查询：

val query = entityManager.createNativeQuery(
    """
SELECT message.id,
       message.title,
       message.body,
       message.received_at,
       tag.message_id,
       tag.label
FROM (SELECT *
      FROM message
      WHERE message.title = ?
      ORDER BY message.received_at DESC
      OFFSET ? ROWS FETCH FIRST ? ROWS ONLY) message
     LEFT OUTER JOIN message_tag tag
                     ON message.id = tag.message_id
""",
    "MessageWithTagsMapping" // 指定映射名称
)
query.setParameter(1, "some-title")
query.setParameter(2, 0)
query.setParameter(3, 10)
val messages: List<Message> = query.resultList as List<Message>

关键说明 #

• @ElementCollectionResult专门用于映射@ElementCollection类型的属性，需要指定：
  • parentEntity：关联的主实体类
  • joinColumns：主实体和集合表的关联字段
  • collectionProperty：主实体中集合属性的名称
  • fields：集合元素的字段与SQL列的映射
• JPA会自动将关联的tag行合并到对应的Message实例中，既避免了N+1查询，又保留了分页限制。
• 确保SQL列名和FieldResult中的column值完全匹配（注意数据库大小写敏感性）。

注意事项 #

• 修正了原SQL中的笔误base.id为message.id，否则关联会失败。
• 如果使用JPA 2.1及以上版本，@ElementCollectionResult是标准支持的特性，无需依赖Hibernate扩展。

内容的提问来源于stack exchange，提问作者lbilger