JPA and Native Query (SQL)

• java - JPA : How to convert a native query result set to POJO class collection - Stack Overflow : JPA에서 쿼리 결과를 POJO로 매핑하는 다양한 방법들
• Hibernate HQL을 사용하는게 더 편할 수도 있음.

• Native Query 결과를 entity 로 받는 방법으로 암묵적으로 할수도 있다.
• EntityManager.createNativeQuery(“SQL”, EntityClass.class).getSingleResult() 사용

Book b = (Book) em.createNativeQuery("SELECT * FROM book b WHERE id = 1", Book.class).getSingleResult();

• 단일 엔티티에 대한 Native Query 실행은 매핑이 필요없다.
• 다중 Entity를 결과로 받는 Native Query는 @SqlResultSetMapping로 매핑 정보를 지정해야 하며 그 결과는 List<Object[]>로 리턴한다.
  • Object[]에는 SqlResultSetMapping에 지정된 순서대로 결과 엔티티 객체가 들어온다.
• ResultSet Mappings examples
• NativeQuery Result Set Mapping은 모든 필드를 명백히 기술해서 매핑해 주자. 그렇지 않으면 컬럼의 변경이 발생하거나 두 개 이상 엔티티에 대한 매핑시 동일 컬럼 이름 존재시 심각한 오류가 발생할 수 있다.
• 두 개 이상의 엔티티를 로딩하는데 그 것들이 서로 연관 관계일 경우 이미 연관 관계가 자동으로 채워진 상태의 엔티티가 생성된다. 이미 Native Query 결과 객체(result set mapping)내에 연관에 관한 데이터 매핑이 있으면 다시 쿼리를 날리지 않는다.
• 애노테이션보다는 JPA XML Configuration - orm.xml을 이용해서 매핑을해주는 것이 더 합리적으로 보인다.

<?xml version="1.0" encoding="UTF-8"?>
<entity-mappings
  xmlns="http://java.sun.com/xml/ns/persistence/orm"
  xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
  xsi:schemaLocation="
    http://java.sun.com/xml/ns/persistence/orm
    http://java.sun.com/xml/ns/persistence/orm_2_0.xsd"
  version="2.0">
  <sql-result-set-mapping name="nativesql_mapping_example">
    <entity-result entity-class="kr.pe.kwonnam.Book">
      <field-result name="id" column="bk.id" />
      <field-result name="title" column="bk.title" />
      <field-result name="price" column="bk.price" />
      <!-- Author writer, Long writerId 매핑이 함께 존재할경우 -->
      <field-result name="writerId" column="bk.writer_id" />
      <field-result name="writer" column="bk.writer_id" />
    </entity-result>
    <entity-result entity-class="kr.pe.kwonnam.Author">
      <field-result name="id" column="at.id" />
      <field-result name="name" column="at.name" />
    </entity-result>
  </sql-result-set-mapping>
</entity-mappings>

• @ManyToOne의 One 측에 대한 매핑 컬럼이 존재하는 경우에 해당 컬럼과 필드명도 매핑해야한다.
  • 예를들어 Article이 Board의 자식이고 Article에 대해 매핑할 경우
  • Article.boardId와 Article.board 필드 두개를 모두 매핑해두었다면
  • boardId → article.board_id와, board → article.board_id 이렇게 두 번의 필드 매핑을 해줘야 한다.

• JPA (2.1 에서 테스트) 일반 Query / Native Query 모두 in 파라미터 매핑을 지원
• 단, 파라미터 매핑시 in (:paramName) 형태가 아닌 in :paramName 형태로 쿼리를 만들어야 한다.

• JPA Native Query 사용시 DTO로 매핑 하기 – Yoo Young-mo – Medium
• Hibernate Tips: How to map native query results to entities