Criteria API

Criteria API는 JPA에서 타입 안전한 동적 쿼리를 생성할 수 있도록 지원하는 기능입니다.

SQL이나 JPQL과 달리, 자바 코드만으로 쿼리를 생성하기 때문에 컴파일 시점에서 오류를 잡을 수 있으며, 메서드 체이닝 방식으로 동적 쿼리를 쉽게 조립할 수 있습니다.

Criteria API 정의

Criteria API는 JPQL을 타입 안전하게 생성할 수 있도록 지원하는 API로, javax.persistence.criteria 패키지에 포함된 클래스를 활용하여 동적 쿼리를 작성할 수 있습니다.

특징

•

JPQL과 동일한 기능을 제공하면서 컴파일 시점에 오류를 확인 가능

•

메서드 체이닝 방식으로 복잡한 동적 쿼리를 깔끔하게 작성 가능

•

SQL Injection 방지 효과

•

유지보수성이 높음

주요 클래스 및 메서드

클래스	설명
CriteriaBuilder	쿼리 생성에 필요한 연산을 제공 (연산, 비교, 논리 연산 등)
CriteriaQuery<T>	쿼리 객체, SELECT, WHERE, ORDER BY 등을 설정
Root<T>	조회 대상 엔터티를 지정
Predicate	WHERE 절 조건을 표현
Join<T, X>	엔터티 간의 JOIN을 수행

Criteria API 핵심 사용법

Criteria API 기본 구조

CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<Users> query = cb.createQuery(Users.class);
Root<Users> root = query.from(Users.class);
query.select(root);

TypedQuery<Users> typedQuery = entityManager.createQuery(query);
List<Users> users = typedQuery.getResultList();
Java
복사

CriteriaBuilder → CriteriaQuery → Root → 쿼리 실행

WHERE 조건 추가

CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<Users> query = cb.createQuery(Users.class);
Root<Users> root = query.from(Users.class);

Predicate usernameEquals = cb.equal(root.get("username"), "John");
query.select(root).where(usernameEquals);

List<Users> result = entityManager.createQuery(query).getResultList();
Java
복사

cb.equal()을 사용하여 WHERE username = 'John' 조건 추가

ORDER BY 정렬

query.orderBy(cb.desc(root.get("id"))); // ID 내림차순 정렬
Java
복사

COUNT 사용

CriteriaQuery<Long> countQuery = cb.createQuery(Long.class);
countQuery.select(cb.count(countQuery.from(Users.class)));

Long count = entityManager.createQuery(countQuery).getSingleResult();
Java
복사

JOIN 활용

CriteriaBuilder cb = entityManager.getCriteriaBuilder();
CriteriaQuery<Boards> query = cb.createQuery(Boards.class);
Root<Boards> root = query.from(Boards.class);

Join<Boards, Users> userJoin = root.join("user"); // Users 엔터티와 JOIN
Predicate userIdPredicate = cb.equal(userJoin.get("id"), 1L);

query.select(root).where(userIdPredicate);

List<Boards> boards = entityManager.createQuery(query).getResultList();
Java
복사

root.join("user") → Users 엔터티와 JOIN 수행

Criteria API 예제 코드

사용자 이름으로 조회

public List<Users> findUsersByName(String username) {
    CriteriaBuilder cb = entityManager.getCriteriaBuilder();
    CriteriaQuery<Users> query = cb.createQuery(Users.class);
    Root<Users> root = query.from(Users.class);

    query.select(root)
         .where(cb.equal(root.get("username"), username));

    return entityManager.createQuery(query).getResultList();
}
Java
복사

특정 사용자의 게시글 목록 조회

public List<Boards> findBoardsByUser(Long userId) {
    CriteriaBuilder cb = entityManager.getCriteriaBuilder();
    CriteriaQuery<Boards> query = cb.createQuery(Boards.class);
    Root<Boards> root = query.from(Boards.class);

    Join<Boards, Users> userJoin = root.join("user");

    query.select(root)
         .where(cb.equal(userJoin.get("id"), userId))
         .orderBy(cb.desc(root.get("createdAt")));

    return entityManager.createQuery(query).getResultList();
}
Java
복사

특정 사용자의 파일 개수 조회

public Long countFilesByUser(Long userId) {
    CriteriaBuilder cb = entityManager.getCriteriaBuilder();
    CriteriaQuery<Long> query = cb.createQuery(Long.class);
    Root<Files> root = query.from(Files.class);

    Join<Files, Users> userJoin = root.join("user");

    query.select(cb.count(root))
         .where(cb.equal(userJoin.get("id"), userId));

    return entityManager.createQuery(query).getSingleResult();
}
Java
복사

Criteria API 요약

JPQL과 동일한 기능을 제공하지만, 타입 안전성을 보장

컴파일 시점 오류 검출 가능 → 유지보수성이 뛰어남

메서드 체이닝 방식으로 가독성이 높고, 동적 쿼리에 적합

SQL Injection 방지 효과

복잡한 동적 쿼리에서도 깔끔한 코드 유지 가능

Criteria API를 활용해 동적 쿼리를 안전하고 유연하게 작성하세요!

JPA

•

JPA

•

JPA 주요 구성 요소

•

JPA 장점

•

JPA vs MyBatis

•

JPA 주요 기능

JPA란?

JPA(Java Persistence API)는 자바 진영의 ORM 기술 표준입니다. JPA를 사용하면 개발자가 직접 SQL을 작성하지 않고도 데이터베이스를 객체지향적으로 관리할 수 있습니다.

JPA 소개

ORM(Object-Relational Mapping)

객체와 테이블을 1:1로 매핑하여 SQL을 직접 사용하지 않고도 데이터베이스를 조작할 수 있도록 도와주는 기술입니다.

•

Persistence Framework

•

ORM vs SQL Mapper

Persistence Framework

•

ORM

ORM

엔터티(Entity)

@Entity 어노테이션을 사용하여 정의됩니다. 각 엔터티는 고유한 식별자(@Id)를 가지며, 데이터베이스 테이블의 레코드를 자바 객체로 표현합니다.

•

주요 어노테이션

•

엔터티 예시 코드

주요 어노테이션

엔터티

관계 매핑

JPA 관계 매핑 개념

JPA에서 엔터티 간의 관계를 설정할 때 연관 관계 매핑을 사용합니다. 관계는 다음과 같이 분류됩니다.

•

 1:1 (One-To-One) → @OneToOne

•

 1:N (One-To-Many) → @OneToMany

•

 N:1 (Many-To-One) → @ManyToOne

•

 N:M (Many-To-Many) → @ManyToMany

이 중 1:N & N:1 관계는 가장 많이 사용되며, 실무에서는 중간 테이블을 이용한 Many-To-Many 해결 방법이 일반적입니다.

관계 매핑

JPA 주요 어노테이션

JPA에서 자주 사용되는 어노테이션을 기본 엔터티, 관계 매핑, 기타 기능으로 분류하여 정리했습니다.

엔터티 기본 어노테이션

관계 매핑 어노테이션

기타 주요 어노테이션

주요 어노테이션

JPQL (Java Persistence Query Language)

JPQL 정의

특징

•

SQL과 유사한 문법을 사용하지만 테이블이 아닌 엔터티 객체를 대상으로 실행

•

데이터베이스 독립적으로 사용 가능

JPQL

Criteria API

Criteria API는 JPA에서 타입 안전한 동적 쿼리를 생성할 수 있도록 지원하는 기능입니다.

Criteria API 정의

특징

•

JPQL과 동일한 기능을 제공하면서 컴파일 시점에 오류를 확인 가능

•

메서드 체이닝 방식으로 복잡한 동적 쿼리를 깔끔하게 작성 가능

•

SQL Injection 방지 효과

•

유지보수성이 높음

주요 클래스 및 메서드

클래스	설명
CriteriaBuilder	쿼리 생성에 필요한 연산을 제공 (연산, 비교, 논리 연산 등)
CriteriaQuery<T>	쿼리 객체, SELECT, WHERE, ORDER BY 등을 설정
Root<T>	조회 대상 엔터티를 지정
Predicate	WHERE 절 조건을 표현
Join<T, X>	엔터티 간의 JOIN을 수행

Criteria API 핵심 사용법

Criteria API 기본 구조

CriteriaBuilder → CriteriaQuery → Root → 쿼리 실행

WHERE 조건 추가

cb.equal()을 사용하여 WHERE username = 'John' 조건 추가

ORDER BY 정렬

COUNT 사용

JOIN 활용

root.join("user") → Users 엔터티와 JOIN 수행

Criteria API 예제 코드

사용자 이름으로 조회

특정 사용자의 게시글 목록 조회

특정 사용자의 파일 개수 조회

Criteria API 요약

JPQL과 동일한 기능을 제공하지만, 타입 안전성을 보장

컴파일 시점 오류 검출 가능 → 유지보수성이 뛰어남

메서드 체이닝 방식으로 가독성이 높고, 동적 쿼리에 적합

SQL Injection 방지 효과

복잡한 동적 쿼리에서도 깔끔한 코드 유지 가능

Criteria API를 활용해 동적 쿼리를 안전하고 유연하게 작성하세요!

Criteria API

Querydsl

기존 JPQL과 Criteria API의 복잡한 코드 작성을 단순화하면서도 가독성과 유지보수성을 높여주는 기능을 제공합니다.

Querydsl 정의

동적 쿼리를 간결한 코드로 작성할 수 있으며, 컴파일 시점에서 오류를 검출할 수 있습니다.

Querydsl