<<ValueType>>
@Embeddable
1. private setter나 no setter
2. 필드 초기화 생성자
3. equals(), hashCode() override
(프록시 초기화가 이루어질 수 있도록 필드에 접근할 때 내부적으로 getter를 사용)
10. 객체지향 쿼리 언어(JPQL)
객체지향 쿼리 언어 소개
JPA는 다양한 쿼리 방법을 지원
데이터베이스 CRUD를 위해서는 결국 SQL이 실행되어야 한다.
• JPQL : 표준문법. 대부분 해결 가능
• JPA Criteria
• QueryDSL
• 네이티브 SQL
• JDBC API 직접 사용, MyBatis, SpringJdbcTemplate 함께 사용
JPQL 소개
가장 단순한 조회 방법
• EntityManager.find() : 엔티티 클래스, 식별자를 통해 특정 엔티티를 조회
• 객체 그래프 탐색(a.getB().getC())
나이가 18살 이상인 회원을 모두 검색하고 싶다면? -> 검색 쿼리 필요
• JPA를 사용하면 엔티티 객체를 중심으로 개발
• 검색을 할 때도 테이블이 아닌 엔티티 객체를 대상으로 검색
• 모든 DB 데이터를 객체로 변환해서 검색하는 것은 불가능
• 애플리케이션이 필요한 데이터만 DB에서 불러오려면 결국 검색 조건이 포함된 SQL이 필요
=> JPA는 SQL을 추상화한 "JPQL"이라는 객체 지향 쿼리 언어 제공한다.
• SQL과 문법 유사, SELECT, FROM, WHERE, GROUP BY, HAVING, JOIN 지원
• JPQL은 엔티티 객체를 대상으로 쿼리 -> SQL로 변환됨
SQL을 추상화해서 특정 데이터베이스 SQL에 의존하지 않는다.
• SQL은 데이터베이스 테이블을 대상으로 쿼리
//검색
String jpql = " select m From Member m where m.name like ‘%hello%' ";
List result = em.createQuery(jpql, Member.class).getResultList();
Criteria 소개
동적 쿼리
• 문자가 아닌 자바코드로 JPQL을 작성할 수 있음
• JPQL 빌더 역할 (JPQL 조립)
• JPA 공식 기능
• 단점: 너무 복잡하고 실용성이 없다.
• Criteria 대신에 QueryDSL 사용 권장
QueryDSL 소개
편리한 동적 쿼리
• 문자가 아닌 자바코드로 JPQL을 작성할 수 있음
• JPQL 빌더 역할 (JPQL와 거의 1:1 매칭. JPQL 이해도가 높으면 메뉴얼 참고하여 쉽게 사용 가능)
• 컴파일 시점에 문법 오류를 찾을 수 있음
• 단순하고 쉬움
• 실무 사용 권장
//JPQL
//select m from Member m where m.age > 18
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();
네이티브 SQL 소개
• JPA가 제공하는 SQL을 직접 사용하는 기능
• JPQL로 해결할 수 없는 특정 데이터베이스에 의존적인 기능.
• 예) 오라클 CONNECT BY, 특정 DB만 사용하는 SQL 힌트 (하이버네이트도 지원)
em.createNativeQuery(sqlString, Entity.class).getResultList();
JDBC 직접 사용, SpringJdbcTemplate 등
• JPA를 사용하면서 JDBC 커넥션을 직접 사용하거나, 스프링 JdbcTemplate, 마이바티스등을 함께 사용 가능
• 단, 영속성 컨텍스트를 적절한 시점에 강제로 플러시 필요.
• JPA를 통하면 createQuery 사용시 자동 플러시 후 쿼리하지만, JDBC를 직접 사용하면 SQL을 실행하기 직전에 영속성 컨텍스트 수동 플러시
JPQL(Java Persistence Query Language)
기본 문법과 기능
select_문 :: =
select_절
from_절
[where_절]
[groupby_절]
[having_절]
[orderby_절]
update_문 :: = update_절 [where_절]
delete_문 :: = delete_절 [where_절]
JPQL 문법
select m from Member as m where m.age > 18
• 엔티티와 속성은 대소문자 구분O. 객체에 있는 프로퍼티와 똑같이 (Member, age)
• JPQL 키워드는 대소문자 구분X (SELECT, FROM, where)
• 엔티티 이름 사용, 테이블 이름이 아님 (Member)
• 별칭(alias)은 필수(m) (as는 생략가능)
• SQL과 최대한 유사하게 JPQL을 작성해야 실제 실행될 쿼리가 예상 가능해진다.
집합과 정렬
표준 함수들 모두 제공됨
select COUNT(m), //회원수
SUM(m.age), //나이 합
AVG(m.age), //평균 나이
MAX(m.age), //최대 나이
MIN(m.age) //최소 나이
from Member m
• GROUP BY, HAVING
• ORDER BY
TypeQuery, Query
• TypeQuery<>: 반환 타입이 명확할 때 사용
• Query: 반환 타입이 명확하지 않거나 다수일 때 사용
결과 조회 API
• query.getResultList(): 결과가 하나 이상일 때, 리스트 반환.
-결과가 없으면 빈 리스트 반환. null pointer exception으로부터 안전
• query.getSingleResult(): 결과가 정확히 하나, 단일 객체 반환
-결과가 없으면: javax.persistence.NoResultException
(Spring Data JPA를 사용하면 null 이나 Optional을 반환하여 예외가 발생하지 않게 함)
-둘 이상이면: 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 -> 엔티티(연관) 프로젝션 (join query)
• 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 타입으로 조회. Object[] 으로 형 변환 후 사용
2. Object[] 타입으로 조회
3. new 명령어로 조회 : 단순 값을 DTO로 바로 조회
SELECT new jpabook.jpql.UserDTO(m.username, m.age) FROM Member m
- 패키지 명을 포함한 전체 클래스 명 입력
- 순서와 타입이 일치하는 생성자 필요
페이징 API
JPA는 페이징을 다음 두 API로 추상화. 데이터베이스 방언 표준 스펙에 맞춰 SQL 생성
(order by 를 사용하여 테스트)
• setFirstResult(int startPosition) : 조회 시작 위치 (0부터 시작) (OFFSET)
• setMaxResults(int maxResult) : 조회할 데이터 수 (LIMIT)
MySQL 방언

Oracle 방언

조인
• 내부 조인: SELECT m FROM Member m [INNER] JOIN m.team t
Team이 없으면(null) 데이터가 나오지 않음
• 외부 조인: SELECT m FROM Member m LEFT [OUTER] JOIN m.team t
Team이 없으면 Member만 조회
• 세타 조인: select count(m) from Member m, Team t where m.username = t.name
연관관계가 없는 엔티티끼리 cross join
*[ ] 는 생략 가능
조인 - ON절
1. 조인 대상 필터링
예) 회원과 팀을 조인하면서, 팀 이름이 A인 팀만 조인
JPQL: SELECT m, t FROM Member m LEFT JOIN m.team t on t.name = 'A'
SQL: SELECT m.*, t.* FROM Member m LEFT JOIN Team t ON m.TEAM_ID=t.id and t.name='A'
2. 연관관계 없는 엔티티 외부 조인(하이버네이트 5.1부터)
예) 회원의 이름과 팀의 이름이 같은 대상 외부 조인
JPQL: SELECT m, t FROM Member m LEFT JOIN Team t on m.username = t.name
SQL: 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 m from Member m
where (select count(o) from Order o where m = o.member) > 0
서브 쿼리 지원 함수
• [NOT] EXISTS (subquery): 서브쿼리에 결과가 존재하면 참
- {ALL | ANY | SOME} (subquery)
ALL 모두 만족하면 참 / ANY, SOME: 같은 의미, 조건을 하나라도 만족하면 참
• [NOT] IN (subquery): 서브쿼리의 결과 중 하나라도 같은 것이 있으면 참
JPA 서브 쿼리 한계
• JPA는 WHERE, HAVING 절에서만 서브 쿼리 사용 가능
• SELECT 절도 가능(하이버네이트에서 지원)
• FROM 절의 서브 쿼리는 현재 JPQL에서 불가능. 조인으로 풀 수 있으면 풀어서 해결.
FROM 절 서브쿼리가 필요 없게끔 설계