====== JPA and Native Query (SQL) ======
  * [[https://stackoverflow.com/questions/13012584/jpa-how-to-convert-a-native-query-result-set-to-pojo-class-collection/21487061#21487061|java - JPA : How to convert a native query result set to POJO class collection - Stack Overflow]] : JPA에서 쿼리 결과를 POJO로 매핑하는 다양한 방법들
  * [[java:hibernate:hql|Hibernate HQL]]을 사용하는게 더 편할 수도 있음.

===== NativeSQL 결과 암묵적 Entity 매핑 =====
  * Native Query 결과를 entity 로 받는 방법으로 암묵적으로 할수도 있다.
  * ''EntityManager.createNativeQuery("SQL", EntityClass.class).getSingleResult()'' 사용

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

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

==== XML 예제 ====
<code 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>
</code>

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

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

===== 참고 =====
  * [[https://medium.com/@SlackBeck/jpa-native-query-%EC%82%AC%EC%9A%A9%EC%8B%9C-dto%EB%A1%9C-%EB%A7%A4%ED%95%91-%ED%95%98%EA%B8%B0-64625780c758|JPA Native Query 사용시 DTO로 매핑 하기 – Yoo Young-mo – Medium]]
  * [[https://thoughts-on-java.org/hibernate-tips-map-native-query-results-entities/|Hibernate Tips: How to map native query results to entities]]