객체지향 쿼리 언어

객체지향 쿼리 언어 소개

JPQL

//검색
String jpql = "select m From Member m where m.name like ‘%hello%'"; 
List<Member> result = em.createQuery(jpql, Member.class).getResultList();

• 가장 단순한 조회 방법 
  • EntityManager.find() 
  • 객체 그래프 탐색(a.getB().getC())
• JPA는 SQL을 추상화한 JPQL이라는 객체 지향 쿼리 언어 제공
• 테이블이 아닌 엔티티 객체를 대상으로 검색하는 객체 지향 쿼리
• SQL을 추상화해서 특정 데이터베이스 SQL에 의존하지 않는다.
• JPQL은 결국 SQL로 변환된다.

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을 작성할 수 있음
• JPQL 빌더 역할
• JPA 공식 기능
• 너무 복잡하고 실용성이 없기에 Criteria 대신에 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();

• 문자가 아닌 자바코드로 JPQL을 작성할 수 있음
• 컴파일 시점에 문법 오류를 찾을 수 있다
• 동적쿼리 작성 편리함 
• 단순하고 쉽기에 실무 사용 권장!

네이티브 SQL

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

• JPA가 제공하는 SQL을 직접 사용하는 기능 
• JPQL로 해결할 수 없는 특정 데이터베이스에 의존적인 기능

 

 

JPQL - 기본 문법과 기능

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

집합과 정렬

 

TypeQuery, Query

TypedQuery<Member> query1 = em.createQuery("select m from Member m", Member.class);
Query query2 = em.createQuery("select m.username, m.age from Member m");

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

 

결과 조회 API

TypedQuery<Member> query1 = em.createQuery("select m from Member m", Member.class);
List<Member> resultList1 = query1.getResultList();
Member resultList2 = query1.getSingleResult();

• query.getResultList(): 결과가 하나 이상일 때, 리스트 반환 
  • 결과가 없으면 빈 리스트 반환 
• query.getSingleResult(): 결과가 정확히 하나, 단일 객체 반환 
  • 결과가 없으면: javax.persistence.NoResultException 
  • 둘 이상이면: javax.persistence.NonUniqueResultException

 

파라미터 바인딩

TypedQuery<Member> query1 = em.createQuery("select m from Member m where m.username = :username", Member.class);
query1.setParameter("username", "member1");

 

 

프로젝션 (SELECT)

프로젝션이란 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[] 타입으로 조회 

List<Object[]> resultList = em.createQuery("select m.age,m.username from Member m").getResultList();
Object []result = resultList.get(0);

System.out.println("username = " + result[0]); //m.username
System.out.println("age = " + result[1]); //m.age

 

3. new 명령어로 조회

 

MemberDTO 클래스

package jpql;
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 jpql.MemberDTO(m.username,m.age) from Member m", MemberDTO.class).getResultList();
MemberDTO memberDTO = result.get(0);
System.out.println("username = " + memberDTO.getUsername()); //m.username
System.out.println("age = " + memberDTO.getAge()); //m.age

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

 

 

페이징

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

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

for(int i=1;i<=10;i++) {
    Member member = new Member();
    member.setUsername("member" + i);
    member.setAge(i);
    em.persist(member);
}


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

List<Member> result = em.createQuery("select m from Member m order by m.age desc", Member.class)
        .setFirstResult(0)
        .setMaxResults(10)
        .getResultList();

for(Member m : result) {
	System.out.println("m = " + m.getUsername() + ", " + m.getAge());
}

tx.commit();
---------------------------------------------------------------------------------------------------------------
출력
m = member10, 10
m = member9, 9
m = member8, 8
m = member7, 7
m = member6, 6
m = member5, 5
m = member4, 4
m = member3, 3
m = member2, 2
m = member1, 1

 

 

조인

내부 조인: SELECT m FROM Member m [INNER] JOIN m.team t 

String query = "select m from Member m inner join m.team t";
List<Member> result = em.createQuery(query, Member.class)
		.getResultList();

외부 조인: SELECT m FROM Member m LEFT [OUTER] JOIN m.team t 

String query = "select m from Member m left join m.team t";
List<Member> result = em.createQuery(query, Member.class)
		.getResultList();

세타 조인: select count(m) from Member m, Team t where m.username = t.name

String query = "select m from Member m,Team t where m.username=t.name";
List<Member> result = em.createQuery(query, Member.class)
		.getResultList();

 

JPA 에서는 연관관계로 조인을 하면 자동으로 외래키와 매칭되는 테이블의 pk 를 찾아서 on 절을 설정해준다.
예시로 "select m from Member m join Team t on m.team=t.id"는 연관관계로 조인하지 않았으므로 Join하기 위한 on절이 꼭 필요하다.

 

On절

1.연관관계 있는 엔티티 대상 필터링

• 회원과 팀을 조인하면서, 팀 이름이 A인 팀만 조인
• SELECT m, t FROM Member m JOIN m.team t on t.name = 'A'

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

• 회원의 이름과 팀의 이름이 같은 대상 외부 조인
• 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 avg(m2.age) from Member m2)
• 한 건이라도 주문한 고객 : select m from Member m where (select count(o) from Order o where m = o.member) > 0
  • 서브 쿼리 : (select count(o) from Order o where m = o.member)

서브 쿼리 지원함수

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

• 팀A 소속인 회원 : select m from Member m where exists (select t from m.team t where t.name = ‘팀A')

ALL : 모두 만족하면 참 

• 전체 상품 각각의 재고보다 주문량이 많은 주문들 :
  • select o from Order o where o.orderAmount > ALL (select p.stockAmount from Product p)

ANY, SOME : 같은 의미, 조건을 하나라도 만족하면 참

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

IN : 서브쿼리의 결과 중 하나라도 같은 것이 있으면 참

 

서브 쿼리의 한계

• JPA는 WHERE, HAVING 절에서만 서브 쿼리 사용 가능 
• SELECT 절도 가능(하이버네이트에서 지원) 
• FROM 절의 서브 쿼리는 현재 JPQL에서 불가능 
  • 조인으로 풀 수 있으면 풀어서 해결

 

 

JPQL 타입 표현

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

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

 

 

조건식 - CASE 식

기본 CASE 식

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

 

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

String query = "select coalesce(m.username,'이름 없는 회원') from Member m";

• 사용자 이름이 없으면 '이름 없는 회원'을 반환

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

String query = "select NULLIF(m.username, '관리자') from Member m";

• 사용자 이름이 ‘관리자’면 null을 반환하고 아니면 본인의 이름을 반환\\

 

 

JPQL 함수