JPA(9)

5 minute read

JPQL 소개

  • JPA를 사용하면 엔티티 객체를 중심으로 개발
  • 문제는 검색 쿼리
  • 검색을 할 때도 테이블이 아닌 엔티티 객체를 대상으로 검색
  • 모든 DB 데이터를 객체로 변환해서 검색하는 것은 불가능
  • 애플리케이션이 필요한 데이터만 DB에서 불러오려면 결국 검색 조건이 포함된 SQL이 필요
  • JPA는 SQL을 추상화한 JPQL이라는 객체 지향 쿼리 언어 제공
  • SQL과 문법 유사, SELECT, FROM, WHERE, GROUP BY, HAVING, JOIN 지원
  • JPQL은 엔티티 객체를 대상으로 쿼리
  • SQL은 데이터베이스 테이블을 대상으로 쿼리

예시

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

JPQL - 기본 문법과 기능

  • JPQL 문법
    • 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 : 반환 타입이 명확하지 않을 때 사용
TypedQuery<Member> query = 
    em.createQuery("SELECT m FROM Member m", Member.class);  //Member.class로 반환 타입 지정
TypedQuery<String>> query = 
    em.createQuery("SELECT m.username FROM Member m", String.class);  //이름만 조회하므로 String.class로 반환 타입 지정 가능
Query query = 
    em.createQuery("SELECT m.username, m.age from Member m"); 
결과 조회 API
  • query.getResultList(): 결과가 하나 이상일 때, 리스트 반환
    • 결과가 없으면 빈 리스트 반환(NullPointException을 걱정안해도 됨)
  • query.getSingleResult(): 결과가 정확히 하나, 단일 객체 반환
    • 결과가 없으면: javax.persistence.NoResultException
    • 둘 이상이면: javax.persistence.NonUniqueResultException
파라미터 바인딩 - 이름 기준, 위치 기준
  • 파라미터는 이름 기준으로 =:를 사용해서 설정할 수 있다.
  • 위치 기반도 존재하나 버그 발생 위험이 있으므로 사용하지 않는 것이 좋다.

이름 기준

TypedQuery<Member> query = em.createQuery("select m from Member as m where m.name=:name", Member.class)
    .setParameter("name", "memberA");

위치 기준

TypedQuery<Member> query = em.createQuery("select m from Member as m where m.name=?1", Member.class)
    .setParameter(1, "memberA");

프로젝션

  • 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 m.username, m.age FROM Member m
List<Member> result = em.createQuery("select m from Member",Member.class).getResultList();
Member findMember = result.get(0);
findMember.setAge(20);

-> select절에 반환된 객체는 모두 영속성 컨텍스트에 올라가므로 dirty check가 가능하여 나이가 바뀐다.

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

Object[] 타입으로 조회

List<Object[]> resultList = em.createQuery("select m.name, m.id from Member m")
    .getResultList();

for (Object[] o: resultList) {
	System.out.println("o = " + o[0] + ", " + o[1]);
}

DTO로 바로 조회

public class MemberDTO {
    private String name;
    private int age;

    public MemberDTO(String name, int age) {
        this.name = name;
        this.age = age;
    }
}

String query = "select new 패키지이름.MemberDTO(m.name, m.age) from Member m"
List<MemberDTO> resultList = em.createQuery(query, MemberDTO.class)
    .getResultList();

for (MemberDTO m: resultList) {
	System.out.println("m = " + m.getName() + ", " + m.getAge());
}

-> 이 경우에는 패키지 명을 포함한 전체 클래스 명을 입력해야 하고, 순서와 타입이 일치하는 생성자가 존재해야 한다.

페이징 API

  • JPA는 페이징을 다음 두 API로 추상화
  • setFirstResult(int startPosition) : 조회 시작 위치(0부터 시작)
  • 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)
 .setMaxResults(20)
 .getResultList();

-> 10번째 부터 20개의 데이터 가져오기

조인

  • 내부 조인:
    • 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

예시

List<Member> resultList= em.createQuery("select m from Member m inner join m.team t", Member.class)
	.getResultList();	// 'inner'는 생략 가능
List<Member> resultList = em.createQuery("select m from Member m left outer join m.team t", Member.class)
	.getResultList();	// 'outer'는 생략 가능
List<Member> resultList = em.createQuery("select m from Member m, Team t where m.name = t.name", Member.class)
	.getResultList();
조인 - ON 절
  • ON절을 활용한 조인(JPA 2.1부터 지원)

조인 대상 필터링 : 예) 회원과 팀을 조인하면서, 팀 이름이 A인 팀만 조인

String query = "SELECT m, t FROM Member m LEFT JOIN m.team t on t.name = 'A' ";
List<Member> resultList = em.createQuery(query, Member.class)
	.getResultList();

연관관계 없는 엔티티 외부 조인 : 예) 회원의 이름과 팀의 이름이 같은 대사 외부 조인

String query = "SELECT m, t FROM Member m LEFT JOIN Team t on m.username = t.name ";
List<Member> resultList = em.createQuery(query, Member.class)
	.getResultList();

서브 쿼리

서브 쿼리 지원 함수

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

JPA 서브 쿼리의 한계

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

예시

String query = "select m from Member m where m.team = any (select t from Team t)"; //어느 팀이라도 속하는 멤버 추출
List<Member> resultList = em.createQuery(query, Member.class)
    .getResultList();

JPQL 타입 표현

  • 문자: ‘HELLO’, ‘She’’s’ (‘ 사용시 한번 더 적어주기)
  • 숫자: 10L(Long), 10D(Double), 10F(Float)
  • Boolean: TRUE, FALSE
  • ENUM: jpabook.MemberType.Admin (패키지명 포함)
  • 엔티티 타입: TYPE(m) = Member (상속 관계에서 사용)
String query = "select m.username, 'HELLO', TRUE from Member "; 
List<Member> resultList = em.createQuery(query, Member.class)
    .getResultList();

String query = "select m.username, 'HELLO', TRUE from Member m where m.type=jpql.MemberType.Admin "; // enum 타입으로 조회 패키지명 모두 적기
List<Member> resultList = em.createQuery(query, Member.class)
    .getResultList();

-> 위의 쿼리는 결과로 username, hello, true가 나온다. 아래의 쿼리는 Admin타입의 username, hello, true가 나온다.

조건식

기본 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
  • COALESCE: 하나씩 조회해서 null이 아니면 반환
  • NULLIF: 두 값이 같으면 null 반환, 다르면 첫번째 값 반환

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

select coalesce(m.username,'이름 없는 회원') from Member m

사용자 이름이 ‘관리자’면 null을 반환하고 나머지는 본인의 이름을 반환

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

JPQL 기본 함수

  • 기본 함수 : CONCAT, SUBSTRING, TRIM, LOWER, UPPER, LENGTH, LOCATE, ABS, MOD, SIZE, INDEX 등의 함수를 기본으로 제공한다.

예시

String query = "select concat('a', 'b') from Member m";
String query = "select upper(m.name) from Member m";
String query = "select size(t.members) from Team t";
  • 사용자 정의 함수 : 하이버네이트의 경우 사용자 정의 함수를 미리 방언에 추가한 후 사용할 수 있다.

예시

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

-> 사용할 데이터베이스 방언을 상속받고 함수를 등록

<properties>
	<property name="hibernate.dialect" value="hellojpa.MyH2Dialect"/>
</properties>

-> 의존관계를 방언에서 사용자 정의 함수를 정의한 클래스로 교체

다음과 같이 사용

String query = "select function('group_concat', m.name) from Member m";
  • 출처 : 김영한의 자바 ORM 표준 JPA 프로그래밍 - 기본편

Tags:

Categories:

Updated:

Leave a comment