JPQL 기본 문법과 기능

JPQL 문법

• select m from Member as m where m.age > 18
• 엔티티와 속성은 대소문자 구분O (Member, age)
• JPQL 키워드는 대소문자 구분 X (SELECT, FROM, where)
• 엔티티 이름 사용, 테이블 이름이 아님 (Member)
• 별칭은 필수 (m) (as는 생략 가능)

---

 

집합과 정렬

• COUNT, SUM, AVG, MAX, MIN 등 가능
• GROUP BY, HAVING, ORDER BY 등 가능

---

 

TypeQuery, Query

• TypeQuery: 반환 타입이 명확할 때 사용
• Query : 반환 타입이 명확하지 않을 때 사용
  
  

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

---

 

파라미터 바인딩 - 이름 기준, 위치 기준

// 이름 기준
Member result = em.createQuery("SELECT m FROM Member m where m.username =:username", Member.class)
		.setParameter("username", usernameParam)
        .getSingleResult();
        
        
// 위치 기준
Member result = em.createQuery("SELECT m FROM Member m where m.username =?1", Member.class)
		.setParameter(1, usernameParam)
        .getSingleResult();

---

 

프로젝션

• 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 -> 스칼라 타입 프로젝션
• DISTINCT로 중복 제거

 

프로젝션 - 여러 값 조회

• SELECT m.username, m.age FROM Member m
• 1. Query 타입으로 조회
• 2. Object[] 타입으로 조회

// Object[] 타입으로 조회
List resultList = em.createQuery("select m.username, m.age from Member m", Member.class)
		.getResultList();
       
Object o = resultList.get(0);
Object[] result = (Object[]) o;


// Generic 사용 시 코드 줄일 수 있음
List<Object[]> resultList = em.createQuery("select m.username, m.age from Member m", Member.class)
		.getResultList();
        
Object[] result = resultList.get(0);

• 3. new 명령어로 조회
  • 단순 값을 DTO로 바로 조회
    SELECT new 패키지명.DTO 클래스명(m.username, m.age) FROM Member m
  • 패키지 명을 포함한 전체 클래스 명 입력
  • 순서와 타입이 일치하는 생성자 필요

---

 

페이징 API

• JPA는 페이징을 다음 두 API로 추상화
• setFirstResult(int startPosition) : 조회 시작 위치 (0부터 시작)
• setMaxResults(int maxResult) : 조회할 데이터 수 

// 페이징 쿼리
List<Member> result = em.createQuery("select m from Member m order by m.age desc", Member.class)
		.setFirstResult(10)
        .setMaxResults(20)
        .getResultList();

 

---

 

조인

• 내부 조인:
  SELECT m FROM Member m [INNER] JOIN m.team t
• 외부 조인:
  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 절

• ON절을 활용한 조인 (JPA 2.1부터 지원)
  • 1. 조인 대상 필터링
  • 2. 연관관계 없는 엔티티 외부 조인 (하이버네이트 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

 

---

 

서브 쿼리

• 나이가 평균보다 많은 회원

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 절도 가능 (하이버네이트에서 지원)
• 하이버네이트 6부터 FROM 절의 서브 쿼리가능
  • 이전 버전은 조인으로 풀 수 있으면 풀어서 해결

---

 

JPQL 타입 표현

• 문자: 'HELLO', 'She''s' ('을 표현하고 싶으면 '을 2번 쓰기)
• 숫자: 10L(Long), 10D(Double) 10F(Float)
• Boolean: TRUE, FALSE
• ENUM: jpabook.MemberType.Admin (패키지명 포함)
  • @Enumerated(EnumType.STRING) (기본 값이 ORDINAL로 되어 있음)
• 엔티티 타입: TYPE(m) = Member (상속 관계에서 사용)

 

JPQL 기타

• SQL과 문법이 같은 식
• EXISTS, IN
• AND, OR, NOT
• =, >, >=, <, <=, <>
• BETWEEN, LIKE, IS NULL

---

 

조건식 - 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
• LOCATE
• ABS, SQRT, MOD
• SIZE, INDEX(JPA 용도)

 

사용자 정의 함수 호출

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

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