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 # 엔티티 연관관계 확인
이 프로젝트는 H2 TCP 모드를 사용합니다. 애플리케이션 또는 테스트 실행 전에 H2 서버를 먼저 시작해야 합니다.
java -cp h2*.jar org.h2.tools.Server -tcp -tcpAllowOthers -startJDBC URL:
jdbc:h2:tcp://localhost/~/querydsl
QueryDSL은 @Entity 클래스를 분석해 Q타입 클래스를 자동 생성합니다.
아래 Gradle 태스크를 실행하면 build/generated 경로에 생성됩니다.
./gradlew compileJava./gradlew test| 테스트 메서드 | 학습 주제 |
|---|---|
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 함수 호출 |
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 쿼리 분리를 권장합니다.