[JPA] JPQL 기초 - (1) 파라미터 바운딩, 프로젝션, 페이징

JPQL(Java Persistence Query Language)

• JPA는 SQL을 추상화한 JPQL이라는 객체 지향 쿼리 언어 제공(특정데이터베이스 SQL에 의존하
지 않는다.)
• SQL과 문법 유사, SELECT, FROM, WHERE, GROUP BY, HAVING, JOIN 지원
• JPQL은 엔티티 객체를 대상으로 쿼리
• SQL은 데이터베이스 테이블을 대상으로 쿼리

 

TypeQuery, Query

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

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

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

 

결과 조회 API

- 예외 문제 때문에 .getSingleResult()은 잘 사용하지 않음

• query.getResultList(): 결과가 하나 이상일 때, 리스트 반환
	• 결과가 없으면 빈 리스트 반환

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

 

파라미터 바인딩

- 이름 기준

SELECT m FROM Member m where m.username=:username 
query.setParameter("username", usernameParam);

- 위치 기준(바뀔 수 있어서 잘 사용 x)

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로 중복 제거

프로젝션의 여러값 조회

• SELECT m.username, m.age FROM Member m 
• 1. Query 타입으로 조회

• 2. Object[] 타입으로 조회

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

1. Query 타입으로 조회 - object 형변환 사용

Member member = new Member();
member.setUsername("member1");
member.setAge(10);
em.persist(member);

List resultList = em.createQuery("select m.username, m.age from Member m")
.getResultList();

Object o = resultList.get(0);
Object[] result = (Object[]) o;
System.out.println("user name : "+result[0]);
System.out.println("user age : "+ result[1]);

2. Object[] 타입으로 조회

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

Object[] result = resultList.get(0);
System.out.println("user name : "+result[0]);
System.out.println("user age : "+ result[1]);

3. new 명령어로 조회(별도의 MemberDTO 클래스를 만들어야 함)

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("user name : "+ memberDTO.getUsername());
System.out.println("user age : "+ memberDTO.getAge());

 

 

페이징

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

• setFirstResult(int startPosition) : 조회 시작 위치 (0부터 시작)

• setMaxResults(int maxResult) : 조회할 데이터 수

 

사용 예시

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

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

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

결과

member99, 99
member98, 98
member97, 97
member96, 96
member95, 95
member94, 94
member93, 93
member92, 92
member91, 91
member90, 90

 

 

------------------------------------------------------------------------------

*레퍼런스 : 인프런 김영한님 강의(자바 ORM 표준 JPA 프로그래밍)