자바 ORM 표준 JPA 프로그래밍 _ 기본(김영한) _ JPQL 소개, 문법

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

• JPQL
• JPA Criteria (자바코드로 JPQL 작성. 복잡하고 실용성X. QueryDSL 사용 권장)
• QueryDSL (자바코드로 JPQL 작성. JPQL 빌더 역할. 동적 쿼리 작성 편리함)
• 네이티브 SQL (JPA가 제공하는 SQL을 직접 사용. JPQL로 해결할 수 없는 특정 DB에 의존적인 기능 사용)
• JDBC API 직접 사용, MyBatis, SpringJdbcTemplate 함께 사용 (영속성 컨텍스트를 적절한 시점에 플러시 해야함)

 

JPQL(Java Persistence Query Language)

• JPA를 사용하면 엔티티 객체를 중심으로 개발
• 검색을 할 때도 테이블이 아닌 엔티티 객체를 대상으로 검색
• 모든 DB 데이터를 객체로 변환해서 검색하는 것은 불가능
• 애플리케이션이 필요한 데이터만 DB에서 불러오려면 결국 검색 조건이 포함된 SQL이 필요
• JPA는 SQL을 추상화한 JPQL이라는 객체 지향 쿼리 언어 제공 (특정 DB SQL에 의존X)
• JPQL은 엔티티 객체를 대상으로 쿼리 / SQL은 데이터베이스 테이블을 대상으로 쿼리

 

[문법]

• 엔티티와 속성은 대소문자 구분O (Member, age)
• JPQL 키워드는 대소문자 구분X (SELECT, FROM, where)
• 엔티티 이름 사용, 테이블 이름이 아님
• 별칭은 필수 (as는 생략가능)

 

[TypeQuery, Query]

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

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

 

[결과 조회 API]

• query.getResultList() : 결과가 하나 이상일 때,  리스트 반환 (결과 없으면 빈 리스트 반환)
• query.getSingleResult() : 결과가 정확히 하나, 단일 객체 반환 (하나 아닐 때 예외 발생)

 

[파라미터 바인딩]

SELECT m FROM Member m WHERE m.username=:username

query.setParamter("username", usernameParam);

SELECT m FROM Member m WHERE m.username=?1

query.setParameter(1, usernameParam);

 

[프로젝션]

• SELECT 절에 조회할 대상을 지정하는 것
• 프로젝션 대상: 엔티티, 임베디드 타입, 스칼라 타입(숫자, 문자 등 기본 데이터 타입)
• DISTINCT로 중복 제거
• SELECT m FROM Member m  →  엔티티 프로젝션
• SELECT m.team FROM Member m  →  엔티티 프로젝션 (실제 쿼리는 join문으로 나감. 성능 문제 없고 한눈에 보이도록 명시적으로 join문 작성할 것을 권장)
• SELECT m.address FROM Member m  →  임베디드 타입 프로젝션
• SELECT m.username, m.age FROM Member m  →  스칼라 타입 프로젝션 (username은 String, age는 int)
  1. Query 타입으로 조회
  2. Object[] 타입으로 조회
  3. new 명령어로 조회
     • 단순 값을 DTO로 바로 조회 (SELECT new jpabook.jpql.UserDTO(m.username, m.age) FROM Member m)
     • 패키지 명을 포함한 전체 클래스명 입력
     • 순서와 타입이 일치하는 생성자 필요

 

[페이징 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 ON t.name = 'A'
• 외부 조인 : SELECT m FROM Member m LEFT OUTER JOIN m.team t ON m.username = t.name
• 세타 조인 : SELECT count(m) FROM Member m, Team t WHERE m.username = t.name

 

[서브 쿼리]

• NOT EXISTS : 서브쿼리에 결과가 존재하면 참
• NOT IN : 서브쿼리의 결과 중 하나라도 같은 것이 있으면 참
• ALL : 모두 만족하면 참
• ANY, SOME : 같은 의미, 조건을 하나라도 만족하면 참
• JPA는 SELECT, WHERE, HAVING절에서만 서브 쿼리 사용 가능
• FROM절의 서브 쿼리는 현재 JPQL에서 불가능 (조인으로 풀 수 있으면 풀어서 해결)

 

[JPQL 타입 표현]

• 문자: 'HELLO', 'She''s'
• 숫자: 10L(Long), 10D(Double), 10F(Float)
• Boolean: TRUE, FALSE
• ENUM: jpabook.MemberType.Admin (패키지명 포함)
• 엔티티 타입: TYPE(m) = Member (상속 관계에서 사용)

 

[조건식]

• COALESCE: 하나씩 조회해서 null이 아니면 반환 
• NULLIF: 두 값이 같으면 null 반환, 다르면 첫번째 값 반환

SELECT COALESCE(m.username, '이름 없는 회원') FROM Member m
SELECT NULLIF(m.username, '관리자') FROM Member m

 

[JPQL 기본 함수]

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

 

[사용자 정의 함수 호출]

• 하이버네이트는 사용 전 방언에 추가해야 한다.
• 사용하는 DB 방언을 상속받고, 사용자 정의 함수를 등록한다.