✅객체지향 쿼리 언어 (JPQL) 소개
JPA는 다양한 쿼리 방법을 지원
JPQL: 표준 문법- JPA Criteria,
QueryDSL: 자바 코드를 작성해 JPQL을 빌드해주는 Generator Class 모음- 네이티브 SQL : 표준 SQL 문법을 벗어나는 쿼리를 작성한다
- JDBC API 직접 사용, MyBatis, SpringJdbcTemplate 함께 사용 가능하다
JPQL 소개
- 가장 단순한 조회 방법
EntityManager.find()- 객체 그래프 탐색(
a.getB().getC())나이가 18살 이상인 회원을 모두 검색하고 싶다면?
JPQL
SQL과 유사한 문법이다.
- JPA를 사용하면 엔티티 객체를 중심으로 개발해야 한다.
- 문제는 검색 쿼리 👉 검색을 할 때도
테이블이 아닌엔티티 객체를 대상으로 검색해야 한다- 모든 DB 데이터를 객체로 변환해서 검색하는 것은 불가능하다
- 애플리케이션이 필요한 데이터만 DB에서 불러오려면
결국 검색 조건이 포함된 SQL이 필요하다- 위와 같은 문제를 해결하기 위해서
JPA는 SQL을 추상화한 JPQL이라는 객체 지향 쿼리 언어 제공한다.
• SQL과 문법 유사하다
SELECT,FROM,WHERE,GROUP BY,HAVING,JOIN와 같이 ANSI 표준 SQL 문법을 모두 지원한다- JPQL은 엔티티 객체를 대상으로 쿼리하고
SQL은 데이터베이스 테이블을 대상으로 쿼리한다.
👉 JPQL을 작성하면 JPA가 이를 SQL로 번역한다.- 테이블이 아닌 객체를 대상으로 검색하는 객체 지향 쿼리이다.
- SQL을 추상화해서 특정 데이터베이스 SQL에 의존하지 않는 장점을 가진다.
- JPQL을 한마디로 정의하면 객체 지향 SQL이다.
List<Member> result = em.createQuery(
"select m from Member m where m.userName like '%kim%'",
Member.class
).getResultList();
select m from Member m where m.userName like '%kim%'에서Member는 테이블이 아니라 엔티티이다.
JPQL과 실행된 SQL
//검색
String jpql = "select m from Member m where m.age > 18";
List<Member> result = em.createQuery(jpql, Member.class).getResultList();
Criteria 소개 (비추)
JPQL로 동적 쿼리를 만들기 어렵기 때문에 Criteria를 사용한다.
- 문자가 아닌 자바코드로 JPQL을 작성할 수 있음
- JPQL 빌더 역할
- JPA 공식 기능
- 📌단점: 너무 복잡하고 실용성이 없다.
👉Criteria대신에QueryDSL사용 권장한다
//Criteria 사용 준비
CriteriaBuilder cb = em.getCriteriaBuilder();
CriteriaQuery<Member> query = cb.createQuery(Member.class);
Root<Member> m = query.from(Member.class);
CriteriaQuery<Member> cq = query.select(m);
String userName = "";
if (userName != null) {
// m.get("username") 하면 에러 -> m.get("userName") : Member 엔티티 클래스에서 지정한 속성명 그대로 넣어준다
cq = cq.where(cb.equal(m.get("userName"), "kim"));
}
List<Member> resultList = em.createQuery(cq).getResultList();
- Criteria는 자바 표준에서 제공한다.
QueryDSL 소개 ⭐
실용성이 없는 Criteria 대신 오픈 소스 라이브러리인 QueryDSL을 사용한다.
- 문자가 아닌 자바코드로 JPQL을 작성할 수 있음
- JPQL 빌더 역할
- 컴파일 시점에 문법 오류를 찾을 수 있음
- 동적쿼리 작성 편리함
- 단순하고 쉬움
- 📌실무 사용 권장
네이티브 SQL 소개
- JPA가 제공하는 SQL을 직접 사용하는 기능
- JPQL로 해결할 수 없는 특정 데이터베이스에 의존적인 기능
- 예) 오라클 CONNECT BY, 특정 DB만 사용하는 SQL 힌트
String sql = "SELECT ID, AGE, TEAM_ID, NAME FROM MEMBER WHERE NAME = 'kim'";
List<Member> resultList = em.createNativeQuery(sql, Member.class).getResultList();
List resultList = em.createNativeQuery("select MEMBER_ID, city, street, zipcode, USERNAME from MEMBER")
.getResultList();
JDBC 직접 사용, SpringJdbcTemplate 등
- JPA를 사용하면서 JDBC 커넥션을 직접 사용하거나, 스프링 JdbcTemplate, 마이바티스등을 함께 조합하여 사용 가능
- 단, 영속성 컨텍스트를 적절한 시점에 강제로 플러시가 필요하다
- flush는
tx.commit()또는em.createQuery()를 한 시점에 자동적으로 수행된다.
하지만dbConn.executeQuery("~");는 데이터베이스 커넥션을 얻어와서 쿼리를 수행한다.
JPA와 아무 관련없기 때문에executeQuery가 동작하기 전에 영속성 컨택스트의 쓰기 지연 SQL들을 DB에 날리는 매커니즘이 없다.
따라서executeQuery이전에em.flush()를 해야한다.- 예) JPA를 우회해서 SQL을 실행하기 직전에 영속성 컨텍스트 수동 플러시
✅JPQL(Java Persistence Query Language)
JPQL - 기본 문법과 기능
JPQL 소개
- JPQL은 객체지향 쿼리 언어다.따라서 테이블을 대상으로 쿼리하는 것이 아니라 엔티티 객체를 대상으로 쿼리한다.
- JPQL은 SQL을 추상화해서 특정데이터베이스 SQL에 의존하지 않는다.
- JPQL은 결국 SQL로 변환된다.
예시
JPQL 문법
select m from Member as m where m.age > 18
- Member가 테이블이 아니라 엔티티다.
- 엔티티와 속성은 대소문자를 구분한다 👉 (Member, age)
- JPQL 키워드는 대소문자 구분하지 않는다 👉 (SELECT, FROM, where)
- 엔티티 이름 (Member)을 사용한다 (테이블 이름이 아니다)
- 별칭은 필수(m) (as는 생략가능)
집합과 정렬
GROUP BY,HAVING,ORDER BY다 똑같이 사용할 수 있다.
TypeQuery, Query
// TypeQuery: 반환 타입이 명확할 때 사용
TypedQuery<Member> query = em.createQuery("select m from Member m", Member.class);
TypedQuery<String> query1 = em.createQuery("select m.username from Member m", String.class);
// Query: 반환 타입이 명확하지 않을 때 사용
Query query2 = em.createQuery("select m.username, m.age from Member m");
TypeQuery: 반환 타입이 명확할 때 사용Query: 반환 타입이 명확하지 않을 때 사용
결과 조회 API
TypedQuery<Member> query = em.createQuery("select m from Member m", Member.class);
// getResultList() : 결과가 컬랙션 -> 결과가 없으면 빈 리스트 반환
List<Member> resultList = query.getResultList();
// getSingleResult() : 결과가 하나 -> 결과가 없거나 두개 이상이면 에러 발생
Member singleResult = query.getSingleResult();
query.getResultList()
결과가 하나 이상일 때, 리스트 반환- 결과가 없으면 빈 리스트 반환
query.getSingleResult()
결과가 정확히 하나인 경우에만, 단일 객체 반환- 결과가 없으면:
javax.persistence.NoResultException- 둘 이상이면:
javax.persistence.NonUniqueResultException
파라미터 바인딩 - 이름 기준, 위치 기준
- 이름 기준으로 파라미터 바인딩
TypedQuery<Member> query = em.createQuery("select m from Member m where m.username = :username", Member.class);
query.setParameter("username","member1");
Member singleResult = query.getSingleResult();
System.out.println("singleResult = " + singleResult.getUsername());
// 보통은 메소드 체이닝으로 깔끔하게 가져온다
Member singleResult1 = em.createQuery("select m from Member m where m.username = :username", Member.class)
.setParameter("username", "member1")
.getSingleResult();
System.out.println("singleResult1 = " + singleResult1.getUsername());
- 위치 기준으로 파라미터 바인딩 (웬만하면 사용하지 마라)
TypedQuery<Member> query = em.createQuery("select m from Member m where m.username = ?1", Member.class);
query.setParameter(1, "member1");
Member singleResult = query.getSingleResult();
System.out.println("singleResult = " + singleResult.getUsername());
프로젝션
프로젝션: SELECT 절에 조회할 대상을 지정하는 것이다프로젝션 대상: 엔티티, 임베디드 타입, 스칼라 타입 (숫자, 문자등 기본 데이터 타입)이 있다SELECT m FROM Member m-> 엔티티 프로젝션 (m이 엔티티)SELECT m.team FROM Member m-> 엔티티 프로젝션 (m.team이 엔티티)SELECT m.address FROM Member m-> 임베디드 타입 프로젝션 (m.address는 임베디드 타입)SELECT m.username, m.age FROM Member m-> 스칼라 타입 프로젝션 (m.username, m.age는 스칼라 타입)- 앞에 DISTINCT 키워드로 중복 제거 할 수 있다.
엔티티 프로젝션
Member member = new Member();
member.setUsername("member1");
member.setAge(10);
em.persist(member);
em.flush();
em.clear();
// 엔티티 프로젝션으로 얻은 List<Member> 속 Member 들은 모두 영속성 컨택스트에 관리 될까? -> YES
List<Member> result = em.createQuery("select m from Member m", Member.class)
.getResultList();
Member member1 = result.get(0);
member1.setAge(20);
엔티티 프로젝션으로 얻은
List<Member>속 Member 들은 모두 영속성 컨택스트에 관리된다.
List<Team> result = em.createQuery("select m.team from Member m", Team.class)
.getResultList();
// 위 쿼리와 동일하다
List<Team> result = em.createQuery("select t from Member m join m.team t", Team.class)
.getResultList();
select m.team from Member m만으로 Member와 Team의 조인 쿼리가 나간다.
👉 조인은 직접 명시적으로 작성하는게 좋다 (select t from Member m join m.team t)
임베디드 타입 프로젝션
List<Address> result = em.createQuery("select o.address from Order o", Address.class)
.getResultList();
스칼라 타입 프로젝션
List result = em.createQuery("select distinct m.username, m.age from Member m")
.getResultList();
프로젝션 - 여러 값 조회
SELECT m.username, m.age FROM Member m
- Query 타입으로 조회
- Object[] 타입으로 조회
- new 명령어로 조회
- 단순 값을 DTO로 바로 조회
SELECT new jpabook.jpql.UserDTO(m.username, m.age) FROM Member m- 패키지 명을 포함한 전체 클래스 명 입력
- 순서와 타입이 일치하는 생성자 필요
Query 타입으로 조회
// Query 타입으로 조회
List resultList = em.createQuery("select distinct m.username, m.age from Member m")
.getResultList();
for (Object o : resultList) {
Object[] result = (Object[]) o;
System.out.println("result[0] = " + result[0]);
System.out.println("result[0] = " + result[1]);
}
Object[] 타입으로 조회
// Object[] 타입으로 조회
List<Object[]> resultList = em.createQuery("select distinct m.username, m.age from Member m")
.getResultList();
for (Object[] result : resultList) {
System.out.println("result[0] = " + result[0]);
System.out.println("result[0] = " + result[1]);
}new 명령어로 조회 : 제일 깔끔
// new 명령어로 조회 : 제일 깔끔
List<MemberDto> resultList = em.createQuery("select new jpql.MemberDto(m.username, m.age) from Member m", MemberDto.class)
.getResultList();
for (MemberDto result : resultList) {
System.out.println("result.getAge() = " + result.getAge());
System.out.println("result.getUsername() = " + result.getUsername());
}페이징 API
- 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);
}
em.flush();
em.clear();
List<Member> resultList = em.createQuery("select m from Member m order by m.age desc", Member.class)
.setFirstResult(1)
.setMaxResults(10)
.getResultList();
System.out.println("resultList.size() = " + resultList.size());
for (Member member1 : resultList) {
System.out.println("member1.toString() = " + member1.toString());
}
-
H2Dialect 방언
-
Oracle12cDialect 방언
조인
- 내부 조인
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
Team team = new Team();
team.setName("teamA");
em.persist(team);
Member member = new Member();
member.setUsername("member1");
member.setAge(10);
member.setTeam(team);
em.persist(member);
em.flush();
em.clear();
// 내부 조인
String query = "select m from Member m inner join m.team t"; // inner 생략할 수 있다
// 외부 조인
String query1 = "select m from Member m left outer join m.team t"; // outer 생략할 수 있다
// 세타 조인
String query2 = "select m from Member m, Team t where m.username = t.name";
List<Member> resultList = em.createQuery(query, Member.class)
.getResultList();
조인 - ON 절
ON절을 활용한 조인(JPA 2.1부터 지원)
- 조인 대상 필터링한다
- 연관관계 없는 엔티티 외부 조인할 수 있다.(하이버네이트 5.1부터)
1. 조인 대상 필터링
예) 회원과 팀을 조인하면서, 팀 이름이 A인 팀만 조인
String query = "SELECT m, t FROM Member m LEFT JOIN m.team t on t.name = 'teamA'";
List resultList = em.createQuery(query)
.getResultList();
- 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. 연관관계 없는 엔티티 외부 조인
예) 회원의 이름과 팀의 이름이 같은 대상 외부 조인
String query = "SELECT m, t FROM Member m LEFT JOIN Team t on m.username = t.name";
List resultList = em.createQuery(query)
.getResultList();
- 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): 서브쿼리의 결과 중 하나라도 같은 것이 있으면 참
서브 쿼리 - 예제
- 팀A 소속인 회원
select m from Member m where exists (select t from m.team t where t.name = ‘팀A')- 전체 상품 각각의 재고보다 주문량이 많은 주문들
select o from Order o where o.orderAmount > ALL (select p.stockAmount from Product p)- 어떤 팀이든 팀에 소속된 회원
select m from Member m where m.team = ANY (select t from Team t)
JPA 서브 쿼리 한계
- JPA는 WHERE, HAVING 절에서만 서브 쿼리 사용 가능
- SELECT 절도 가능(하이버네이트에서 지원)
- 📌
FROM절의 서브 쿼리는 현재 JPQL에서 불가능하다
👉 조인으로 풀 수 있으면 풀어서 해결
JPQL 타입 표현
- 문자:
‘HELLO’,‘She’’s’- 숫자:
10L(Long),10D(Double),10F(Float)- Boolean:
TRUE,FALSE- ENUM:
jpabook.MemberType.Admin(패키지명 포함)- 엔티티 타입:
TYPE(m) = Member(상속 관계에서 사용)
ENUM
// 방법 1
String query = "select m.username, 'HELLO', true from Member m " +
" where m.type = jpql.MemberType.ADMIN";
List<Object[]> resultList = em.createQuery(query)
.getResultList();
// 방법 2 (파라미터)
String query = "select m.username, 'HELLO', true from Member m " +
" where m.type = :userType";
List<Object[]> resultList = em.createQuery(query)
.setParameter("userType",MemberType.ADMIN)
.getResultList();엔티티 타입
em.createQuery("select i from Item i where type(i) = Book", Item.class);Item을 상속받는 엔티티 중 Book만 걸러내기
JPQL 기타
- SQL과 문법이 같은 식
- EXISTS, IN
- AND, OR, NOT
- =, >, >=, <, <=, <>
- BETWEEN, LIKE,
IS NULL
조건식 - CASE 식
- 기본 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 tCOALESCE: 하나씩 조회해서 null이 아니면 반환
-- 사용자 이름이 없으면 '이름 없는 회원'을 반환
select coalesce(m.username,'이름 없는 회원') from Member mNULLIF: 두 값이 같으면 null 반환, 다르면 첫번째 값 반환
-- 사용자 이름이 ‘관리자’면 null을 반환하고 나머지는 본인의 이름을 반환
select NULLIF(m.username, '관리자') from Member mJPQL 기본 함수
- CONCAT
- SUBSTRING
- TRIM
- LOWER, UPPER
- LENGTH
- LOCATE
- ABS, SQRT, MOD
- SIZE, INDEX(JPA 용도)
- SIZE
select size(t.members) From Team t- INDEX (웬만하면 쓰지 마라)
select index(t.members) From Team t사용자 정의 함수 호출
- 하이버네이트는 사용전 방언에 추가해야 한다.
- 사용하는 DB 방언을 상속받고, 사용자 정의 함수를 등록한다.
select function('group_concat', i.name) from Item i
