JPQL

JPA의 다양한 쿼리

지금까지 사용하던 EntityManager는 물론, 직접 쿼리를 작성해서 보낼 수 있는 방법도 있다.

JPQL
JPQ Criteria
QueryDSL
Native SQL
JDBC API 사용

JPQL

이걸 왜 쓰는가

JPA는 엔티티 객체 중심 개발이다. 따라서 검색 쿼리를 보내는게 조금 곤란한다.
검색을 할 때도, 테이블이 아닌 엔ㅌ티티 객체를 대상으로 검색해야한다. 하지만 모든 DB 데이터를 객체변환후 검색하는것은 불가능하다. 따라서 검색조건이 포함된 SQL이 필요하게 된다.

예제

 String jpql = "select m from Member m where m.age > 18"; 
 List<Member> result = em.createQuery(jpql, Member.class)
 .getResultList();
 
 실행된 SQL 
   select 
       m.id as id, 
       m.age as age, 
       m.USERNAME as USERNAME, 
       m.TEAM_ID as TEAM_ID 
   from 
   		Member m 
   where 
   		m.age>18 

이런 식으로 쿼리문을 직접 작성하면 되지만, 이는 동적쿼리, 즉 조건문에 따른 쿼리처리가 매우 어렵다는 단점이 있다.

Criteria

//Criteria 사용 준비
CriteriaBuilder cb = em.getCriteriaBuilder(); 
CriteriaQuery<Member> query = cb.createQuery(Member.class); 
//루트 클래스 (조회를 시작할 클래스)
Root<Member> m = query.from(Member.class); 
//쿼리 생성 CriteriaQuery<Member> cq = 
query.select(m).where(cb.equal(m.get("username"), “kim”)); 
List<Member> resultList = em.createQuery(cq).getResultList();

자바코드로 jpql을 작성할 수 있고 JPA의 표준스펙이지만, 너무 복잡하고 가독성이 떨어져서 유지보수가 안되고 실용성이 없다. 따라서 이 대신 QueryDSL을 사용한다.

QueryDSL

JPAFactoryQuery query = new JPAQueryFactory(em);
 QMember m = QMember.member; 
 List<Member> list = 
 query.selectFrom(m)
 .where(m.age.gt(18)) 
 .orderBy(m.name.desc())
 .fetch();

Native Query

String sql = 
“SELECT ID, AGE, TEAM_ID, NAME FROM MEMBER WHERE NAME = ‘kim’"; 
List<Member> resultList = 
em.createNativeQuery(sql, Member.class).getResultList();

순수쿼리문을 작성하고, createNativeQuery기능으로 안에다가 직접 쿼리를 날리는 기능이다.

JDBC Template 사용

JDBC를 사용하는 방법이다. 하지만 이 방법은 영속성 컨텍스트 관리를 JPA가 해주지 못하기때문에, 적당한 시점에서 자기가 직접 flush 해줘야한다.

Java Persistence Query Language

JPQL은 객체지향 쿼리 언어이고, 엔티티 객체를 대상으로 쿼리를 작성한다.

JPQL 문법

기본문법

select_문 :: = 
 select_절
 from_절
 [where_절] 
 [groupby_절] 
 [having_절] 
 [orderby_절] 
update_문 :: = update_절 [where_절] 
delete_문 :: = delete_절 [where_절]

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

쿼리문 예시

TypedQuery<Member> query = em.createQuery("select m from Member m where m.id = 10", Member.class);

Member singleResult = query.getSingleResult();
System.out.println("singleResult = " + singleResult);

결과조회

getResult = 결과가 하나 이상일 때 사용하고, 리스트 반환을 한다. 결과가 없으면 빈 리스트가 나온다.
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로 중복 제거

프로젝션 : 여러 값 조회

값을 여러 개 조회할때는 방법이 몇가지 있다
1. TypeQuery : 반환 타입이 명확할 때 사용
2. Query : 반환타입이 명확하지 않을 때 사용
3. Object 타입으로 조회
new 명령어로 조회
단순값을 DTO로 바로 조회할 수 있다.

//DTO
@Getter @Setter
public class MemberDto {

    private String username;
    private int age;

    public MemberDto(String username, int age) {
        this.username = username;
        this.age = age;
    }
}

List<MemberDto> result = em.createQuery("select new com.example.hellojpql.MemberDto(m.username, m.age) from Member m", MemberDto.class)
                    .getResultList();

            for (MemberDto memberDto : result) {
                System.out.println("memberDto = " + memberDto.getUsername());
                System.out.println("memberDto = " + memberDto.getAge());
            }

페이징

JPA는 페이징을 두 API로 추상화해놨다

• setFirstResult(int startPosition) : 조회 시작 위치 (0부터 시작)
• setMaxResults(int maxResult) : 조회할 데이터 수

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
• 외부 조인:
SELECT m FROM Member m LEFT [OUTER] JOIN m.team t
• 세타 조인:
select count(m) from Member m, Team t where m.username
= t.name

String query = "select m from Member m inner join m.team t";
List<Member> resultList = em.createQuery(query, Member.class)
	.getResultList();
System.out.println("JpaMain.main");
for (Member member1 : resultList) {
	System.out.println("member1 = " + member1.getTeam().getName());
	}

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

일반적인 sql에서 지원하는 함수이다.

서브쿼리 지원 함수

• [NOT] EXISTS (subquery): 서브쿼리에 결과가 존재하면 참
• {ALL | ANY | SOME} (subquery)
• ALL 모두 만족하면 참
• ANY, SOME: 같은 의미, 조건을 하나라도 만족하면 참
• [NOT] IN (subquery): 서브쿼리의 결과 중 하나라도 같은 것이 있으면 참

서브쿼리 한계

JPA는 Where, Having 절에서만 가능하다.
Select는 Hibernate가 지원한다.
From 절의 서브쿼리는 JPQL로 불가능하다.
가능하면 조인으로 한다.

JPQL 타입 표현

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

문법이 같은 식

• EXISTS, IN
• AND, OR, NOT
• =, >, >=, <, <=, <>
• BETWEEN, LIKE, IS NULL

조건식 Case

기본 케이스 식

select
 case when m.age <= 10 then '학생요금'
 when m.age >= 60 then '경로요금'
 else '일반요금'
 end
from Member m

단순 케이스 식

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 반환, 다르면 첫번째 값 반환

select NULLIF(m.username, '관리자') from Member m

JPQL 기본 함수

• CONCAT 
  - 문자를 두개 더하는 기능이다
• SUBSTRING 
• TRIM 
• LOWER, UPPER 
• LENGTH 
• LOCATE 
  - 문자열에서 문자의 위치
• ABS, SQRT, MOD 
• SIZE, INDEX(JPA 용도)

기본적인 DB 제공 함수들은 이미 registerFunction에 등록되어있다.

사용자 정의 함수

사용하는 DB 방언을 상속받아서 사용자 정의 함수를 추가할 수 있다.