📘 QueryDSL 완전 가이드

✅ 1. QueryDSL이란?

• Java 코드 기반의 JPQL 생성기입니다.
• 쿼리를 Java 문법으로 작성하므로 컴파일 시점에 오류를 잡을 수 있어 타입 안전합니다.
• 복잡한 조건이나 동적 쿼리 작성에 매우 강력합니다.

✅ 2. Gradle 설정 (Q클래스 생성 포함)

📦 build.gradle.kts (Kotlin DSL)

plugins {
    id("com.ewerk.gradle.plugins.querydsl") version "1.0.10"
    id("java")
}

dependencies {
    implementation("com.querydsl:querydsl-jpa:5.1.0")
    annotationProcessor("com.querydsl:querydsl-apt:5.1.0:jpa") // Q클래스 생성용
    annotationProcessor("jakarta.persistence:jakarta.persistence-api:3.1.0")
    annotationProcessor("jakarta.annotation:jakarta.annotation-api:2.1.1")
}

val querydslDir = "$buildDir/generated/querydsl"

sourceSets {
    main {
        java {
            srcDir(querydslDir)
        }
    }
}

tasks.withType<JavaCompile> {
    options.annotationProcessorGeneratedSourcesDirectory = file(querydslDir)
}

💡 주의: Kotlin을 쓰지 않는다면 build.gradle (Groovy DSL)로 알려주세요. 해당 버전도 제공 가능합니다.

✅ 3. 엔티티 클래스 예시

@Entity
public class Member {
    @Id
    @GeneratedValue
    private Long id;

    private String username;

    private int age;

    @ManyToOne(fetch = FetchType.LAZY)
    private Team team;
}

@Entity
public class Team {
    @Id
    @GeneratedValue
    private Long id;

    private String name;
}

✅ 4. Q클래스 생성 방법

✅ ./gradlew clean build 또는 ./gradlew compileJava 를 실행하면 QMember, QTeam 클래스가 build/generated/querydsl 디렉토리에 자동 생성됩니다.

• 생성된 클래스 확인:
  • QMember.java: username, age 등의 필드가 Java 코드로 표현됨
  • QTeam.java: name 등의 필드 포함