JPQL - 기본 문법

JPA는 다양한 쿼리 방법을 지원

• JPQL
• JPA Criteria
• QueryDSL
• 네이티브 SQL
• JDBC API 직접 사용, MyBatis, SpringJdbcTemplate 함께 사용

---

JPQL 

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

예시

Member member = new Member();
member.setName("득윤");
em.persist(member);

List<Member> resultList = em.createQuery(
        "SELECT m FROM  Member m where m.name like '%득%'",
        Member.class).getResultList();

for (Member member1 : resultList) {
    System.out.println("member1 = " + member1);
}

 

---

네이티브 SQL

 

• SQL을 직접 사용하는 기능
• JPQL로 해결할 수 없는 특정 데이터베이스에 의존적인 기능
• 예) 오라클 CONNECT BY, 특정 DB만 사용하는 SQL 힌트

String sql = "SELECT MEMBER_ID, NAME FROM MEMBER WHERE NAME LIKE '득%'";
List<Member> resultList2 =
        em.createNativeQuery(sql, Member.class).getResultList();

---

JPQL

• JPQL은 객체지향 쿼리 언어다.따라서 테이블을 대상으로 쿼리 하는 것이 아니라 엔티티 객체를 대상으로 쿼리한다.
• JPQL은 SQL을 추상화해서 특정데이터베이스 SQL에 의존하지 않는다.
• JPQL은 결국 SQL로 변환된다

예시 구조

mysql> DESC MEMBER;
+-----------+--------------+------+-----+---------+-------+
| Field     | Type         | Null | Key | Default | Extra |
+-----------+--------------+------+-----+---------+-------+
| member_id | bigint       | NO   | PRI | NULL    |       |
| age       | int          | NO   |     | NULL    |       |
| username  | varchar(255) | YES  |     | NULL    |       |
| team_id   | bigint       | YES  | MUL | NULL    |       |
+-----------+--------------+------+-----+---------+-------+
4 rows in set (0.00 sec)

mysql> DESC ORDERS;
+--------------+--------------+------+-----+---------+-------+
| Field        | Type         | Null | Key | Default | Extra |
+--------------+--------------+------+-----+---------+-------+
| order_id     | bigint       | NO   | PRI | NULL    |       |
| city         | varchar(255) | YES  |     | NULL    |       |
| street       | varchar(255) | YES  |     | NULL    |       |
| zipcode      | varchar(255) | YES  |     | NULL    |       |
| order_amount | int          | NO   |     | NULL    |       |
| member_id    | bigint       | YES  | MUL | NULL    |       |
| product_id   | bigint       | YES  | MUL | NULL    |       |
+--------------+--------------+------+-----+---------+-------+
7 rows in set (0.00 sec)

mysql> DESC PRODUCT;
+--------------+--------------+------+-----+---------+-------+
| Field        | Type         | Null | Key | Default | Extra |
+--------------+--------------+------+-----+---------+-------+
| product_id   | bigint       | NO   | PRI | NULL    |       |
| name         | varchar(255) | YES  |     | NULL    |       |
| price        | int          | NO   |     | NULL    |       |
| stock_amount | int          | NO   |     | NULL    |       |
+--------------+--------------+------+-----+---------+-------+
4 rows in set (0.01 sec)

mysql> DESC TEAM;
+---------+--------------+------+-----+---------+-------+
| Field   | Type         | Null | Key | Default | Extra |
+---------+--------------+------+-----+---------+-------+
| team_id | bigint       | NO   | PRI | NULL    |       |
| name    | varchar(255) | YES  |     | NULL    |       |
+---------+--------------+------+-----+---------+-------+
2 rows in set (0.00 sec)

 

---

기본 문법과 쿼리 API

TypeQuery, Query

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

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

 

결과조회 API

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

파라미터 바인딩

SELECT m FROM Member m where m.username=:username
query.setParameter("username", 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로 중복 제거

 

스칼라타입의 경우

오브젝트리스트를 받는등 방식이 있지만 DTO를 선언해서 NEW 를 활용하자

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

---

조인

내부 조인: 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

 

예) 회원과 팀을 조인하면서, 팀 이름이 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'

---

서브쿼리

나이가 평균보다 많은 회원
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는 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 (상속 관계에서 사용)

 

SQL과 문법이 같은 식

• EXISTS, IN

• AND, OR, NOT

• =, >, >=, <, <=, <>

• BETWEEN, LIKE, IS NULL

 

CASE, COALESCE, NULLIF 모두 가능

 

사용자 이름이 없으면 이름 없는 회원을 반환
select coalesce(m.username,'이름 없는 회원') from Member m

사용자 이름이 ‘관리자’면 null을 반환하고 나머지는 본인의 이름을 반환
select NULLIF(m.username, '관리자') from Member m

JPQL 기본 함수

• CONCAT
• SUBSTRING
• TRIM
• LOWER, UPPER
• LENGTH
• LOCATE
• ABS, SQRT, MOD
• SIZE, INDEX(JPA 용도)

---