객체지향 쿼리 언어(JPQL) - 기본 문법

JPA는 다양한 쿼리 방법을 지원한다.

• JPQL              - em.createQuery()
• JPA Criteria     - QueryDSL 같이 Java로 쿼리 짜는 JPA 표준 스펙. but 복잡함. 비추. QueryDSL 권장.
• QueryDSL      - Java로 JPQL을 작성하는 JPQL 빌더
• 네이티브 SQL - em.createNativeQuery(). JPQL로 해결할 수 없는 특정 데이터베이스에 의존적인 기능 사용 시
• JDBC API 직접 사용, MyBatis, SpringJdbcTemplate 함께 사용  - 영속성 컨텍스트를 적절한 시점에 강제 플러시 필요!

---

JPQL(Java Persistence Query Language)

JPA에서 원하는 쿼리를 만들 때 사용.

JPA는 SQL을 추상화한 JPQL이라는 객체 지향 쿼리 언어 제공 (특정 데이터베이스 SQL에 의존X)

JPQL은 엔티티 객체를 대상으로 쿼리. 결국 SQL로 변환된다.

 

기본 문법과 기능

• 엔티티 이름 사용, 테이블 이름이 아님(Member). 별칭은 필수(m)
• 엔티티와 속성은 대소문자 구분O (Member, age). JPQL 키워드는 대소문자 구분X (SELECT, FROM, where)
• TypeQuery: 반환 타입이 명확할 때 사용
• Query: 반환 타입이 명확하지 않을 때 사용.
• query.getResultList(): 결과가 하나 이상일 때, 리스트 반환. 결과가 없으면 빈 리스트 반환.
• query.getSingleResult(): 결과가 정확히 하나, 단일 객체 반환
  결과가 없으면: javax.persistence.NoResultException   -> spring data jpa를 쓰면 null, Optional로 반환해줌
  둘 이상이면: javax.persistence.NonUniqueResultException

Query: 반환 타입이 명확하지 않을 때 사용. 수행 결과로 Object[] 타입 반환.

---

프로젝션

SELECT 절에 조회할 대상을 지정하는 것

• SELECT m FROM Member m -> 엔티티 프로젝션
• SELECT m.team FROM Member m -> 엔티티 프로젝션
• SELECT m.address FROM Member m -> 임베디드 타입 프로젝션
• SELECT m.username, m.age FROM Member m -> 스칼라 타입 프로젝션

프로젝션 - 여러 값 조회

SELECT m.username, m.age FROM Member m와 같이 타입을 특정할 수 없을 경우

1. Query 타입으로 조회, Object[] 타입으로 반환

createQuery에 타입을 넣지 않으면 반환값도 Object다.

2. new 명령어를 사용해 DTO로 조회하는 방법도 있다.

패키지 명을 포함한 전체 클래스 명 입력 -> QueryDSL은 import하니까 안써도 됨. 순서와 타입이 일치하는 생성자 필요

 

---

페이징 API

oracle에서 paging 을 위해 쿼리를 짜면 rownum을 이용해서 3 depth로 더럽게.. 짜야한다.

다행히도 JPA는 페이징을 다음 두 API로 추상화해뒀다. (당연히 방언에 따라 달리 생성된다)

• setFirstResult(int startPosition) : 조회 시작 위치 (0부터 시작)
• setMaxResults(int maxResult) : 조회할 데이터 수

---

 

조인

• 내부 조인
  SELECT m FROM Member m [INNER] JOIN m.team t  (연관된 m.team이라 적으면 on m.team_id = t.id가 추가)
• 외부 조인
  SELECT m FROM Member m LEFT [OUTER] JOIN m.team t
• 세타 조인 (연관관계 없는 것. 카티션 곱)
  select count(m) from Member m, Team t where m.username = t.name

ON 절

• 조인 대상 필터링
  JPQL : SELECT m, t FROM Member m LEFT JOIN m.team t on t.name = 'A'
  SQL  : SELECT m.*, t.* FROM Member m LEFT JOIN Team t ON m.TEAM_ID=t.id and t.name='A'
• 연관관계 없는 엔티티 외부 조인
  JPQL : SELECT m, t FROM Member m LEFT JOIN Team t on m.username = t.name  
  SQL  : SELECT m.*, t.* FROM Member m LEFT JOIN Team t ON m.username = t.name
   (m.team이라고 적으면 on m.team_id = t.id가 추가된다)

---

서브 쿼리

• 나이가 평균보다 많은 회원
  select m from Member m
  where m.age > (select avg(m2.age) from Member m2)
• 한 건이라도 주문한 고객
  select m from Member m
  where (select count(o) from Order o where m = o.member) > 0

서브 쿼리 지원 함수

• [NOT] IN (subquery): 서브쿼리의 결과 중 하나라도 같은 것이 있으면 참
• [NOT] EXISTS (subquery): 서브쿼리에 결과가 존재하면 참
  팀A 소속인 회원
  select m from Member m
  where exists (select t from m.team t where t.name = '팀A')
• {ALL | ANY | SOME} (subquery)
  
  • ALL : 모두 만족하면 참
    전체 상품 각각의 재고보다 주문량이 많은 주문들
    select o from Order o
    where o.orderAmount > ALL (select p.stockAmount from Product p)
  • ANY, SOME : 같은 의미, 조건을 하나라도 만족하면 참
    어떤 팀이든 팀에 소속된 회원
    select m from Member m
    where m.team = ANY (select t from Team t)

---

JPQL 타입 표현

• 문자: ‘HELLO’, ‘She’’s’
• 숫자: 10L(Long), 10D(Double), 10F(Float)
• Boolean: TRUE, FALSE
• ENUM: jpabook.MemberType.Admin (패키지명 포함. 파라미터 바인딩하면 생략 가능)
• 엔티티 타입: TYPE(m) = Member (상속 관계에서 사용)
  select i from Item i where TYPE(i) = Book -> where DTYPE = 'BOOK'으로 쿼리 나감

ENUM을 JPQL에 적을거면 패키지 명을 포함해야 한다.

---

조건식

case 식

기본 CASE 식

단순 CASE 식 - 값이 같으면 true

 

COALESCE: 하나씩 조회해서 A가 NULL이면 B를 반환

 

NULLIF: A,B가 같으면 null 반환, 다르면 A 반환

---

사용자 정의 함수 호출

하이버네이트6 이전 버전에서는 사용 전 방언에 추가해야 한다.

사용하는 DB 방언을 상속받고, 사용자 정의 함수를 등록한 후 아래와 같이 사용한다.

select function('group_concat', i.name) from Item i

 

 

3.0 이후부터는 따로 방언 상속받아 구현할 필요도 없고 아래와 같이 바로 사용 가능하다.

select group_concat(m.username) from Member m

---

참고 자료 & 이미지 출처
자바 ORM 표준 JPA 프로그래밍 - 기본편 (김영한 님)