Querydsl

Querydsl은 타입 안전한 SQL 및 JPQL 쿼리를 생성할 수 있도록 도와주는 프레임워크입니다.

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

Querydsl 정의

Querydsl은 SQL, JPQL, JPA를 쉽게 다룰 수 있도록 지원하는 타입 안전한 쿼리 빌더 API입니다.

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

특징

•

SQL, JPQL, JPA, MongoDB 등 다양한 데이터베이스와 호환

•

코드 자동 생성(Q-Class)으로 직관적인 메서드 체이닝 지원

•

메서드 체이닝 방식으로 가독성이 뛰어남

•

JPQL과 동일한 기능을 제공하면서도 더 간결한 코드 작성 가능

•

컴파일 타임 타입 체크 지원 → 오류를 사전에 방지

Querydsl 주요 어노테이션 및 클래스

클래스	설명
JPAQueryFactory	Querydsl의 쿼리 빌더 객체 (쿼리 실행을 위한 중심 클래스)
QEntity	Querydsl이 자동 생성한 엔터티 클래스 (예: QUsers, QBoards)
BooleanExpression	where() 조건을 동적으로 추가할 때 사용
Projections	DTO 매핑 시 사용
Expressions	복잡한 연산을 수행할 때 사용

Querydsl 설정 및 기본 사용법

Querydsl 설정 (Spring Boot 기준)

1. Gradle 의존성 추가

dependencies {
    implementation 'com.querydsl:querydsl-jpa:5.0.0'
    annotationProcessor 'com.querydsl:querydsl-apt:5.0.0:jpa'
}
Plain Text
복사

2. QClass 자동 생성 플러그인 추가

tasks.withType(JavaCompile).configureEach {
    options.annotationProcessorGeneratedSourcesDirectory = file("$buildDir/generated")
}
Plain Text
복사

3. QClass 빌드 (자동 생성)

./gradlew clean compileJava
Plain Text
복사

실행 후 build/generated 폴더에 QEntity 클래스 자동 생성됨

Querydsl 핵심 사용법

JPAQueryFactory 설정

@RequiredArgsConstructor
@Repository
public class UserRepository {

    private final JPAQueryFactory queryFactory;
}
Java
복사

JPAQueryFactory를 사용하면 EntityManager 없이도 쿼리 실행 가능

전체 조회 (SELECT)

public List<Users> findAllUsers() {
    QUsers users = QUsers.users; // Querydsl이 자동 생성한 QClass

    return queryFactory
        .selectFrom(users)
        .fetch();
}
Java
복사

selectFrom(QEntity)을 사용하여 전체 데이터를 조회

조건 검색 (WHERE)

public Users findByUsername(String username) {
    QUsers users = QUsers.users;

    return queryFactory
        .selectFrom(users)
        .where(users.username.eq(username))
        .fetchOne();
}
Java
복사

users.username.eq(username) → WHERE username = 'John'

여러 조건 동적 검색 (BooleanExpression 활용)

public List<Users> findUsers(String username, Integer age) {
    QUsers users = QUsers.users;

    return queryFactory
        .selectFrom(users)
        .where(eqUsername(username), eqAge(age))
        .fetch();
}

private BooleanExpression eqUsername(String username) {
    return username != null ? QUsers.users.username.eq(username) : null;
}

private BooleanExpression eqAge(Integer age) {
    return age != null ? QUsers.users.age.eq(age) : null;
}
Java
복사

BooleanExpression을 활용하면 동적 쿼리를 간결하게 작성 가능

정렬 (ORDER BY)

public List<Users> findUsersSortedByAge() {
    QUsers users = QUsers.users;

    return queryFactory
        .selectFrom(users)
        .orderBy(users.age.desc())  // 나이 내림차순 정렬
        .fetch();
}
Java
복사

페이징 (LIMIT & OFFSET)

public List<Users> findUsersWithPaging(int offset, int limit) {
    QUsers users = QUsers.users;

    return queryFactory
        .selectFrom(users)
        .orderBy(users.id.asc())
        .offset(offset)
        .limit(limit)
        .fetch();
}
Java
복사

offset(0).limit(10) → 첫 번째 페이지, 10개 데이터 조회

JOIN 활용

public List<Boards> findBoardsWithUser(Long userId) {
    QBoards boards = QBoards.boards;
    QUsers users = QUsers.users;

    return queryFactory
        .selectFrom(boards)
        .join(boards.user, users) // Boards → Users JOIN
        .where(users.id.eq(userId))
        .fetch();
}
Java
복사

join(boards.user, users) → Boards 엔터티에서 Users와 조인

DTO 매핑 (Projections 활용)

public List<UserDTO> findUsersAsDTO() {
    QUsers users = QUsers.users;

    return queryFactory
        .select(Projections.constructor(UserDTO.class, users.id, users.username, users.age))
        .from(users)
        .fetch();
}
Java
복사

Projections.constructor()를 사용하여 DTO로 변환

Querydsl vs JPQL vs Criteria API 비교

비교 항목	Querydsl	JPQL	Criteria API
타입 안전성	높음 (컴파일 타임 체크)	없음	있음
가독성	우수	복잡함	길고 가독성 낮음
동적 쿼리 지원	우수	부족	가능하지만 코드 복잡
페이징 지원	간결	직접 작성해야 함	가능
JOIN 처리	직관적	복잡	가능하지만 코드 길어짐

Querydsl 요약

타입 안전한 동적 쿼리 작성 가능

JPQL보다 간결하고 유지보수성이 뛰어남

메서드 체이닝 방식으로 가독성이 높음

QClass 자동 생성으로 개발 편의성 증가

페이징, JOIN, DTO 변환을 쉽게 처리 가능

Querydsl을 활용하면 복잡한 JPQL을 쉽게 대체할 수 있습니다!

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

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

Criteria API 정의

특징

•

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

Criteria API

Querydsl

Querydsl은 타입 안전한 SQL 및 JPQL 쿼리를 생성할 수 있도록 도와주는 프레임워크입니다.

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

Querydsl 정의

Querydsl은 SQL, JPQL, JPA를 쉽게 다룰 수 있도록 지원하는 타입 안전한 쿼리 빌더 API입니다.

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

특징

•

SQL, JPQL, JPA, MongoDB 등 다양한 데이터베이스와 호환

•

코드 자동 생성(Q-Class)으로 직관적인 메서드 체이닝 지원

•

메서드 체이닝 방식으로 가독성이 뛰어남

•

JPQL과 동일한 기능을 제공하면서도 더 간결한 코드 작성 가능

•

컴파일 타임 타입 체크 지원 → 오류를 사전에 방지

Querydsl 주요 어노테이션 및 클래스

클래스	설명
JPAQueryFactory	Querydsl의 쿼리 빌더 객체 (쿼리 실행을 위한 중심 클래스)
QEntity	Querydsl이 자동 생성한 엔터티 클래스 (예: QUsers, QBoards)
BooleanExpression	where() 조건을 동적으로 추가할 때 사용
Projections	DTO 매핑 시 사용
Expressions	복잡한 연산을 수행할 때 사용

Querydsl 설정 및 기본 사용법

Querydsl 설정 (Spring Boot 기준)

1. Gradle 의존성 추가

2. QClass 자동 생성 플러그인 추가

3. QClass 빌드 (자동 생성)

실행 후 build/generated 폴더에 QEntity 클래스 자동 생성됨

Querydsl 핵심 사용법

정렬 (ORDER BY)

페이징 (LIMIT & OFFSET)

offset(0).limit(10) → 첫 번째 페이지, 10개 데이터 조회

JOIN 활용

join(boards.user, users) → Boards 엔터티에서 Users와 조인

DTO 매핑 (Projections 활용)

Projections.constructor()를 사용하여 DTO로 변환

Querydsl vs JPQL vs Criteria API 비교

비교 항목	Querydsl	JPQL	Criteria API
타입 안전성	높음 (컴파일 타임 체크)	없음	있음
가독성	우수	복잡함	길고 가독성 낮음
동적 쿼리 지원	우수	부족	가능하지만 코드 복잡
페이징 지원	간결	직접 작성해야 함	가능
JOIN 처리	직관적	복잡	가능하지만 코드 길어짐

Querydsl 요약

타입 안전한 동적 쿼리 작성 가능

JPQL보다 간결하고 유지보수성이 뛰어남

메서드 체이닝 방식으로 가독성이 높음

QClass 자동 생성으로 개발 편의성 증가

페이징, JOIN, DTO 변환을 쉽게 처리 가능

Querydsl을 활용하면 복잡한 JPQL을 쉽게 대체할 수 있습니다!

Querydsl