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

https://www.inflearn.com/course/ORM-JPA-Basic

자바 ORM 표준 JPA 프로그래밍 - 기본편 - 인프런 | 강의

인프런 김영한 님의 강의를 듣고 작성한 글입니다.

 

[1] 소개

실무에선 대부분 JPQL + QueryDSL(95%)로 해결 가능하다. 나머지는 네이티브 SQL로(5%)

 

■ JPA가 지원하는 쿼리 방법

• JPQL : 표준 문법
• JPA Criteria 
• QueryDSL : 자바 코드로 짜서 JPQL 빌드해 주는 제너레이터 클래스
• 네이티브 SQL
• JDBC API 직접 사용, MyBatis, SpringJdbcTemplate 함께 사용

=> 실무에선 대부분 JPQL로 해결 가능하다.

 

■ 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에 의존 X(한마디로 객체지향 쿼리)

 

■ Criteria

• 문자가 아닌 자바코드로 JPQL을 작성할 수 있음

오타 시 컴파일 단계에서 오류가 뜨고, 동적 쿼리 짜기도 좋다. 그러나 SQL스럽지 않아서 코드를 직관적으로 알기 어렵다.

• JPQL 빌더 역할
• JPA 공식 기능
• 단점: 너무 복잡하고 실용성이 없다.
• Criteria 대신에 QueryDSL 사용 권장

■ QueryDSL

JPA의 오픈소스 프로젝트. QueryDSL도 Criteria처럼 JPQL 빌더 역할을 하며 장점은 Criteria보다 단순하고 쉽다는 점이다.

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

• 문자가 아닌 자바코드로 JPQL을 작성할 수 있음
• JPQL 빌더 역할
• 컴파일 시점에 문법 오류를 찾을 수 있음
• 동적쿼리 작성 편리함
• 단순하고 쉬움
• 실무 사용 권장

 

■ 네이티브 SQL

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

 

■ JDBC 직접 사용, SpringJdbcTemplate 등

• JPA를 사용하면서 JDBC 커넥션을 직접 사용하거나, 스프링 JdbcTemplate, 마이바티스 등을 함께 사용 가능
• 단 영속성 컨텍스트를 적절한 시점에 강제로 플러시 필요
  • 예) JPA를 우회해서 SQL을 실행하기 직전에 영속성 컨텍스트 수동 플러시

영속성 컨텍스트를 적절한 시점에서 강제로 flush()해줘야 한다.

 

 

[2] 기본 문법과 쿼리 API

■ JPQL (Java Persistence Query Language) 소개

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

 

객체 모델·DB 모델 예제

클릭하면 더 크게 볼 수 있습니다.

Member-Team 다대일 연결(양방향), Address는 Order의 값타입, Orders와 Product 다대일(not 양방향)

※ 주의점

Order는 예약어라 테이블명은 Order가 아닌 Orders로 해야 오류가 뜨지 않는다.

Order객체에 @Table(name = "ORDERS")로 이름 지정

 

■ JPQL 문법

select_문 :: = 
    select_절 
    from_절 
    [where_절] 
    [groupby_절] 
    [having_절] 
    [orderby_절]
update_문 :: = update_절 [where_절] 
delete_문 :: = delete_절 [where_절]

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

□ 집합과 정렬

• count(m), sum(m.age), avg(m.age), max(m.age), min(m.age)
• group by, having

□  TypeQuery와 Query

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

 

□ 결과 조회 API

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

SingleResult를 쓸 때 결과가 없으면 NoResultException이 뜬다.

 

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

위치 기준은 꼬여서 버그가 생길 수 있어 이름 기준으로 쓰는 게 바람직하다.

① 이름 기준

Member member = new Member();
member.setUsername("member1");
member.setAge(10);
em.persist(member);

Member singleResult = em.createQuery("select m from Member m where m.username = :username", Member.class)
        .setParameter("username", "member1")
        .getSingleResult();

System.out.println("singleResult = " + singleResult.getUsername());

 

 

메소드 체이닝 방식으로 쓰는 게 깔끔하고 보기 편하다.

 

② 위치 기준

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

 

 

[3] 프로젝션(SELECT)

SELECT 절에 조회할 대상을 지정하는 것을 일컬음

• 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로 중복 제거

 

■ 엔티티 프로젝션

① 묵시적 조인

List<Team> result = em.createQuery("select m.team from Member m", Team.class)
//SQL: SELECT t.id, t.name FROM Member m inner join TEAM t on m.team_id = t.id

JOIN을 명시하지 않아도 자연스럽게 JOIN을 해서 가져온다.

 

② 명시적 조인

List<Team> result = em.createQuery("select t from Member m join m.team t", Team.class)
//SQL: SELECT t.id, t.name FROM Member m inner join TEAM t on m.team_id = t.id

JOIN을 적어놓아 가독성이 좋아진다. 따라서 묵시적 조인보단 명시적 조인을 권장한다.

 

■ 임베디드 프로젝션

List<Address> result = em.createQuery("select o.address from Order o", Address.class);

임베디드 타입은 어딘가에 소속돼 있으므로 소속된 곳을 명시해야 한다.

 

■ 스칼라 타입 프로젝션/여러 값 조회

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

username은 String, age는 int다.

하나의 타입으로 매핑하기 어려우므로 뒤에 명시한 클래스는 제거.

 

▶ 조회 방법

1. Query 타입으로 조회

List resultList = em.createQuery("select m.username, m.age from Member m")
                    .getResultList();

Object o = resultList.get(0);
Object[] result = (Object[]) o;
System.out.println("result = " + result[0]);
System.out.println("result = " + result[1]);

2. Object[] 타입으로 조회

List<Object[]> resultList = em.createQuery("select m.username, m.age from Member m")
        .getResultList();

Object[] result = resultList.get(0);
System.out.println("result = " + result[0]);
System.out.println("result = " + result[1]);

3. new 명령어로 조회

• 단순 값을 DTO로 바로 조회
• SELECT new jpabook.jpql.UserDTO(m.username, m.age) FROM Member m
• 패키지 명을 포함한 전체 클래스 명 입력
• 순서와 타입이 일치하는 생성자 필요

MemberDTO

@Getter
@Setter
@NoArgsConstructor
@AllArgsConstructor
public class MemberDTO {
    private String username;
    private int age;

}

JpaMain

List<MemberDTO> result = em.createQuery("select new jpql.MemberDTO(m.username, m.age) from Member m", MemberDTO.class)
                    .getResultList();
MemberDTO memberDTO = result.get(0);
System.out.println("memberDTO = " + memberDTO.getUsername());
System.out.println("memberDTO = " + memberDTO.getAge());

단점은 패키지를 포함한 전체 클래스를 명시해줘야 한다는 점이다.