10장 - 객체지향 쿼리언어

자바 ORM 표준 JPA 프로그래밍 10장을 요약한 내용 입니다.

JPA는 복잡한 검색 조건을 사용해서 엔티티 객체를 조회할 수 있는 다양한 쿼리 기술을 지원한다.

객체지향 쿼리 소개

EntityManager.find() 메소드를 사용하면 식별자로 엔티티 하나를 조회할 수 있다.

  • 식별자로 조회 EntityManager.find()
  • 객체 그래프 탐색

ORM을 사용하면 데이터베이스 테이블이 아닌 엔티티 객체를 대상으로 개발하므로 검색도 테이블이 엔티티 객체를 대상으로 하는 방법이 필요하다. JPQL은 이런 문제를 해결하기 위해 다음과 같은 특징이 있다.

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

다음은 JPA가 공식 지원하는 기능이다.

  • JPQL
  • Criteria 쿼리 : JPQL을 편하게 작성하도록 도와주는 API, 빌더 클래스 모음
  • 네이티브 SQL : JPA에서 JPQL 대신 직접 SQL을 사용할 수 있다.

다음은 JPA가 공식 지원하지는 않지만 알아둘 가치가 있다.

  • QueryDSL : Criteria 쿼리처럼 JPQL을 편하게 작성하도록 도와주는 빌더 클래스 모음, 비표준 오픈소스 프레임워크
  • JDBC 직접 사용, MyBatis 같은 SQL 매퍼 프레임워크 사용 : 필요하면 JDBC를 직접 사용할 수 있다.

JPQL 소개

JPQL은 엔티티 객체를 조회하는 객체지향 쿼리다. JPQL은 SQL을 추상화해서 특정 데이터베이스에 의존하지 않는다. 그리고 데이터베이스 방언만 변경하면 JPQL을 수정하지 않아도 자연스럽게 데이터베이스를 변경할 수 있다. JPQL은 SQL보다 간결하다

//쿼리 생성
String jpql = "select m from Member as m where m.username = 'kim'";
List<Member> resultList = em.createQuery(jpql, Member.class).getResultList();

Criteria 쿼리 소개

Criteria의 장점은 문자가 아닌 query.select(m).where(…)처럼 프로그래밍 코드로 JPQL을 작성할 수 있다는 점이다. JPQL은 오타가 있어도 컴파일은 성공하고 애플리케이션을 서버에 배포할 수 있다. 문제는 해당 쿼리가 실행되는 런타임 시점에 오류가 발생한다는 점이다. Criteria의 장점은 다음과 같다.

  • 컴파일 시점에 오류를 발견할 수 있다.
  • IDE를 사용하면 코드 자동완성을 지원한다.
  • 동적 쿼리를 작성하기 편하다
//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("usernamen", "kim"));

List<Meinber> resultList = em.createQuery(cq).getResultList();

QueryDSL 소개

QueryDSL도 Criteria처럼 JPQL 빌더 역할을 한다. QueryDSL의 장점은 코드 기반이면서 단순하고 사용하기 쉽다. QeuryDSL과 Criteria를 비교하면 Criteria는 너무 복잡하다.

//준비J
PAQuery query = new JPAQuery(em);
QMember member = QMember.member;

//쿼리, 결과조회
List<Member> members =  query.from(member)
    .where(member.username.eq("kim"))
    .list(member);

네이티브 SQL 소개

JPA는 SQL을 직접 사용할 수 있는 기능을 지원하는데 이것을 네이티브 SQL이라 한다. JPQL을 사용해도 가끔은 특정 데이터베이스에 의존하는 기능을 사용해야 할 때가 있다. 예를 들어 오라클 데이터베이스만 사용하는 CONNECT BY 기능이나 특정 데이터베이스에서만 동작하는 SQL 힌트는 같을 것이다.

네이티브 SQL의 단점은 특정 데이터베이스에 의존하는 SQL을 작성해야 한다는것이다. 따라서 데이터베이스를 변경하면 네이티브 SQL도 수정해야 한다.

String sql = "SELECT ID, AGE, TEAM_ID, NAME FROM MEMBER WHERE NAME = 'kim'";
List<Member> resultList =  em.createNativeQuery(sql, Member.class).getResultList();

JDBC 직접 사용, 마이바티스 같은 SQL 매퍼 프레임워크 사용

JDBC 커넥션에 직접 접근하고 싶으면 JPA는 JDBC 커넥션을 획득하는 API를 제공하지 않으므로 JPA 구현체가 제공하는 방법을 사용해야 한다. JDBC나 마이바티스를 JPA와 함께 사용하면 영속성 컨텍스트를 적절한 시점에 강제로 플러시해야 한다. 문제는 JPA를 우회하는 SQL에 대해서는 JPA가 전혀 인식하지 못한다는 점이다. 최악의 시나리오는 영속성 컨텍스트와 데이터베이스를 불일치 상태로 만들어 데이터 무결성을 훼손할 수 있다.

이런 이슈를 해결하는 방법은 JPA를 우회해서 SQL을 실행하기 직전에 영속성 컨텍스트를 수동으로 플러시해서 데이터베이스와 영속성 컨텍스트를 동기화하면 된다.

JPQL

JPQL SELECT 문

  • 대소문자 구분 : 엔티티와 속성은 대소문자를 구분한다.
  • 엔티티 이름 : JPQL에서 사용하는 객체는 클래스 명이 아니라 엔티티 명이다. 엔티티 명은 @Entity(name = “xxx”)로 지정할 수 있다.
  • 별칭은 필수 : JPQL은 별칭은 필수로 사용해야 한다.

페치 조인

페치(Fetch)조인은 SQL에서 이야기하는 조인의 종류는 아니고 JPQL에서 성능 최적화를 위해 제공하는 기능이다. 이것은 연관된 엔티티나 컬렉션을 한 번에 같이 조회하는 기능인데 join fetch 명령어로 사용할 수 있다.

엔티티 페치 조인

엔티티 페치 조인 JPQL에서 select m 으로 회원 엔티티만 선택했는데 실행된 SQL을 보면 SELECT M.*, T.*로 회원과 연관된 팀도 함께 조회된 것을 확인할 수 있다.

String jpql = "select m from Member m join fetch m.team";
List<Member> members = em.createQuery(jpql, Member.class).getResultList();
for (Member member : members) {
  //페치 조인으로 회원과 팀을 함께 조회해서 지연 로딩 발생 안 함
  Systern.out.printin("username = " + member.getUsername () + ", " +
    "teamname = " + member.getTeam().name());
}

페치 조인과 일반 조인의 차이

페치 조인을 사용하지 않고 조인만 사용하면 어떻게 될까?

select t
from Team t join t.members m
where t.name = '팀A'
SELECT  T.*
FROM TEAM TINNER JOIN MEMBER M 
ON T.ID=M.TEAM_ID
WHERE T.NAME = '팀A*'

JPQL은 결과를 반환할 때 연관관계까지 고려하지 않는다. 단지 SELECT 절에 지정한 엔티티만 조회할 뿐이다. 따라서 팀 엔티티만 조회하고 연관된 회원 컬렉션은 조회하지 않는다.

반면에 페치 조인을 사용하면 연관된 엔티티도 함께 조회한다.

select t
from Team t join fetch t.members
where t.name = '팀A'
SELECT  T.*, M.*
FROM TEAM TINNER JOIN MEMBER M
 ON T.ID=M.TEAM_ID
WHERE T.NAME = '팀A*'

페치 조인의 특징과 한계

페치 조인을 사용하면 SQL 한 번으로 연관된 엔티티들을 함께 조회할 수 있어서 SQL 호출 횟수를 줄여 성능을 최적화할 수 있다. 따라서 글로벌 로딩 전략은 지연 로딩을 사용하고 최적화가 필요하면 페치 조인을 적용하는 것이 효과적이다. 또한 페치 조인을 사용하면 연관된 엔티티를 쿼리 시점에 조회하므로 지연 로딩이 발생하지 않는다. 따라서 준영속 상태에서도 객체 그래프를 탐색할 수 있다.

페치 조인은 다음과 같은 한계가 있다.

페치 조인 대상에는 별칭을 줄 수 없다.

JPA 표준에서는 지원하지 않지만 하이버네이트를 포함한 몇몇 구현체들은 페치 조인에 별칭을 지원한다. 하지만 별칭을 잘못 사용하면 연관된 데이터 수가 달라져서 데이터 무결성이 깨질 수 있으므로 조심해서 사용해야 한다. 특히 2차 캐시와 함께 사용할 때 조심해야 하는데, 연관된 데이터 수가 달라진 상태에서 2차 캐시에 저장되면 다른 곳에서 조회할 때도 연관된 데이터 수가 달라지는 문제가 발생할 수 있다.

둘 이상의 컬렉션을 페치할 수 없다.

구현체에 따라 되기도 하는데 컬렉션 * 컬렉션의 카테시안 곱이 만들어지므로 주의해야 한다.

컬렉션을 페치 조인하면 페이징 API를 사용할 수 없다.

하이버네이트에서 컬렉션을 페치 조인하고 페이징 API를 사용하면 경고 로그를 남기면서 메모리에서 페이징 처리를 한다. 데이터가 적으면 상관없겠지만 데이터가 많으면 성능 이슈와 메모리 초과 예외가 발생할 수 있어서 위험하다. 페치 조인은 객체 그래프를 유지할 때 사용하면 효과적이다. 반면에 여러 테이블을 조인해서 엔티티가 가진 모양이 아닌 전혀 다른 결과를 내야 한다면 억지로 페치 조인을 사용하기보다는 여러 테이블에서 필요한 필드들만 조회해서 DTO로 반환하는 것이 더 효과적일 수 있다.

Named 쿼리: 정적 쿼리

JPQL 쿼리는 크게 동적 쿼리와 정적 쿼리로 나눌 수 있다.

  • 동적 쿼리 : em.createQuery("select …") 처럼 JPQL을 문자로 완성해서 직접 넘기는 것을 동적 쿼리라 한다. 런타임에 특정 조건에 따라 JPQL을 동적으로 구성할 수 있다.
  • 정적 쿼리 : 미리 정의한 쿼리에 이름을 부여해서 필요할 때 사용할 수 있는데 이를 Named 쿼리라 한다.
@Entity
@NamedQuery(
    name = "Member.findByUsername",
    query = "select m from Member m where m.username = :username")
public class Member {
    ...
}

@NamedQuery.query에 사용할 쿼리를 입력한다.

List<Member> resultList = em.createNamedQuery("Member.findByUsername", Member.class)
    .setParameter("username", "회원1")
    .getResultList();

Named 쿼리는 영속성 유닛 단위로 관리되므로 충돌을 방지하기 위해 엔티티 이름을 앞에 주었다. 그리고 엔티티 이름이 앞에 있으면 관리하기가 쉽다.

Criteria

Criteria 쿼리는 JPQL을 자바 코드로 작성하도록 도와주는 빌더 클래스 API다. Criteria를 사용하면 문자가 아닌 코드로 JPQL을 작성하므로 문법 오류를 컴파일 단계에서 잡을 수 있고 문자 기반의 JPQL보다 동적 쿼리를 안전하게 생성할 수 있는 장점이 있다.

//JPQL: select m from Member m
CriteriaBuilder cb = em.getCriteriaBuilder(); //Criteria 쿼리 빌더 --- 1

//Criteria 생성, 반환타입 지정 --- 2
CriteriaQuery<Member> cq = cb.createQuery(Member.class);
Root<Member> m = cq. from (Member.class); //FROM 절 --- 3
cq.select(m); //SELECT 절 --- 4T
ypedQuery<Member> query = em.createQuery(cq);
List<Member> members = query.getResultList();
  1. Criteria 쿼리를 생성하려면 먼저 Criteria 빌더(CriteriaBuilder)를 얻어야 한다. Criteria 빌더는 EntityManager나 EntityManagerFactory에서 얻을 수 있다.
  2. Criteria 쿼리 빌더에서 Criteria 쿼리(CriteriaQuery)를 생성한다. 이때 반환 타입을 지정할 수 있다.
  3. FROM 절을 생성한다. 반환된 값 m은 Criteria에서 사용하는 특별한 별칭이다. m을 조회의 시작점이라는 의미로 쿼리 루트(Root)라 한다.
  4. SELECT 절을 생성한다.

튜플

Criteria는 Map과 비슷한 튜플이라는 특별한 반환 객체를 제공한다.

//JPQL: select m.username, m.age from Member m
CriteriaBuilder cb = em.getCriteriaBuilder();

CriteriaQuery<Tuple> cq = cb.createTupleQuery();
//CriteriaQuery<Tuple> cq = cb.createQuery(Tuple. class); //위와 같다.

Root<Member> m = cq.from(Member.class);
cq.multiselect(
    m.get ("username").alias("username"), //튜플에서 사용할튜플 별칭
    m.get("age").alias("age"));

TypedQuery<Tuple> query = em.createQuery(cq);
List<Tuple> resultList = query.getResultList();

for (Tuple tuple : resultList) {
    //튜플별칭으로조회
    String username = tuple.get("username", String.class);
    
    Integer age = tuple.get("age", Integer.class);
}

조인

조인은 join() 메소드와 joinType 클래스를 사용한다.

/*
 JPQL    select m,t from Member m    inner join m.team t    where t.name = *팀A*
*/

Root<Member> m = cq.from(Member.class);
Join<Member, Team> t = m.join("team" , JoinType. INNER); //내부 조인
cq.multiselect(m, t)
    .where(cb.equal(t.get("name"), "팀A"));

서브 쿼리

/*
 JPQL:select m from Member m
    where m.age >=
        (select AVG(m2.age) from Member m2)
*/

CriteriaBuilder cb = em.getCriteriaBuilder();
CriteriaQuery<Member> mainQuery = cb.createQuery(Member.class);

//서브쿼리생성 --- 1
Subquery<Double> subQuery = mainQuery.subquery(Double.class);
Root<Member> m2 = subQuery.from(Member.class);
subQuery.select(cb.avg(m2.<Integer>get("age")));

//메인쿼리생성 --- 2
Root<Member> m = mainQuery.from(Member.class);
mainQuery.select(m)
    .where(cb.ge(m.<Integer>get("age"), subQuery));

CASE

/* JPQL
    select m.username,
        case when m.age>=60 then 600
            when m.age<=15 then 500
            else 1000
        end
    from Member m
*/

Root<Member> m = cq.from(Member.class);
cq.multiselect(
    m.get("username"),
    cb.selectCase()
        .when(cb.ge(m.<Integer>get(Hagen), 60), 600)
        .when(cb.le(m.<Integer>get("age"), 15), 500)
        .otherwise(1000));

동적 쿼리

//검색 조건
Integer age = 10;
String username = null;String teamName = "팀A";

//JPQL 동적 쿼리 생성
StringBuilder jpql = new StringBuilder("select m from Member m join m.team t");
List<String> criteria = new ArrayList<String>();
if (age != null) criteria.add(" m.age = :age ");
if (username != null) criteria.add( "m.username = :username ");
if (teamName != null) criteria.add(" t.name = :teamName ");
if (criteria.size() > 0) jpql.append(" where ");

for (int i = 0; i < criteria.size(); i++) {
    if (i > 0) jpql.append(" and ");
    jpql.append(criter丄a.get(i));
}

TypedQuery<Member> query = em.createQuery(jpql.toString(), Member.class);
if (age != null) query.setParameter("age", age);
if (username != null) query.setParameter("username", username);
if (teamName != null) query.setParameter("teamName", teamName);
List<Member> resultList = query.getResultList();

Criteria 메타 모델 API

Criteria는 코드 기반이므로 컴파일 시점에 오류를 발견할 수 있다. 하지만 m.get(“age”)에서 age는 문자다. ‘age’대신에 실수로 ’ageaaa’ 이렇게 잘못 적어도 컴파일 시점에 에러를 발견하지 못한다. 따라서 완전한 코드 기반이라 할 수 없다. 이런 부분까지 코드로 작성하려면 메타 모델 API를 사용하면 된다.

  • 메타 모델 API 적용 전

    cq.select(m)
        .where(cb.gt(m.<Integerget("username"), 20))
        .orderBy(cb.desc(m.get("age")));
    
  • 메타 모델 API 적용 후

    cq.select(m)
        .where(cb.gt(m.get(Member_.age), 20))
        .orderBy(cb.desc(m.get(Member_.age)));
    

QueryDSL

Criteria의 가장 큰 단점은 너무 복잡하고 어렵다는 것이다. QueryDSL도 Criteria처럼 JPQL 빌더 역할을 하는데 JPA Criteria를 대체할 수 있다.

검색 조건 쿼리

쿼리 작성이 끝나고 결과 조회 메소드를 호출하면 실제 데이터베이스를 조회한다. 대표적인 결과 조회 메소드는 다음과 같다.

  • uniqueResult() : 조회 결과가 한 건일 때 사용한다. 조회 결과가 없으면 null을 반환하고 결과가 하나 이상이면 NonUniqueResultException 예외가 발생한다.
  • singleResult() : uniqueResult()와 같지만 결과가 하나 이상이면 처음 데이터를 반환한다.
  • list() : 결과가 하나 이상일 때 사용한다. 결과가 없으면 빈 컬렉션을 반환한다.

페이징과 정렬

실제 페이징 처리를 하려면 검색된 전체 데이터 수를 알아야 한다. 이때는 list() 대신에 listResults()를 사용한다.

SearchResults<Item> result = query.from(item)
        .where(item.price.gt(10000))
        .offset(10).limit(20)
        .listResults(item);

long total = result.getTotal(); //검색된 전체 데이터 수
long limit = result.getLimit();
long offset = result.getOffset();
List<Item> results = result.getResults(); //조회된 데이터

서브 쿼리

서브 쿼리의 결과가 하나면 unique(), 여러 건이면 list()를 사용할 수 있다.

QItem item = QItem.item;
QItem itemSub = new QItem("itemSub");
query.from(item)
    .where(item.price.eq(
        new JPASubQuery()
				.from(itemSub)
				.unique(itemSub.price.max())))
		.list(item);

QItem item = QItem.item;
QItem itemSub = new QItem("itemSub");
query.from(item)
    .where(item.in(
        new JPASubQuery().from(itemSub)
            .where(item. name.eq(itemSub. name))
            .list(itemSub)))
		.list(item);

여러 컬럼 반환과 튜플

프로젝션 대상으로 여러 필드를 선택하면 QueryDSL은 기본으로 Tuple이라는 Map과 비슷한 내부 타입을 사용한다. 조회 결과는 tuple.get() 메소드에 조회한 쿼리 타입을 지정하면 된다.

QItem item = QItem.item;
List<Tuple> result = query.from(item).list(item.name, item, price);
//List<Tuple> result = query.from(item).list(new QTuple(item.name, item.price));//같다.
for (Tuple tuple : result) {
    System.out.println("name = " + tuple.get(item.name));
    System.out.println("price = " + tuple.get(item.price));
}

빈 생성

쿼리 결과를 엔티티가 아닌 특정 객체로 받고 싶으면 빈 생성(Bean population)기능을 사용한다.

QItem item = QItem.item;
List<ItemDTO> result = query.from(item).list(
    Projections.bean(ItemDTO.class, item.name.as("username"), item.price));

동적 쿼리

BooleanBuilder를 사용하면 특정 조건에 따른 동적 쿼리를 편리하게 생성할 수 있다.

SearchParam param = new SearchParam();
param.setName("시골개발자");
param.setPrice(10000);
QItem item = QItem.item;
BooleanBuilder builder = new BooleanBuilder();

if (StringUtils.hasText(param.getName())) {
    builder.and(item.name.contains(param.getName()));
}

if (param.getPrice() != null) {
    builder.and(item.price.gt(param.getPrice()));
}

List<Item> result = query.from(item)
    .where(builder)
    .list(item);

메소드 위임

메소드 위임기능을 사용하면 쿼리 타입에 검색 조건을 직접 정의할 수 있다.

public class ItemExpression {
    @QueryDelegate(Item.class)
    public static BooleanExpression isExpensive(Qltem item, Integer price) {
        return item.price.gt(price);
    }
}

메소드 위임 기능을 사용하려면 위와 같이 정적 메소드를 만들고 QueryDeldate 어노테이션에 속성으로 이 기능을 적용할 엔티티를 지정한다.

query.from(item).where(item.isExpensive(30000)).list(item);

네이티브 SQL

JPQL은 표준 SQL이 지원하는 대부분의 문법과 SQL 함수들을 지원하지만 특정 데이터베이스에 종속적인 기능은 지원하지 않는다.

  • 특정 데이터베이스만 지원하는 함수, 문법, SQL 쿼리 힌트
  • 인라인 뷰, UNION, INTERSECT
  • 스토어드 프로시저

특정 데이터베이스에 종속적인 기능을 지원하는 방법은 다음과 같다.

특정 데이터베이스만 사용하는 함수

  • JPQL에서 네이티브 SQL 함수를 호출할 수 있다.
  • 하이버네이트는 데이터베이스 방언에 각 데이터베이스에 종속적인 함수들을 정의해두었다. 또한 직접 호출할 함수를 정의할 수도 있다.

특정 데이터베이스만 지원하는 SQL 쿼리 힌트

  • 하이버네이트를 포함한 몇몇 JPA 구현체들이 지원한다.

인라인 뷰(From 절에서 사용하는 서브쿼리), UNION, INTERSECT

  • 하이버네이트는 지원하지 않지만 일부 JPA 구현체들이 지원한다.

스토어 프로시저

  • JPQL에서 스토어드 프로시저를 호출할 수 있다.

특정 데이터베이스만 지원하는 문법

  • 오라클의 CONNECT BY처럼 특정 데이터베이스에 너무 종속적인 SQL 문법은 지원하지는 않는다. 이때는 네이티브 SQL을 사용해야 한다.

네이티브 SQL과 JDBC의 차이는 무엇일까?

네이티브 SQL을 사용하면 엔티티를 조회할 수 있고 JPA가 지원하는 영속성 컨텍스트의 기능을 그대로 사용할 수 있다. 반면에 JDBC API를 직접 사용하면 단순히 데이터의 나열을 조회할 뿐이다.

//SQL 정의

String sql =
		"SELECT M.ID, AGE, NAME, TEAM_ID, I.ORDER_COUNT " +
    "FROM MEMBER M " +
    "LEFT JOIN " +
    "(SELECT IM.ID, COUNT(*) AS ORDER_COUNT " +
    "FROM ORDERS 0, MEMBER IM " +
    "WHERE O.MEMBER_ID = IM.ID) I " +
    "ON M.ID = I.ID";

Query nativeQuery = em.createNativeQuery(sql, "memberWithOrderCount");

List<Object[]> resultList = nativeQuery.getResultList();
for (Object[] row : resultList) {
    Member member = (Member) row[0];
    Biginteger orderCount = (Biginteger)row[1];
    System.out.printin("member = " + member);
    System.out.printin("orderCount = " + orderCount);
}

memberWithOrderCount의 결과 매핑을 잘 보면 회원 엔티티와 ORDER_COUNT 컬럼을 매핑했다. 예제 10.109에서 사용한 쿼리 결과에서 ID, AGE, NAME, TEAM_ID는 Member 엔티티와 매핑하고 ORDER_COUNT는 단순히 값으로 매핑한다.

@Entity
@SqlResultSetMapping(name = "memberWithOrderCount",
    entities = {@EntityResult(ent丄tyClass = Member.class)},
    columns = {@ColumnResult(name = "ORDER_COUNT")})
public class Member {...}

네이티브 SQL은 관리하기 쉽지 않고 자주 사용하면 특정 데이터베이스에 종속적인 쿼리가 증가해서 이식성이 떨어진다.

객체지향 쿼리 심화

한 번에 여러 데이터를 수정할 수 있는 벌크 연산에 대해 알아보고 다음으로 JPQL과 영속성 컨텍스트에 대해 다뤄보자.

벌크 연산

String qlString =
    "update Product p " +
    "set p.price = p.price * 1.1 " +
    "where p.stockAmount < :stockAmount";

int resultcount = em.createQuery(qlString)
    .setParameter("stockAmount", 10)
    .executeUpdate();

벌크 연산은 executeUpdate() 메소드를 사용한다. 이 메소드는 벌크 연산으로 영향을 받은 엔티티 건수를 반환한다.

벌크 연산의 주의점

벌크 연산을 사용할 때는 벌크 연산이 영속성 컨텍스트를 무시하고 데이터베이스에 직접 쿼리한다는 점에 주의해야 한다.

//상품A 조회(상품A의 가격은 1000원이다. ) --- 1
Product productA =
    em.createQuery("select p from Product p where p.name = :name", Product.class)
        .setParameter("name", "productA")
        .getSingleResult();

//출력 결과: 1000
System.out.printin("productA 수정 전 = " + productA.getPrice ());

//벌크연산 수행으로 모든 상품 가격 10% 상승 --- 2
em.createQuery("update Product p set p.price = p.price * 1.1")
    .executeUpdate();

//출력 결과: 1000 --- 3
System.out.printin("productA 수정 후 = " + productA.getPrice());
  1. 가격이 1000원인 상품A를 조회했다. 조회된 상품A는 영속성 컨텍스트에서 관리된다.
  2. 벌크 연산으로 모든 상품의 가격을 10% 상승시켰다. 따라서 상품A의 가격은 1100원이 되어야 한다.
  3. 벌크 연산을 수행한 후에 상품A의 가격을 출력하면 기대했던 1100원이 아니라 1000원이 출력된다.

벌크 연산은 영속성 컨텍스트를 통하지 않고 데이터베이스에 직접 쿼리한다. 따라서 영속성 컨텍스트에 있는 상품A와 데이터베이스에 있는 상품A의 가격이 다를 수 있다.

이를 해결할 수 있는 다양한 방법이 있다.

em.refresh() 사용

벌크 연산을 수행한 직후에 정확한 상품A 엔티티를 사용해야 한다면 em.refresh() 를 사용해서 데이터베이스에서 상품A를 다시 조회하면 된다.

벌크 연산 먼저 실행

가장 실용적인 해결책은 벌크 연산을 가장 먼저 실행하는 것이다.

벌크 연산 수행후 영속성 컨텍스트 초기화

벌크 연산을 수행한 직후에 바로 영속성 컨텍스트를 초기화해서 영속성 컨텍스트에 남아 있는 엔티티를 제거하는 것도 좋은 방법이다.

영속성 컨텍스트와 JPQL

JPQL로 데이터베이스에서 조회한 엔티티가 영속성 컨텍스트에 이미 있으면 JPQL로 데이터베이스에서 조회한 결과를 버리고 대신에 영속성 컨텍스트에 있던 엔티티를 반환한다.

기존 엔티티를 새로운 엔티티로 대체하면 어떤 문제가 있을까?

  1. 새로운 엔티티를 영속성 컨텍스트에 하나 더 추가한다.
  2. 기존 엔티티를 새로 검색한 엔티티로 대체한다.
  3. 기존 엔티티는 그대로 두고 새로 검색한 엔티티를 버린다.

영속성 컨텍스트는 기본 키 값을 기준으로 엔티티를 관리한다. 따라서 같은 기본키 값을 가진 엔티티는 등록할 수 없으므로 1번은 아니다. 2번은 언뜻 보면 합리적인 것 같지만, 영속성 컨텍스트에 수정 중인 데이터가 사라질 수 있으므로 위험하다. 영속성 컨텍스트는 엔티티의 동일성을 보장한다. 따라서 영속성 컨텍스트는 3번으로 동작한다.

영속성 컨텍스트는 영속 상태인 엔티티의 동일성을 보장한다. em.find()로 조회하든 JPQL을 사용하든 영속성 컨텍스트가 같으면 동일한 엔티티를 반환한다.

JPQL과 플러시 모드

JPQL을 실행하기 전에 영속성 컨텍스트의 내용을 데이터베이스에 반영해야 한다. 그렇지 않으면 의도하지 않은 결과가 발생할 수 있다. 만약 쿼리 실행 전에 플러시를 호출하고 싶으면 em.flush()를 수동으로 플러시 하거나 아니면 setFlushMode()로 해당 쿼리에서만 사용할 플러시 모드를 AUTO로 변경하면 된다.

정리

  • JPQL은 SQL을 추상화해서 특정 데이터베이스 기술에 의존하지 않는다.
  • Criteria나 QueryDSL은 JPQL을 만들어주는 빌더 역할을 할 뿐이므로 핵심은 JPQL을 잘 알아야 한다.
  • Criteria나 QueryDSL을 사용하면 동적으로 변하는 쿼리를 편리하게 작성할 수 있다.
  • Criteria는 JPA가 공식 지원하는 기능이지만 직관적이지 않고 사용하기에 불편하다. 반면에 QueryDSL은 JPA가 공식 지원하는 기능은 아니지만 직관적이고 편리하다.
  • JPA도 네이티브 SQL을 제공하므로 직접 SQL을 사용할 수 있다. 하지만 특정 데이터베이스에 종속적인 SQL을 사용하면 다른 데이터베이스로 변경하기 쉽지 않다. 따라서 최대한 JPQL을 사용하고 그래도 방법이 없을 때 네이티브 SQL을 사용하자
  • JPQL은 대량에 데이터를 수정하거나 삭제하는 벌크 연산을 지원한다.