Backend/ORM 표준 JPA 프로그래밍

객체지향 쿼리 언어 소개

potpine 2025. 7. 2. 16:33

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

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

JPQL 소개

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

-> if... 나이가 18살 이상인 회원을 모두 검색하고 싶다면?

JPQL

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

-> 이러한 문제 해결을 위해... JPQL은

  • JPA는 SQL을 추상화한 JPQL이라는 객체 지향 쿼리 언어 제공
  • SQL과 문법 유사, SELECT, FROM, WHERE, GROUP BY, HAVING, JOIN 지원
  • JPQL은 엔티티 객체를 대상으로 쿼리
  • SQL은 데이터베이스 테이블을 대상으로 쿼리
List<Member> result = em.createQuery(
        "select m from Member m where m.username like '%kim%'",
        Member.class
).getResultList();

//이런 식으로 사용하면..
SQL: 
/* select
    m 
from
    Member m 
where
    m.username like '%kim%' */ select
        member0_.MEMBER_ID as member_i1_6_,
        member0_.city as city2_6_,
        member0_.street as street3_6_,
        member0_.zipcode as zipcode4_6_,
        member0_.USERNAME as username5_6_,
        member0_.endDate as enddate6_6_,
        member0_.startDate as startdat7_6_ 
    from
        Member member0_ 
    where
        member0_.USERNAME like '%kim%'
        
// 이런 식으로 적절한 SQL로 번역
 
 

 

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

 

Criteria

  • JPQL은 동적 쿼리를 만들기 어렵기에 실무에서 오류가 발생할 가능성이 있음. 이 대안으로 Criteria 사용
  • 문자가 아닌 자바코드로 JPQL을 작성할 수 있음
  • JPQL 빌더 역할
  • JPA 공식 기능
//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).where(cb.equal(m.get("username"), “kim”));
List<Member> resultList = em.createQuery(cq).getResultList();

 

 

 

  • 장점
    • 쿼리가 단순 문자열이 아니기에 잘못된 문법의 경우 컴파일 오류로 알려준다.
    • 동적 쿼리를 만들기 쉽다.
 
  • 단점
    • SQL스럽지 않다. 실무에서 안 쓴다. 유지보수가 어렵다.
    • 대안으로 QueryDSL 사용

 

QueryDSL

  • 문자가 아닌 자바코드로 JPQL을 작성할 수 있음
  • JPQL 빌더 역할
  • 컴파일 시점에 문법 오류를 찾을 수 있음
  • 동적쿼리 작성 편리함
  • 단순하고 쉬움, 더 SQL스럽다
  • 실무 사용 권장
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();
 

 

네이티브 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();
 

 

JDBC 직접 사용, SpringJdbcTemplate 등

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