[JPA] 객체지향 쿼리 언어 - 기본 문법

김영한님의 자바 ORM 표준 JPA 프로그래밍 - 기본편 정리

1. JPQL

- JPQL은 객체지향 쿼리 언어다. 따라서 테이블을 대상으로 쿼리하는 것이 아니라 엔티티 객체를 대상으로 쿼리한다.

- JPQL은 SQL을 추상화해서 특정 데이터베이스 SQL에 의존하지 않는다.

- JPQL은 결국 SQL로 변환된다.

 

2. 문법

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

- 엔티티와 속성은 대소문자 구문 O(Member, age)

- JPQL 키워드는대소문자 구분 X(SELECT, FROM, where)

- 엔티티 이름 사용, 테이블 이름이 아님(Member)

- 별칭은 필수(m) (as는 생략 가능)

 

TypeQUery, Query

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

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

// select 하는 m이 Member.class로 명확
TypedQuery<Member> query = em.createQuery("select m from Member m", Member.class);

// select하는 username은 String, age는 int로 반환타입이 불명확
Query query2 = em.createQuery("select m.username,m.age from Member m");

 

3. 결과 조회 API

- query.getResultList() :

(1) 결과가 하나 이상일 때, 리스트 반환

(2) 결과가 없으면 빈 리스트 반환

- query.getSingleResult(): 결과가 정확히 하나, 단일 객체 반환

(1) 결과가 없으면: javax.persistence.NoResultException

(2) 둘 이상이면: javax.persistence.NonUniqueResultException

- 파라미터 바인딩

(1) 이름 기준

(2) 위치 기준 (사용 금지)

// 단순 쿼리
List<Member> result = em.createQuery("select m from Member m", Member.class)
                .getResultList();
Member result2 = em.createQuery("select m from Member m", Member.class)
        .getSingleResult();

// 위치 기준 파라미터 바인딩도 있는데 enum과 같이 밀리는 비슷한 문제가 발생해서 사용 안함
// 이름 기준 파라미터 바인딩
Member result2 = em.createQuery("select m from Member m where m.username=:username", Member.class)
            // 변수명, 넣을 값
            .setParameter("username","member1")
            .getSingleResult();

 

4. 프로젝션

- 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로 중복 제거

 

5. 프로젝션 - 여러 값 조회

- SELECT m.username, m.age FROM Member m

(1) Query 타입으로 조회

(2) Object[] 타입으로 조회

(3) new 명령어로 조회

List<MemberDTO> resultList = em.createQuery("select new jpql.UserDTO(m.username,m.age)
                    from Member m", MemberDTO.class)
                    .getResultList();

 

- 단순 값을 DTO로 바로 조회

- SELECT new jpabookjpql.UserDTO(m.username, m.age) FROM Member m

- 패키지 명을 포함한 전체 클래스 명 입력

- 순서와 타입이 일치하는 생성자 필요

 

6. 페이징

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

(1) setFirstResult(int startPosition): 조회 시작 위치(0부터 시작)

(2) setMaxResults(int maxResult): 조회할 데이터 수

String jpql = "select m from Member m order by m.name desc";
List<Member> resultList = em.createQuery(jpql, Member.class)
		.setFirstResult(10)
                .setMaxResult(20)
                .getResultList();

 

7. 조인

// 내부 조인
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 절을 활용한 조인

(1) 조인 대상 필터링

(2) 연관관계 없는 엔티티 외부 조인

// 1. 조인 대상 필터링
// 예) 회원과팀을 조인하면서, 팀 이름이 A인 팀만 조인
SELECT m, t FROM Member m LEFT JOIN m.team t on t.name = 'A' // JPQL

SELECT m.*, t.* FROM Member m LEFT JOIN Team t ON m.TEAM_ID = t.id and t.name='A' // SQL

// 2. 연관관계 없는 엔티티 외부 조인
// 예) 회원의 이름과 팀의 이름이 같은 대상 외부 조인
SELECT m, t FROM Member m LEFT JOIN Team t on m.username = t.name // JPQL

SELECT m.*, t.* FROM Member m LEFT JOIN Team t ON m.username = t.name // SQL

 

8. 서브 쿼리

- 서브 쿼리 지원 함수

(1) [NOT] EXISTS (subquery)

서브쿼리에 결과가 존재하면 참

 

(2) {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.orderAmout > ALL (select p.stockAmount from Product p)

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

 

- 서브 쿼리 한계

(1) JPA는 WHERE, HAVING 절에서만 서브 쿼리 사용 가능

(2) SELECT 절도 가능(하이버네이트에서 지원)

(3) FROM 절의 서브 쿼리는 현재 JPQL에서 불가능 - 조인으로 풀 수 있으면 풀어서 해결

em.createQuery("select m from Member m where m.age > (select avg(m2.age) from Member m2)",Member.class)

 

9. JPQL 타입 표현과 기타식

- JPQL 타입 표현

(1) 문자: 'HELLO', 'She"s'

(2) 숫자: 10L(Long), 10D(Double), 10F(Float)

(3) Boolean: TRUE, FALSE

(4) ENUM: jpabook.MemberType.Admin(패키지명 포함)

(5) 엔티티 타입: TYPE(m) = Member (상속 관계에서 사용)

 

- 기타식

(1) SQL과 문법이 같은 식

(2) EXISTS, IN

(3) AND, OR, NOT

(4) =, >, >=, <, <=, <>

(5) BETWEEN, LIKE, IS NULL

 

10. 조건식

- 기본 CASE 식

- 단순 CASE 식

- COALESCE: 하나씩 조회해서 null이 아니면 반환

- NULLIF: 두 값이 같으면 null 반환, 다르면 첫번째 값 반환

// coalesce
em.createQuery("select coalesce(m.username,'이름 없는 회원') from Member m",String.class);

// nullif
em.createQuery("select nullif(m.username,'관리자') from Member m",String.class);

 

11. JPQL 기본 함수, 사용자 정의 함수

- 기본 함수

(1) CONCAT

(2) SUBSTRING

(3) TRIM

(4) LOWER, UPPER

(5) LENGTH

(6) LOCATE

(7) ABS, SQRT, MOD

(8) SIZE, INDEX(JPA용도)

 

- 사용자 정의 함수 호출

(1) 하이버네이트는 사용 전 방언에 추가해야한다.

(2) 사용하는 DB 방언을 상속받고, 사용자 정의 함수를 등록한다.

package dialect;

import org.hibernate.dialect.H2Dialect;
import org.hibernate.dialect.function.StandardSQLFunction;
import org.hibernate.type.StandardBasicTypes;

public class MyH2Dialect extends H2Dialect {
    public MyH2Dialect() {
        registerFunction("group_concat", new StandardSQLFunction("group_concat"
        	, StandardBasicTypes.STRING));
    }
}

// function으로 함수 호출 명시, 함수명, 파라미터
em.createQuery("select function('group_concat', i.name) from Item i", String.class);