JPA - 객체 지향 쿼리 언어(1)

JPQL 개요

테이블이 아닌 객체를 대상으로 검색하는 객체 지향 쿼리
SQL을 추상화하여 특정 데이터베이스 SQL에 의존하지 않음
쿼리시 테이블이 아닌 엔티티 객체를 대상으로 쿼리
- JPQL은 엔티티 객체를 대상으로 쿼리
- SQL은 데이터베이스 테이블을 대상으로 쿼리

  
String jpql = "select m from Member m where m.age > 18";
List<Member> result =
  em.createQuery(jpql, Member.class).getResultList();

  
select
    m.id as id,
    m.age as age,
    m.USERNAME as USERNAME,
    m.TEAM_ID as TEAM_ID
from
    Member m
where
    m.age>18

JPQL 기본 문법과 기능

  
-- 기본문법
select_문 :: =
    select_절
    from_절
    [where_절]
    [groupby_절]
    [having_절]
    [orderby_절]
update_문 :: = update_절 [where_절]
delete_문 :: = delete_절 [where_절]

-- 기본적인 함수 지원
select
    COUNT(m),   //회원수
    SUM(m.age), //나이 합
    AVG(m.age), //평균 나이
    MAX(m.age), //최대 나이
    MIN(m.age)  //최소 나이
from Member m

-- 기본적인 정렬 지원
GROUP BY, HAVING
ORDER BY

  
select m from Member as m where m.age > 18

엔티티와 속성은 대소문자를 구분 함
JPQL 키워드는 대소문자를 구분하지 않음
엔티티 이름을 사용하며 테이블의 이름이 아님
별칭이 필수(as는 생략 가능)

TypeQuery, Query

TypeQuery
- 반환 타입이 명확할 떄 사용
Query
- 반환 타입이 명확하지 않을 떄 사용

  
TypedQuery<Member> query =
    em.createQuery("SELECT m FROM Member m", Member.class);

Query query =
    em.createQuery("SELECT m.username, m.age from Member m");

결과 조회 API

query.getResultList()
- 결과가 하나 이상일떄 리스트를 반환
- 결과가 없으면 빈 리스트 반환
query.getSingleResult()
- 경과가 정확히 하나일떄 단일 객체 반환
- 결과가 없으면 javax.persistence.NoResultException 발생
- 결과가 2개 이상이면 javax.persistence.NonUniqueResultException 발생

파라미터 바인딩

  
// 이름으로 바인딩
String jpql = "SELECT m FROM Member m where m.username=:username";
TypedQuery<Member> query =
    em.createQuery(jpql, Member.class)
      .setParameter("username", usernameParam);

// 인덱스로 바인딩
String jpql = "SELECT m FROM Member m where m.username=?1";
TypedQuery<Member> query =
    em.createQuery(jpql, Member.class)
      .setParameter(1, usernameParam);

인덱스로 바인딩하는 경우 인덱스를 밀려 파라미터를 설정할수 있으므로 실수를 미연에 방지하기 위해 이름으로 바인딩 하는것을 추천

프로젝션

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

프로젝션 대상 : 엔티티, 임베디드 타입, 스칼라 타입(숫자, 문자등 기본 데이터 타입)
SELECT m FROM Member m -> 엔티티 프로젝션
SELECT m.team FROM Member m -> 엔티티 프로젝션
- 엔티티 타입은 별도의 테이블이 존재하므로, jpql에서 명시적으로 join을 하지 않아도 sql로 변환할떄 자동으로 해당 테이블을 join 하도록 sql이 변환됨
- 유지보수를 위해 명시적으로 jpql에도 join을 명시하여 생성되는 sql과 싱크를 맞추는것이 좋음
SELECT m.address FROM Member m -> 임베디드 타입 프로젝션
SELECT m.username, m.age FROM Member m -> 스칼라 타입 프로젝션
DISTINCT로 중복 제거

하나의 대상 말고 여러 대상을 조회하고 싶을떈 아래와 같은 방법이 있음

Query 타입으로 조회
Object[] 타입으로 조회
new 명령어로 조회
- 단순 값을 DTO로 바로 조회
- 패키지 명을 포함한 전체 클래스명 입력 필요
- 순서와 타입이 일치하는 생성자 필요

  
// new 명령어를 통해 DTO로 변환하여 조회
public class UserDTO {
  private String username;
  private int age;

  public UserDTO(Strig username, int age) {
    this.username = username;
    this.age = age;
  }
}

...

String jpql =
  "SELECT new jpabook.jpql.UserDTO(m.username, m.age) FROM Member m"

페이징

JPA는 페이징을 다음 두 API로 추상화

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

  
// 10번쨰 부터 20개를 가져옴
String jpql = "select m from Member m order by m.name desc";
List<Member> resultList =
  em.createQuery(jpql, Member.class)
    .setFirstResult(10)
    .setMaxResults(20)
    .getResultList();

조인

내부 조인
- SELECT m FROM Member m [INNER] JOIN m.team t
- INNER 는 생략 가능
외부 조인
- SELECT m FROM Member m LEFT [OUTER] JOIN m.team t
- OUTER 는 생략 가능
세타 조인
- SELECT count(m) FROM Member m, TEAM t WHERE m.username = t.name

조인 ON 절

ON절을 활용한 조인(JPA 2.1 부터 지원)
- 조인 대상 필터링
- 연관관계 없는 엔티티 외부 조인(하이버네이트 5.1 부터 지원)

조인 대상 필터링 예시

  
-- 회원과 팀을 조인하면서 팀 이름이 A인 팀만 조인

-- 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

서브 쿼리

[NOT] EXISTS (subquery): 서브쿼리에 결과가 존재하면 참
- {ALL ANY SOME} (subquery)
- ALL 모두 만족하면 참
- ANY, SOME: 같은 의미, 조건을 하나라도 만족하면 참
[NOT] IN (subquery): 서브쿼리의 결과 중 하나라도 같은 것이 있으면 참

서브쿼리 예시

  
-- 나이가 평균보다 많은 회원
select m
from Member m
where m.age > (select avg(m2.age) from Memeber m2)

-- 한 건이라도 주문한 고객
select m
from Member m
where (select count(o) from Order o where m = o.member) > 0

-- 팀이름이 A에 소속된 회원
select m
from Member m
where exists (select t from m.team t where t.name = 'A')

-- 전체 상품 각각의 재고보다 주문량이 많은 주문들
select m
from Member m
where o.orderAmount > all (select p.stockAmount from Product p)

-- 어떤 팀이든 팀에 소속된 회원
select m
from Member m
where m.team = any (select t from Team t)

서브쿼리의 한계

JPA는 WHERE, HAVING 절에서만 서브 쿼리 사용가능
SELECT 절의 경우 하이버네이트 사용시 사용 가능
FROM 절의 서브쿼리는 JPQL에서 불가능
- 조인으로 풀 수 있으면 풀어서 해결
하이버네이트 6 부터는 FROM 절의 서브쿼리를 지원

조건식(CASE 식)

  
-- 기본 CASE 식
select
  case
    when m.age <= 10 then '학생'
    when m.age >= 60 then '경로'
    else '일반'
  and
from Member m

-- 단순 CASE 식
select
  case t.name
    when '팁A' then '인센티브110%'
    when '팁B' then '인센티브120%'
    else '인센티브105%'
  and
from Team t

-- COALESCE: 하나씩 조회해서 null이 아니면 반환
-- 사용자 이름이 없으면 이름 없는 회원을 반환
select coalesce(m.username, '이름없는회원')
from Member m

-- NULLIF: 두 값이 같으면 null 반환, 다르면 첫번째 값 반환
-- 사용자 이름이 관리자면 null을 반환하고 나머지는 본인의 이름을 반한
select NULLIF(m.username, '관리자')
from Member m

JPQL 기본 함수

CONCAT
SUBSTRING
TRIM
LOWER, UPPER
LENGTH
LOCATE
ABS, SQRT, MOD
SIZE, INDEX(JPA 용도)

사용자 정의 함수를 지정하여 호출할 수 있음

하이버네이트는 사용전 방언에 추가해야 함
- 사용하는 DB 방언을 상속받고, 사용자 정의 함수를 등록해야 함

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

참고

자바 ORM 표준 JPA 프로그래밍(김영한)

JPA - 객체 지향 쿼리 언어(1)

JPQL 개요

JPQL 기본 문법과 기능

TypeQuery, Query

결과 조회 API

파라미터 바인딩

프로젝션

페이징

조인

조인 ON 절

서브 쿼리

서브쿼리의 한계

조건식(CASE 식)

JPQL 기본 함수

Further Reading

JPA - 영속성 관리

JPA - 엔티티 매핑

JPA - 연관관계 매핑