[김영한 - JPA 기본] #10 JPQL - 1

JPQL 소개

JPA Criteria, QueryDSL은 자바코드를 짜서 JPQL을 빌드해주는 제네레이터 클래스의 모임
- JPQL 이 위 두 문법의 근간이다 !!
예를 들어 나이가 18살 이상인 회원을 검색하고 싶다면?
과 같은 조건이 들어간 쿼리를 하고 싶을 때
테이블이 아닌 객체를 대상으로 검색한다
SQL과 문법 유사, SELECT, FROM, WHERE, GROUP BY, HAVING, JOIN 지원한다
SQL을 추상화해서 특정 DB SQL 문법 (방언, Dialect) 에 의존하지 않는다

JPQL 예시 코드

예시 1

String jpql = "select f from Folder as f where f.name like 'folder%' ";
List<Folder> folders = em.createQuery(jpql, Folder.class).getResultList();

실행된 SQL

/* select
        f
    from
        Folder as f
    where
        f.name like 'folder%'  */ select
            folder0_.id as id1_2_,
            folder0_1_.IS_HIDDEN as IS_HIDDE2_2_,
            folder0_1_.name as name3_2_,
            folder0_1_.PARENT_ID as PARENT_I4_2_,
            folder0_.IS_SHARED as IS_SHARE1_3_
        from
            Folder folder0_
        inner join
            File folder0_1_
                on folder0_.id=folder0_1_.id
        where
            folder0_1_.name like 'folder%'

예시 2

String jpql = "select b from BookMark as b where b.size >= 10 ";
List<BookMark> bookMarkList = em.createQuery(jpql, BookMark.class).getResultList();
bookMarkList.forEach(out::println);

실행된 SQL

/* select
        b
    from
        BookMark as b
    where
        b.size >= 10  */ select
            bookmark0_.id as id1_2_,
            bookmark0_1_.IS_HIDDEN as IS_HIDDE2_2_,
            bookmark0_1_.name as name3_2_,
            bookmark0_1_.PARENT_ID as PARENT_I4_2_,
            bookmark0_.size as size1_1_,
            bookmark0_.url as url2_1_
        from
            BookMark bookmark0_
        inner join
            File bookmark0_1_
                on bookmark0_.id=bookmark0_1_.id
        where
            bookmark0_.size>=10

JPA Criteria

JPQL 빌더 중 하나
JPA 공식 스펙으로 문자열 코딩이 아닌 자바로 JPQL 쿼리문 작성 가능
단점 : 너무 복잡하다, 작성하고서도 읽기 힘든 유지보수 힘듬
QueryDSL 사용 권장

네이티브 SQL 소개

예시

List resultList = em.createNativeQuery("SELECT ID, NAME FROM FILE").getResultList();

발생 쿼리

/* dynamic native SQL query */ SELECT
    ID,
    NAME
FROM
    FILE

참고로 영한님은 JPA에서 제공하는 위 API보다는 SpringJdbcTemplate을 주로 사용한다고 하신다 !

JDBC, 스프링 JdbcTemplate, 마이바티스

그 외 위와 같이 JDBC를 직접 연결하거나 등의 사용법으로 사용 가능한데

이떄 적절하게 영속성 컨텍스트를 직접 flush 해주지 않으면 원하는 결과를 얻을 수 없을 떄가 있다

예를들어 한 트랜잭션 안에 insert 후 native하게 select 해올 때

JPQL 예시 코드

예시 1 : 다건

TypedQuery<Member> typedQuery = em.createQuery("select m from Member as m where m.age > 18", Member.class);
List<Member> findMemberList = typedQuery.getResultList();

예시 2 : 단건

TypedQuery<Member> query = em.createQuery("select m from Member as m where m.age > 18", Member.class);
Member singleResult = query.getSingleResult();

getSingleResult는 단 하나만 존재해야한다.. (영한님도 별로라고 생각하는 API이다 하하) spring data jpa는 위 API를 try-catch로 감싸준다고 한다

없을 경우 예외

javax.persistence.NoResultException: No entity found for query

2개 이상일 경우 예외

NonUniqueResultException: query did not return a unique result: 2

예시 3 : 집계

TypedQuery<Long> query = em.createQuery("select count(m) from Member as m where m.age > 10", Long.class);
Long singleResult = query.getSingleResult();

count 함수는 Long을 반환한다 !

예시 4 : 파라미터 바인딩: 문자 이름

Member findMember =
    em.createQuery("select m from Member as m where m.name = :username", Member.class)
        .setParameter("username", "user a")
        .getSingleResult();

out.println("findMember = " + findMember);

예시 5 : 파라미터 바인딩: 포지션

Member findMember =
    em.createQuery("select m from Member as m where m.name = ?1", Member.class)
        .setParameter(1, "user a")
        .getSingleResult();

메서드 체이닝을 지원한다! enum등을 포함해서 항상 position 보다는 name 방식을 채택하자

예시 6: 일부 속성만을 가져옴

List<String> findUsernames = em.createQuery("select m.name from Member m ", String.class).getResultList();

List<Integer> findUserAges = em.createQuery("select m.age from Member m ", Integer.class).getResultList();

Query query = em.createQuery("select m.name, m.age from Member m ");
List result = query.getResultList();

프로젝션

SELECT 절에 조회할 대상을 지정하는 것
DISTINCT로 중복 제거

- 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 -- 스칼라 타입 프로젝션 (숫자, 문자 등 기본 데이터 타입)

프로젝션 - 여러값 조회

1-1 Query 타입으로 조회

Query query = em.createQuery("select m.name, m.age from Member m ");
List result = query.getResultList();

for (Object o : result) {
    Object[] arr = (Object[])o;
    out.println("user name = " + arr[0]);
    out.println("user age = " + arr[1]);
}

1-2 Obejct[] 타입으로 조회

Query query = em.createQuery("select m.name, m.age from Member m ");
List<Object[]> result = query.getResultList();

for (Object[] objects : result) {
    out.println("user name = " + objects[0]);
    out.println("user age = " + objects[1]);
}

2 DTO: new 명령어로 조회

@AllArgsConstructor
@ToString
public class MemberDto {
	private String name;
	private int age;
}

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

TypedQuery<MemberDto> query =
    em.createQuery("select new jpql.MemberDto(m.name, m.age) from Member m ", MemberDto.class);
List<MemberDto> resultList = query.getResultList();

for (MemberDto memberDto : resultList) {
    out.println("memberDto = " + memberDto);
}

패키지 명을 포함한 풀 클래스명 입력한다

JPQL: 페이징 API

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

핵심 코드

String jpql = "select m from Member m order by m.age asc ";

List<Member> resultList = em.createQuery(jpql, Member.class)
    .setFirstResult(3)
    .setMaxResults(20)
    .getResultList();

전체 코드

Member[] userArr = new Member[101];

		for (int i = 1; i <= 100; i++) {
			userArr[i] = Member.builder()
				.name("user " + i)
				.age(i)
				.build();
			em.persist(userArr[i]);
		}

		em.flush();

		String jpql = "select m from Member m order by m.age asc ";

		List<Member> resultList = em.createQuery(jpql, Member.class)
			.setFirstResult(3)
			.setMaxResults(20)
			.getResultList();

		for (Member findMember : resultList) {
			out.println(findMember);
		}

JPQL: 조인

내부 조인: inner

select m from Member m inner join m.team t

inner 는 생략 가능
위 예시에서 Member는 클래스명, join 뒤에 오는 m.team은 필드명이다 !!
- 대소문자 주의 !
외부 조인: left (outer), right (outer)

select m from Member m left join m.team t

세타 조인:

select m from Member m, Team t where m.name = t.name

카티션 곱 모든 경우의 수를 발생시킨다

ON절을 활용한 조인 (JPA 2.1부터 지원)

1. 조인 대상 필터링
1. 연관관계 없는 엔티티 외부 조인(하이버네이트 5.1부터)

조인 대상 필터링

예) 회원과 팀을 조인하면서, 팀 이름이 A인 팀만 조인

JPQL

SELECT m, t FROM Member m LEFT JOIN m.team t on t.name = 'A'

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

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

JPQL 서브쿼리

나이가 평균보다 많은 회원

select m from Member m where m.age > (select avg(m2.age) from Member m2)

평균만 빼올때는 아래와 같다

String jpql2 = "select avg(m.age) from Member m";
Double avg = em.createQuery(jpql2, Double.class).getSingleResult();

한 건이라도 주문한 고객

select m from Member m where (select count(o) from Order o where m = o.member) > 0

JPQL: 서브 쿼리 지원 함수

[NOT] EXISTS (서브쿼리 절): 서브쿼리에 결과가 존재하면 참
{ALL ANY SOME} (서브쿼리 절)
- ALL 모두 만족해야 참
- ANY SOME 조건을 하나라도 만족하면 참
[NOT] IN (서브쿼리 절): 서브쿼리 결과 줭 하나라도 같은 것이 있으면 참
팀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로 조회시 영속성 컨텍스트에 저장되는가?

그렇다 ! 저장이 된다

아래는 영속성 컨텍스트에 저장이 되는지를 실험해본 내용이다

Member member = Member.builder()
    .name("swcho")
    .age(30)
    .build();

em.persist(member);

em.flush();
em.clear();

Member findMember = em.createQuery("select m from Member m where m.name = :username", Member.class)
    .setParameter("username", "swcho")
    .getSingleResult();

findMember.setAge(31); // #1

#1 에서 더티체킹이 된다면 영속성 컨텍스트에 저장된 것이다 !

결과

    /* update
        jpql.Member */ update
            Member
        set
            age=?,
            name=?,
            TEAM_ID=?
        where
            id=?
13:35 TRACE o.h.type.descriptor.sql.BasicBinder - binding parameter [1] as [INTEGER] - [31]
13:35 TRACE o.h.type.descriptor.sql.BasicBinder - binding parameter [2] as [VARCHAR] - [swcho]
13:35 TRACE o.h.type.descriptor.sql.BasicBinder - binding parameter [3] as [BIGINT] - [null]
13:35 TRACE o.h.type.descriptor.sql.BasicBinder - binding parameter [4] as [VARCHAR] - [4028b8817e853791017e853794c80000]

위 쿼리에서 보면 알수 있다시피 영속성 컨텍스트에 저장이 되었다

JPQL 타입 표현

항목	내용
문자	‘HELLO’, ‘She’’s’
숫자	10L(Long), 10D(Double), 10F(Float)
Boolean	TRUE, FALSE
ENUM	jpabook.MemberType.Admin (패키지명 포함)
엔티티 타입	TYPE(m) = Member (상속 관계에서 사용)

예시 1

Member userA = Member.builder()
    .name("user a")
    .age(15)
    .type(MemberType.ADMIN)
    .build();

em.persist(userA);
em.flush();
em.clear();

String query = "select m.name, 'Hello', TRUE from Member m where m.type = jpql.MemberType.ADMIN";
List<Object[]> result = em.createQuery(query).getResultList();

for (Object[] objects : result) {
    out.println("object = " + objects[0]);
    out.println("object = " + objects[1]);
    out.println("object = " + objects[2]);
}

예시 1-2 : parameter 로 수정

String query = "select m.name, 'Hello', TRUE from Member m where m.type = :userType";
List<Object[]> result =
    em.createQuery(query)
        .setParameter("userType", MemberType.ADMIN)
        .getResultList();

예시 2: 엔티티 타입

List<Item> resultList =
    em.createQuery("select i from Item i where type(i) = Book", Item.class)
    .getResultList();

for (Item findItem : resultList) {
    out.println("findItem = " + findItem);
}

강의에서 보던 내용과 달리 아래처럼 left outer join된 쿼리가 나가게 된다 !
- 알고보니 SINGLE_TABLE 전략으로 되어 있었다..

select
    i
from
    Item i
where
    type(i) = Book */ select
        item0_.ITEM_ID as ITEM_ID2_2_,
        item0_.name as name3_2_,
        item0_.price as price4_2_,
        item0_1_.artist as artist1_0_,
        item0_2_.author as author1_1_,
        item0_2_.isbn as isbn2_1_,
        item0_3_.actor as actor1_3_,
        item0_3_.director as director2_3_,
        item0_.DTYPE as DTYPE1_2_
    from
        Item item0_
    left outer join
        Album item0_1_
            on item0_.ITEM_ID=item0_1_.ITEM_ID
    left outer join
        Book item0_2_
            on item0_.ITEM_ID=item0_2_.ITEM_ID
    left outer join
        Movie item0_3_
            on item0_.ITEM_ID=item0_3_.ITEM_ID
    where
        item0_.DTYPE='Book'

JPQL 조건식

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

예

String query =
    "select " +
            " case when m.age <= 10 then '학생요금' " +
            " 	   when m.age >= 60 then '경로요금' " +
            " 	   else '일반요금' " +
            " end as result " +
    "from Member m";

List<String> resultList = em.createQuery(query, String.class).getResultList();

for (String result : resultList) {
    out.println("result = " + result);
}

COALSE

하나씩 조회해서 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 용도)

문자열 결합 CONCAT,

select concat('a', 'b', 'c') from Member m  -- 문자열 결합
select size(t.members) from Team t

||은 하이버네이트에서 지원하는 함수이다

select size(t.members) from Team t          -- team에 속한 멤버들의 사이즈

index
@OrderColumn 과 연관된 함수, index를 구할 떄 사용하는데 @OrderColumn 을 지양하기 때문에 굳이 사용할 일은 없어보인다

JPQL 사용자 정의 함수

MySQLDialect 등에 보연 방언을 등록하는 부분을 볼 수 있다

예시

등록 예시

public class MyH2Dialect extends H2Dialect {

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

<property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect"/>

속성도 바꾸어주어야 한다 !!

등록된 함수 사용하기

select function('group_concat', m.name) from Member m
select group_concat(m.name) from Member m

JPQL 소개

JPQL 예시 코드

JPA Criteria

네이티브 SQL 소개

JDBC, 스프링 JdbcTemplate, 마이바티스

JPQL 예시 코드

프로젝션

프로젝션 - 여러값 조회

JPQL: 페이징 API

JPQL: 조인

ON절을 활용한 조인 (JPA 2.1부터 지원)

조인 대상 필터링

연관관계 없는 엔티티 외부 조인

JPQL 서브쿼리

JPQL: 서브 쿼리 지원 함수

JPA 서브쿼리의 한계

참고! JPQL로 조회시 영속성 컨텍스트에 저장되는가?

JPQL 타입 표현

JPQL 조건식

기본 CASE 식

단순 CASE 식

COALSE

NULLIF

JPQL 기본 함수

JPQL 사용자 정의 함수

Share this post