Skip to content

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Repository files navigation

QueryDSL 학습 프로젝트

Spring Boot + QueryDSL을 활용한 타입 안전 쿼리 작성법을 학습하기 위한 실습 프로젝트입니다.


기술 스택

분류 기술
Language Java 17
Framework Spring Boot 3.4.0
ORM Spring Data JPA / Hibernate
QueryDSL querydsl-jpa 5.0.0 (Jakarta)
Database H2 (TCP 모드)
Build Gradle
Test JUnit 5, AssertJ

프로젝트 구조

src/
├── main/
│   ├── java/study/querydsl/
│   │   ├── QuerydslApplication.java    # Spring Boot 진입점
│   │   ├── entity/
│   │   │   ├── Hello.java              # QueryDSL Q타입 동작 확인용 엔티티
│   │   │   ├── Member.java             # 회원 엔티티 (N:1 → Team)
│   │   │   └── Team.java               # 팀 엔티티 (1:N → Member)
│   │   └── dto/
│   │       ├── MemberDto.java          # @QueryProjection 활용 DTO
│   │       └── UserDto.java            # 필드명 매핑 연습용 DTO
│   └── resources/
│       └── application.yml
└── test/
    └── java/study/querydsl/
        ├── QuerydslApplicationTests.java   # QueryDSL 기본 동작 확인
        ├── QuerydslBasicTest.java          # QueryDSL 핵심 기능 전체 예제
        └── entity/
            └── MemberTest.java             # 엔티티 연관관계 확인

실행 방법

1. H2 서버 실행

이 프로젝트는 H2 TCP 모드를 사용합니다. 애플리케이션 또는 테스트 실행 전에 H2 서버를 먼저 시작해야 합니다.

java -cp h2*.jar org.h2.tools.Server -tcp -tcpAllowOthers -start

JDBC URL: jdbc:h2:tcp://localhost/~/querydsl

2. Q타입 생성

QueryDSL은 @Entity 클래스를 분석해 Q타입 클래스를 자동 생성합니다.
아래 Gradle 태스크를 실행하면 build/generated 경로에 생성됩니다.

./gradlew compileJava

3. 테스트 실행

./gradlew test

학습 내용

QuerydslBasicTest.java — 핵심 학습 파일

테스트 메서드 학습 주제
startJPQL / startQuerydsl JPQL vs QueryDSL 비교
search 다중 조건 AND 쿼리 (, 구분자)
resultFetch fetch / fetchOne / fetchFirst / fetchResults / fetchCount
sort 정렬: orderBy, nullsLast
paging1 / paging2 페이징: offset, limit
aggregation 집계 함수: COUNT, SUM, AVG, MAX, MIN
group GROUP BY + AVG
join 내부 조인
theta_join 세타 조인 (연관관계 없는 엔티티 조인)
join_on_filtering LEFT JOIN + ON 절
join_on_no_relation 연관관계 없는 외부 조인
fetchJoinNo / fetchJoinUse Lazy Loading vs Fetch Join
subQuery / subQueryGoe / subQueryIn 서브쿼리
selectSubQuery SELECT 절 서브쿼리
basicCase / complexCase CASE 표현식
constant / concat 상수, 문자열 연결
simpleProjection / tupleProjection 단일/복수 프로젝션
findDtoByJPQL JPQL 생성자 프로젝션
findDtoBySetter Projections.bean() (Setter 방식)
findDtoByField Projections.fields() (필드 직접 주입)
findDtoByConstructor Projections.constructor()
findUserDto 필드명 불일치 시 .as() 별칭 사용
findDtoByQueryProjection @QueryProjection 타입 안전 프로젝션
dynamicQuery_BooleanBuilder BooleanBuilder 동적 쿼리
dynamicQuery_WhereParam where 파라미터 null 처리 동적 쿼리
bulkUpdate / bulkAdd / bulkDelete 벌크 연산 + 영속성 컨텍스트 초기화
sqlFunction / sqlFunction2 SQL 함수 호출

주요 개념 설명

Q타입이란?

QueryDSL은 @Entity 클래스를 분석하여 QMember, QTeam 같은 Q타입 클래스를 자동 생성합니다.
이를 통해 문자열 대신 자바 코드로 타입 안전하게 쿼리를 작성할 수 있습니다.

// JPQL (문자열 기반 - 오타가 컴파일 시 잡히지 않음)
em.createQuery("select m from Member m where m.username = :username", Member.class)

// QueryDSL (타입 안전 - 오타가 컴파일 시 즉시 감지됨)
queryFactory.selectFrom(member)
    .where(member.username.eq("member1"))
    .fetchOne();

동적 쿼리 패턴

BooleanBuilder 방식:

BooleanBuilder builder = new BooleanBuilder();
if (usernameCond != null) builder.and(member.username.eq(usernameCond));
if (ageCond != null)      builder.and(member.age.eq(ageCond));
queryFactory.selectFrom(member).where(builder).fetch();

Where 다중 파라미터 방식 (실무 권장):

queryFactory.selectFrom(member)
    .where(usernameEq(usernameCond), ageEq(ageCond)) // null이면 자동으로 무시됨
    .fetch();

private BooleanExpression usernameEq(String cond) {
    return cond != null ? member.username.eq(cond) : null;
}

프로젝션 방식 비교

방식 특징
Projections.bean() Setter 호출, 기본 생성자 필요
Projections.fields() 필드 직접 주입, Setter 불필요
Projections.constructor() 생성자 주입, 타입으로 매칭
@QueryProjection 가장 타입 안전하나 DTO가 QueryDSL에 의존

벌크 연산 주의사항

벌크 연산(update/delete)은 영속성 컨텍스트를 거치지 않고 DB에 직접 반영됩니다.
따라서 실행 후 반드시 영속성 컨텍스트를 초기화해야 합니다.

queryFactory.update(member).set(member.username, "비회원")
    .where(member.age.lt(28)).execute();

em.flush();
em.clear(); // 반드시 초기화!

엔티티 관계

Team (1) ──────────── (*) Member
  - id (PK)                - id (PK)
  - name                   - username
  - members                - age
                           - team (FK)
  • Member.changeTeam() : 팀 변경 시 양방향 관계를 한 번에 처리

참고사항

  • 이 프로젝트는 학습용 예제입니다. 서비스/컨트롤러 계층 없이 테스트 코드로만 구성되어 있습니다.
  • MemberTest의 @Commit은 H2 콘솔에서 데이터를 직접 확인하기 위해 의도적으로 설정된 것입니다.
  • QueryDSL 5.0.0에서 fetchResults(), fetchCount()는 Deprecated 상태이므로, 실제 프로젝트에서는 fetch() + 별도 count 쿼리 분리를 권장합니다.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages