[JPA] 11. JPQL - 기본문법과 기능

해당 글은 김영한님의 자바 ORM 표준 JPA 프로그래밍 - 기본편 - 인프런 | 강의를 수강하고 정리한 게시글입니다.

JPQL

: JPQL은 객체지향 쿼리 언어임으로 엔티티 객체를 대상으로 쿼리한다.

• JPQL은 SQL을 추상화해서 특정데이터베이스 SQL에 의존하지 않는다.
• JPQL은 결국 SQL로 변환된다.

JPQL 문법

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

집합과 정렬

• GROUP BY, HAVING, ORDER BY : 사용 가능

TypeQuery, Query

• TypeQuery: 반환 타입이 명확할 때 사용

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

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

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 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 DISTINCT ~)

여러 값 조회

\\ 예시
SELECT **m.username, m.age** FROM Member m

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

페이징 API

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

조인

• 내부 조인 :

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. 조인 대상 필터링
예시) 회원과 팀을 조인하면서, 팀 이름이 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.username = t.name

- 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
• ENM : jpabook.MemberType.Admin (패키지명 포함)
• 엔티티 타입: TYPE(m) = Member (상속 관계에서 사용)
  • 예시) select I from Item i where type(i) = Book
• 표준 SQL 은 웬만하면 다 지원함
  • SQL과 문법이 같은 식
  • EXISTS, IN
  • AND, OR, NOT
  • =, >, >=, <, <=, <>
  • BETWEEN, LIKE, IS NULL

조건식 - CASE 식

• 기본 CASE 식

select
    case when m.age <= 10 then '학생요금'
         when m.age >= 50 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 아니면 반환
  • 사용자 이름이 없으면 이름 없는 회원을 반환
  • 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 : 문자열에서 원하는 문자열의 위치 반환
  “select locate(‘de’, ’abcdefg’) From Member m” -> 4 반환
• ABS, SQRT, MOD : 수학 함수
• SIZE, INDEX(JPA 용도) : 컬랙션 사이즈 반환, INDEX는 사용 권장X

•