Hibernate 7 변경점 — Spring Boot 4.0과 함께 달라진 것들

// Hibernate 7 + Jakarta Persistence 3.2
// union, intersect, except 지원
CriteriaBuilder cb = em.getCriteriaBuilder();

CriteriaQuery<String> activeQuery = cb.createQuery(String.class);
Root<Member> m1 = activeQuery.from(Member.class);
activeQuery.select(m1.get("name"))
    .where(cb.equal(m1.get("status"), "ACTIVE"));

CriteriaQuery<String> vipQuery = cb.createQuery(String.class);
Root<Member> m2 = vipQuery.from(Member.class);
vipQuery.select(m2.get("name"))
    .where(cb.equal(m2.get("grade"), "VIP"));

// 3.2에서 추가된 union 연산
CriteriaQuery<String> unionQuery = cb.union(activeQuery, vipQuery);
List<String> names = em.createQuery(unionQuery).getResultList();

// Hibernate 7 — StatelessSession 대폭 개선
StatelessSession session = sessionFactory.openStatelessSession();
Transaction tx = session.beginTransaction();

// 페치 프로파일 지원 추가
session.enableFetchProfile("memberWithTeam");

// HQL에서 엔티티 그래프 힌트 사용 가능
List<Member> members = session.createQuery(
        "select m from Member m where m.status = :status", Member.class)
    .setParameter("status", "ACTIVE")
    .getResultList();

// upsert 지원 — INSERT or UPDATE를 한 번에
session.upsert(new Member("user01", "홍길동", "ACTIVE"));

tx.commit();
session.close();

@Entity
@SoftDelete(columnName = "deleted") // 논리 삭제 컬럼 지정
public class Member {

    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String name;

    // deleted 컬럼은 Hibernate가 자동 관리
    // em.remove() 호출 시 DELETE 대신 UPDATE deleted = true 실행
}

// 사용 코드 — 기존과 동일하게 사용하면 됨
em.remove(member); // 실제로는 UPDATE member SET deleted = true WHERE id = ?

// 조회 시 자동으로 deleted = false 조건 추가
List<Member> members = em.createQuery(
    "select m from Member m", Member.class) // WHERE deleted = false 자동 추가
    .getResultList();

@Entity
public class Order {

    @Id @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    // JSON 타입 네이티브 지원 (별도 라이브러리 불필요)
    @JdbcTypeCode(SqlTypes.JSON)
    private Map<String, Object> metadata;
}

// Hibernate 6.x (deprecated)
@Where(clause = "status = 'ACTIVE'")
@OneToMany(mappedBy = "team")
private List<Member> activeMembers;

// Hibernate 7 — @SQLRestriction으로 대체
@SQLRestriction("status = 'ACTIVE'")
@OneToMany(mappedBy = "team")
private List<Member> activeMembers;

// 더 이상 사용 불가 — 컴파일 에러 발생
import org.hibernate.type.StringType;      // 제거됨
import org.hibernate.type.IntegerType;     // 제거됨
import org.hibernate.type.LongType;        // 제거됨

// Hibernate 6.x 이전 방식 (더 이상 동작하지 않음)
query.setParameter("name", "홍길동", StringType.INSTANCE); // 컴파일 에러

// Hibernate 7 — 표준 타입 시스템 사용
// 대부분의 경우 타입 힌트가 불필요해짐
query.setParameter("name", "홍길동"); // 자동 타입 추론

// 커스텀 타입이 필요한 경우 — @JavaType, @JdbcType 사용
@Entity
public class Product {

    @JavaType(MoneyJavaType.class)
    @JdbcType(BigDecimalJdbcType.class)
    private Money price; // 커스텀 타입 매핑
}

// Hibernate 7 HQL 개선 사항

// 1. 배열 함수 지원
List<Member> result = em.createQuery("""
    select m from Member m
    where array_contains(m.roles, 'ADMIN')
    """, Member.class)
    .getResultList();

// 2. window 함수 지원 확대
List<Object[]> ranked = em.createQuery("""
    select m.name, m.score,
           rank() over (order by m.score desc) as ranking
    from Member m
    """, Object[].class)
    .getResultList();

// 3. 서브쿼리 개선 — FROM 절 서브쿼리
List<Object[]> stats = em.createQuery("""
    select sub.teamName, sub.avgScore
    from (
        select m.team.name as teamName, avg(m.score) as avgScore
        from Member m
        group by m.team.name
    ) sub
    where sub.avgScore > 80
    """, Object[].class)
    .getResultList();

# Hibernate 6.x — 기본값 없음 (설정 안 하면 배치 비활성화)
spring:
  jpa:
    properties:
      hibernate:
        default_batch_fetch_size: 100  # 직접 설정 필요

# Hibernate 7 — 기본 배치 사이즈가 적용됨
# 별도 설정 없이도 합리적인 배치 페칭 동작

public interface MemberRepository extends JpaRepository<Member, Long> {

    // 기존에도 있던 것들
    List<Member> findByName(String name);

    // Spring Data 2025.1에서 개선된 부분
    // Scroll API — 대량 데이터를 커서 기반으로 조회
    Window<Member> findFirst10ByTeamId(Long teamId, ScrollPosition position);

    // 반환 타입으로 Stream 사용 시 성능 최적화
    @QueryHints(@QueryHint(name = HINT_FETCH_SIZE, value = "50"))
    Stream<Member> findAllByStatus(String status);
}

// 구현체 — Hibernate 7의 개선된 Criteria API 활용
class MemberRepositoryCustomImpl implements MemberRepositoryCustom {

    private final EntityManager em;

    MemberRepositoryCustomImpl(EntityManager em) {
        this.em = em;
    }

    @Override
    public List<Member> searchByCondition(MemberSearchCondition condition) {
        CriteriaBuilder cb = em.getCriteriaBuilder();
        CriteriaQuery<Member> cq = cb.createQuery(Member.class);
        Root<Member> root = cq.from(Member.class);

        List<Predicate> predicates = new ArrayList<>();
        if (condition.getName() != null) {
            predicates.add(cb.like(root.get("name"), "%" + condition.getName() + "%"));
        }
        cq.where(predicates.toArray(new Predicate[0]));
        return em.createQuery(cq).getResultList();
    }
}

spring:
  jpa:
    properties:
      hibernate:
        # Hibernate 7에서 변경된 설정
        # hibernate.hbm2ddl.auto → 동작은 동일하나 일부 DDL 생성 방식 변경
        hbm2ddl:
          auto: validate  # 운영에서는 validate 권장

        # 새로운 설정 옵션
        query:
          plan_cache_max_size: 2048  # 쿼리 플랜 캐시 크기 (기본값 증가)