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

JPQL

• Java Persistence Query Language
• 객체지향 쿼리 언어. 테이블 대상X  엔티티 객체를 대상O 으로 쿼리
• SQL을 추성화하므로 특정 데이터베이스 SQL에 의존하지 않음
• 결국 SQL로 변환

 

JPQL 문법

• select m from Member as m where m.age > 14
• 엔티티와 속성은 대소문자 구분함 O(Memeber, age 객체가 가진 것과 대소문자 동일해야)
• JPQL 키워드는 대소문자 구분하지 않음(SELECT select FROM from WHERE where)
• 엔티티 이름을 사용한다(테이블 이름이 아님)
• 별칭이 필수 m (as는 생략 가능하지만 가급적 쓰면 좋음)
• 집합, 정렬 등 함수 가능 (COUNT, SUM, AVG, MAX, GROUP BY, ORDER BY 등)

 

 

TypeQuery

• 반환타입이 명확할 때

TypeQuery<Member> query1 = em.createQuery("select m from Member m", Member.class);
TypeQuery<String> query2 = em.createQuery("select m.username from Member m", String.class);

Query

• 반환타입이 명확하지 않을 때

Query query3 = em.createQuery("select m.username, m.age from Member m");

 

 

결과 조회 API

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

List<Member> resultList = query.getResultList();

 

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

Member result = query.getSingleResult();

 

 

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

• 이름기준

Member result = em.createQuery(SELECT m FROM Member m where m.username=:username", Member.class)
.setParameter("username", usernameParam)
.getSingleResult();

 

•  위치기준
  • 중간에 파라미터를 추가하게 되는 경우 엉킬 수 있기 때문에 권장하지 않음

SELECT m FROM Member m where m.username=?1 
query.setParameter(1, usernameParam);

 

 

 

프로젝션

• SELECT 절에 조회할 대상을 지정하는 것
• 프로젝션 대상: 엔티티, 임베디드 타입, 스칼라 타입(숫자, 문자등 기본 데이터 타입)
• "SELECT m FROM Member m" -> 엔티티 프로젝션
  • 이 쿼리로 찾는 MemberList는 모두 영속성 컨텍스트로 관리 됨
• "SELECT m.team FROM Member m" -> 엔티티 프로젝션
  • 이 쿼리는 성능이 좋지 않기 때문에 조인을 명시하는 쿼리를 권장함.
  • "SELECT t FROM Member m JOIN m.team t"
• "SELECT o.address FROM Order o" -> 임베디드 타입 프로젝션
  • 한계 : SELECT a FROM Address 불가능. 어디 소속인지 엔티티를 명확하게 정해줘야함.
• "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"
  • 패키지 명을 포함한 전체 클래스 명 입력순서와 타입이 일치하는 생성자 필요

 

 

페이징 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();