[자바 ORM 표준 JPA] ch10.객체지향 쿼리 - 기본편

2023-08-25
java-orm-jpa

객체지향 쿼리

em.find()는 식별자로만 객체를 탐색하기 때문에 한계가 있습니다. 이를 위해 객체지향 쿼리를 사용합니다.

객체지향 쿼리는 객체를 대상으로 검색을하는 객체지향 쿼리입니다. 특정 SQL에 의존하지 않습니다.

JPQL ( Java Persistance Query Language )
Criteria 쿼리
- JPQL을 편하게 작성할 수 있도록 도와주는 빌더 클래스
QueryDSL
- JPQL을 편하게 작성할 수 있도록 도와주는 빌더 클래스
네이티브 SQL
- SQL을 직접 사용
JDBC API 직접 사용, MyBatis, SpringJdbcTemplate 함께 사용

JPQL

JPQL 기본

엔티티와 속성은 대소문자를 구분합니다.
- SELECT m.name은 정상실행 되지만 SELECT m.Name 대소문자가 틀리면 QueryException 이 발생 합니다
FROM 절에는 엔티티 이름이 들어갑니다.
엔티티에 별칭은 필수 입니다.
query.getResultList()는 결과를 리스트로 반환합니다. 결과가 없으면 빈 리스트를 반환합니다.

query.getSingleResult()는 결과가 정확히 하나일 때 사용합니다. 결과가 없으면 NoResultException 예외가 발생하고, 둘 이상이면 NonUniqueResultException 예외가 발생합니다.

TypedQuery<String> query = em.createQuery("SELECT m.Name FROM Member m where m.age > 20", String.class);
-----
Caused by: org.hibernate.QueryException: **could not resolve property: Name** of: org.example.ch10.jpql.entity.Member [SELECT m.Name FROM org.example.ch10.jpql.entity.Member m where m.age > 20]

TypedQuery<Member> query = em.createQuery("SELECT m FROM Member m", Member.class);
List<Member> resultList = query.getResultList();
resultList.forEach(member -> System.out.println(member.getName()));
-----
Hibernate: 
 select
     member0_.MEMBER_ID as member_i1_0_,
     member0_.city as city2_0_,
     member0_.street as street3_0_,
     member0_.zipcode as zipcode4_0_,
     member0_.age as age5_0_,
     member0_.name as name6_0_,
     member0_.TEAM_ID as team_id7_0_ 
 from
     Member member0_

TypedQuery<String> query = em.createQuery("SELECT m.name FROM Member m where m.age > 20", String.class);
List<String> resultList = query.getResultList();
-----
Hibernate: 
 select
     member0_.name as col_0_0_ 
 from
     Member member0_ 
 where
     member0_.age>20

TypeQuery, Query

Query
쿼리의 결과물이 정해진 타입이 아닙니다.

결과가 여러개라면 Object[]로 반환되고, 하나라면 Object 입니다.

Query query = em.createQuery("SELECT m.id, m.name FROM Member m");
List resultList = query.getResultList();
resultList.forEach(o -> {
    Object[] object = (Object[]) o;
    System.out.println("id: " + object[0]);
    System.out.println("name: " + object[1]);
});

TypeQuery

쿼리의 결과물이 정해진 객체입니다.

TypedQuery<Member> query = em.createQuery("SELECT m FROM Member m", Member.class);
List<Member> resultList = query.getResultList();
resultList.forEach(member -> System.out.println(member.getName()));

파라미터 바인딩

이름 기준 파라미터 JPQL은 이름 기준 파라미터 바인딩을 지원합니다. WHERE m.name = :name 이 부분에 :name 이 파라미터 바인딩 입니다. 파라미터를 셋팅 할 때 name이란 이름으로 바인딩하면 됩니다.
```
TypedQuery<Member> query = em.createQuery("SELECT m FROM Member m WHERE m.name = :name", Member.class);
query.setParameter("name", "kim");
```

위치 기준 파라미터 위치 기준 파라미터는 ?를 사용합니다.

TypedQuery<Member> query = em.createQuery("SELECT m FROM Member m WHERE m.name = ?1", Member.class);
query.setParameter(1, "kim");

프로젝션

SELECT 절에 조회활 대상을 지정하는 것을 프로젝션이라고 합니다.

엔티티 프로젝션 아래 sql 둘 다 원하는 엔티티를 바로 조회합니다. 이렇게 조회한 엔티티는 영속성 컨텍스트에서 관리됩니다.
```
List<Member> resultList = em.createQuery("SELECT m FROM Member m", Member.class).getResultList();
```
임베디드 타입 프로젝션 임베디드 타입은 엔티티처럼 FROM절에 사용할 수 없습니다. 임베디드가 포함된 엔터티를 조회하되 임베디드 타입만을 조회하면 됩니다.
```
List<Address> resultList = em.createQuery("SELECT o.address FROM Order o", Address.class).getResultList();
```

스칼라 타입 프로젝션 숫자, 문자, 날짜와 같은 기본 데이터 타입입니다.

List<String> resultList = em.createQuery("SELECT m.name FROM Member m", String.class).getResultList();
List<Double> ageAverage = em.createQuery("SELECT AVG(m.age) FROM Member m", Double.class).getResultList();

여러 값 조회 여러 값 조회는 Object[] 타입으로 조회합니다.

List<Object[]> resultList = em.createQuery("SELECT o.member, o.product, o.orderAmount FROM Order o").getResultList();
resultList.forEach(objects -> {
 Member member = (Member) objects[0];
 System.out.println("member = " + member.getName());
 Product product = (Product) objects[1];
 System.out.println("product = " + product.getName());
 int orderAmount = (int) objects[2];
 System.out.println("orderAmount = " + orderAmount);
});

NEW 명령어 생성자를 통해서 조회 결과를 바로 해당 객체로 받을 수 있습니다.

List<MemberDto> resultList = em.createQuery("SELECT new org.example.ch10.jpql.dto.MemberDto(m.name, m.age) FROM Member m", MemberDto.class).getResultList();

페이징 API

이 두개만 설정하면 됩니다. setFirstResult(int startPosition), setMaxResults(int maxResult)

List<Member> resultList = em.createQuery("SELECT m FROM Member m", Member.class)
  .setFirstResult(0)
  .setMaxResults(10)
  .getResultList();

Hibernate: 
    select
        member0_.MEMBER_ID as member_i1_0_,
        member0_.city as city2_0_,
        member0_.street as street3_0_,
        member0_.zipcode as zipcode4_0_,
        member0_.age as age5_0_,
        member0_.name as name6_0_,
        member0_.TEAM_ID as team_id7_0_ 
    from
        **Member member0_ limit ? offset ?**

Twitter Facebook LinkedIn