기본 문법과 기능
- 객체 지향 쿼리 언어이기 때문에, 엔티티 객체를 대상으로 쿼리
- SQL을 추상화했기때문에 특정 DB에 의존하지 않음.
- JPQL은 결국 SQL로 변환
JPQL 문법
- select m from Member as m where m.age > 18
- 엔티티와 속성은 대소문자 구분 O (Member, age)
- JPQL 키워드는 대소문자 구분 X (SELECT,FROM,where)
- 엔티티 이름 사용, 테이블 이름이 아니다!(Member)
- 별칭은 필수(m)(as 생략 가능)
집합과 정렬
select
COUNT(m), //회원수
SUM(m.age), //나이 합
AVG(m.age),
MAX(m.age),
MIN(m.age)
from Member m
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
- 둘 이상이면: javax.persistence.NonUniqueResultException
파라미터 바인딩 - 이름 기준, 위치 기준
SELECT m FROM Member m where m.username=:username
query.setParameter("username",usernameParam);
SELECT m FROM Member m where m.username=?1
query.setParameter(1,usernameParam);프로젝션(SELECT)
- SELECT 절에 조회할 대상을 지정하는 것
- 프로젝션 대상: 엔티티, 임베디드 타입, 스칼라 타입(숫자 문자 등)
- SELECT m FROM Memberm m -> 엔티티 프로젝션
- SELECT m.team FROM Member m -> 엔티티 프로젝션
- SELECT m.address FROM Member m -> 임베디드 타입 프로젝션
- SELECT m.username, m.age FROM Member m -> 스칼라 타입 프로젝션
- DISTINCT로 중복 제거
프로젝션 - 여러 값 조회
- SELECT m.username, m.age FROM Member m
- Query 타입으로 조회
- Object[] 타입으로 조회
- new 명령어로 조회
- 단순 값을 DTO로 조회
- 기본 엔티티로 조회할 경우("select m.username,m.age from Member", Member.class)
- DTO로 조회할 경우("select new jpql.MemberDTO(m.username,m.age from Member m",MemberDTO.class)
- 패키지 명을 포함한 전체 클래스 명 입력
- 순서와 타입 일치하는 생성자 필요
페이징 API
- JPA는 페이징을 다음 주 API로 추상화
- setFirstResult(int startPosition): 조회 시작 위치
- setMaxResults(int maxResult): 조회할 데이터 수
- 페이징 API 예시
// 페이징 쿼리
em.createQuery("select m from Member m order by m.age desc", Member.class)
.setFirstResult(0)
.setMaxResults(10)
.getResultList();조인
- 내부 조인:
SELECT m FROM Member m [INNER] JOIN m.team t- team 이 없을 경우 INNER 뒤 문장 사라짐
- 외부 조인:
SELECT m FROM Member m LEFT [OUTER] JOIN m.team t- team 이 없을 경우 null값으로 조회
- 세타 조인:
SELECT count(m) from Member m, Team t where m.usernam = t.name
조인 - ON 절
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'
2. 연관관계 없는 엔티티 외부 조인
- 예) 회원의 이름과 팀의 이름이 같은 대상 외부 조인
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
서브 쿼리
- 나이가 평균보다 많은 회원
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]EXISTS (subquery): 서브쿼리에 결과가 존재하면 참
- {ALL|ANY|SOME}(subquery)
- ALL 모두 만족하면 참
- ANY,SOME 같은 의미, 조건을 하나라도 만족하면 참
- [NOT] IN (subquery): 서브쿼리의 결과 중 하나라도 같은 것이 있으면 참
서브 쿼리 예제
- 팀A 소속인 회원
select m from Member m
where exists (select t from m.team t where t.name='팀A') - 전체 상품 각각의 재고보다 주문량이 많은 주문들
select o from Order o
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 서브 쿼리 한계
- JPA는 WHERE,HAVING 절에서만 서브 쿼리 사용 가능
- SELECT 절도 가능(하이버네이트에서 지원)
- FROM 절의 서브 쿼리는 현재 JPQL에서 불가능
- 조인으로 풀수 있으면 풀어서 해결
JPQL 타입 표현
- 문자: 'HELLO', 'She''s'
- 숫자 : 10L(Long),10D(Double),10F(Float)
- Boolean: TRUE,FALSE
- ENUM: jpabook.MemberType.Admin(패키지명 포함)
- 엔티티 타입: TYPE(m) = Member(상속 관계에서 사용)
조건식 - CASE식
기본 CASE식
select
case when m.age <= 10 then '학생요금'
when m.age >= 60 then '경로요금'
else '일반요금'
end
from Member m
단순 CASE식
select
case t.name
when '팀A' then '인센티브110%'
when '팀B' then '인센티브120%'
else '인센티브105%'
end
from Team t
- COALESCE: 하나씩 조회해서 null이 아니면 반환
- NULLIF: 두 값이 같으면 null, 다르면 첫번째 값 반환
사용자 이름이 없으면 이름 없는 회원을 반환
select coalesce(m.username,'이름 없는 회원') from Member m
사용자 이름이 '관리자'면 null, 나머지는 본인의 이름을 반환
select NULLIF(m.username, '관리자') from Member m
JPQL 기본 함수
- CONCAT
- SUBSTRING
- TRIM
- LOWER,UPPER
- LENGTH
slowly But Surely