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

조성우·2024년 6월 21일

JPA 스프링 부트

JPA - 공부

목록 보기

14/16

객체 지향 쿼리 언어(JPQL)의 기본적인 문법에 대해 알아보자

JPQL 문법

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

select 문 =
    select 절
    from 절
    [where 절]
    [group by 절]
    [having 절]
    [order by 절]
    
update 문 = update 절 [where 절]
delete 문 = delete 절 [where 절]

TypeQuery, Query

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

TypedQuery<Member> query = em.createQuery("SELECT m FROM Member m", Member.class);

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

Query query = em.createQuery("SELECT m.username, m.age from Member m");

결과 조회 API

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

파라미터 바인딩 - 이름 기준, 위치 기준

// 1. 이름 기준
Member query = em.createQuery("SELECT m FROM Member m where m.username = :username", Member.class)
query.setParameter("username", usernameParam);

// 2. 위치 기준
Member query = em.createQuery("SELECT m FROM Member m where m.username = ?1", Member.class)
query.setParameter(1, usernameParam);

위치 기준 파라미터 바인딩은 장애 원인이 될 수 있으므로 사용하지 않는 것이 좋음

프로젝션

: SELECT 절에 조회할 대상을 지정하는 것

SELECT m FROM Member m -> 엔티티 프로젝션
SELECT m.team FROM Member m -> 엔티티 프로젝션 (JOIN을 명시적으로 표시해주는 것이 좋음)
SELECT m.address FROM Member m -> 임베디드 타입 프로젝션
SELECT m.username, m.age FROM Member m -> 스칼라 타입 프로젝션

프로젝션 - 여러값 조회

SELECT m.username, m.age FROM Member m

Query 타입으로 조회

List resultList = em.createQuery("SELECT m.username, m.age From Member m").getResultList();
     
Object o = resultList.get(0);
Object[] result = (Object[]) o;

Object[] 타입으로 조회

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

new 명령어로 조회

// 단순 값을 DTO로 바로 조회 (패키지명을 포함한 전체 클래스명 입력)
// 순서와 타입이 일치하는 생성자 필요
List<MemberDTO> result = em.createQuery("SELECT new jpql.MemberDTO(m.username, m.age) From Member m", MemberDTO.class).getResultList();
     
MemberDTO memberDTO = result.get(0);

페이징

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();