DEV ℧ Developer Diary

[JPA] 객체지향 쿼리 언어 기본 문법 소개

해당 포스트는 인프런 김영한님의 자바 ORM 표준 JPA 프로그래밍 - 기본편 을 듣고 정리한 글입니다.

객체지향 쿼리 언어 소개

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

JPA만으로 복잡한 쿼리를 작성할 수는 없으므로, 다음과 같은 방법들을 이용한다.

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

JPQL 소개

  • 가장 단순한 조회 방법
    • EntityManager.find()
    • 객체 그래프 탐색(a.getB().getC())

JPQL

JPQL이 나타난 배경

  • JPA를 사용하면 엔티티 객체를 중심으로 개발
  • 문제는 검색 쿼리
  • 검색을 할 때도 테이블이 아닌 엔티티 객체를 대상으로 검색
  • 모든 DB 데이터를 객체로 변환해서 검색하는 것은 불가능 하기 때문에 JPQL이 사용된다.
  • 애플리케이션이 필요한 데이터만 DB에서 불러오려면 결국 검색 조건이 포함된 SQL이 필요

그래서 JPQL이란?

  • JPA는 SQL을 추상화한 JPQL이라는 객체 지향 쿼리 언어를 제공한다.
  • SQL과 문법 유사하며, SELECT, FROM, WHERE, GROUP BY, HAVING, JOIN 와 같이 ANSI 표준의 쿼리들을 모두 지원한다.
  • JPQL은 엔티티 객체를 대상으로 쿼리
  • SQL은 데이터베이스 테이블을 대상으로 쿼리

JPQL 예시

간단한 예시를 들어보자 Like 조건문을 이용해 해당하는 Member의 정보를 모두 가져오고자 한다.

List<Member> members = entityManager.createQuery(
        "select m From Member m where m.username like '%hello%'",
        Member.class
).getResultList();

해당 JPQL을 이용해 돌려주면 아래와 같이 쿼리가 나가는것을 확인 할 수있다.

/* select
        m
    From
        Member m
    where
        m.username like '%hello%' */ select
            member0_.id as id1_0_,
            member0_.TEAM_ID as team_id3_0_,
            member0_.USERNAME as username2_0_
        from
            Member member0_
        where
            member0_.USERNAME like '%hello%'

결론

  • 테이블이 아닌 객체를 대상으로 검색하는 객체 지향 쿼리이다.
  • SQL을 추상화 해서 특정 데이터베이스 SQL에 의존 X
  • JPQL을 한마디로 정의하면 객체 지향 SQL

하지만 JPQL도 동적쿼리에 대한 고민을 피해 갈 수는 없다.

만약 검색조건이 있고 없고에 따라 where문을 붙여야 한다면?

String jpqlQuery = "select m From Member as m";
String username = "";
if (username != null ) {
    String where = " where m.username like '%hello%'";
    jpqlQuery += where;
}

조건문에 공백을 붙여야하거나 조건에 따라 where을 없애는 등의 여러 귀찮은 작업이 필요하다.

이를 위해 Criteria라는 것이 있다.

Criteria

Java 표준에서 제공하는 sql 작성 문법이다.

소개

  • 문자가 아닌 자바코드로 JPQL을 작성할 수 있음
  • JPQL 빌더 역할
  • JPA 공식 기능
  • 단점: 너무 복잡하고 실용성이 없다.
  • Criteria 대신에 QueryDSL 사용 권장

예시

간단하게 예시를 들어보자.

//Criteria 사용 준비
CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<Member> query = cb.createQuery(Member.class);

//루트 클래스 (조회를 시작할 클래스)
Root<Member> m = query.from(Member.class);

//쿼리 생성
CriteriaQuery<Member> cq = query.select(m).where(cb.equal(m.get("username"), "kim"));
List<Member> members = entityManager.createQuery(cq).getResultList();
/* select
        generatedAlias0
    from
        Member as generatedAlias0
    where
        generatedAlias0.username=:param0 */ select
            member0_.id as id1_0_,
            member0_.TEAM_ID as team_id3_0_,
            member0_.USERNAME as username2_0_
        from
            Member member0_
        where
            member0_.USERNAME=?

해당 Criteria 또한 동적쿼리의 압박에서는 자유롭지 못하다.

그렇다면 위에서 말한 QueryDsl에 대해 간단하게 알아보자.

QueryDsl

소개

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

예시

QueryDsl은 기본 셋팅이 필요하다. 아직 QueryDsl은 기본 설정이 되어있지 않아서 간단한 예시만 들어보고자 한다. 예시를 들자면 아래와 같이 써줄 수 있다.

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

QueryDsl은 JPQL의 문법을 기본으로 하기때문에, JPQL을 잘 숙지하도록 하자.

네이티브 SQL

소개

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

예시

그냥 쌩으로 SQL 쿼리를 작성한다고 생각하면 된다. Memeber Entity에 대해 쿼리를 작성해서 sql문을 날려보자.

// native sql
String sql = "SELECT ID, TEAM_ID, USERNAME FROM MEMBER WHERE USERNAME LIKE '%hello%'";
List<Member> members = entityManager.createNativeQuery(sql, Member.class).getResultList();
/* dynamic native SQL query */ SELECT
        ID,
        TEAM_ID,
        USERNAME
    FROM
        MEMBER
    WHERE
        USERNAME LIKE '%hello%'

JDBC 직접 사용(mybatis..), SpringJdbcTemplate 등..

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

flush()는 commit 또는 query가 날라갈 때 사용된다. JPA에서 제공하는 코드는 영속성 컨텍스트를 사용하나, JDBC는 영속성 컨텍스트를 사용하지 않으므로 강제로 entityManager.flush()가 필요하다.