From 8dce170a12b40d1f4549cbf2d449792a4b927948 Mon Sep 17 00:00:00 2001
From: Mark Paluch <mark.paluch@broadcom.com>
Date: Mon, 17 Feb 2025 11:57:59 +0100
Subject: [PATCH] Update annotation processor documentation for Querydsl.

Reflect jakarta classifiers for Querydsl annotation processing. Also, update to Java 22+ conventions requiring annotation processor paths instead of relying on annotation processors present in dependencies.

Closes gh-1121
---
 .../modules/ROOT/pages/data.adoc              | 73 ++++++++-----------
 1 file changed, 29 insertions(+), 44 deletions(-)

diff --git a/spring-graphql-docs/modules/ROOT/pages/data.adoc b/spring-graphql-docs/modules/ROOT/pages/data.adoc
index b160d4b5..ba42f93f 100644
--- a/spring-graphql-docs/modules/ROOT/pages/data.adoc
+++ b/spring-graphql-docs/modules/ROOT/pages/data.adoc
@@ -77,13 +77,12 @@ Gradle::
 dependencies {
 	//...
 
-	annotationProcessor "com.querydsl:querydsl-apt:$querydslVersion:jpa",
-			'org.hibernate.javax.persistence:hibernate-jpa-2.1-api:1.0.2.Final',
-			'javax.annotation:javax.annotation-api:1.3.2'
+	annotationProcessor "com.querydsl:querydsl-apt:$querydslVersion:jakarta",
+			'jakarta.persistence:jakarta.persistence-api'
 }
 
 compileJava {
-	 options.annotationProcessorPath = configurations.annotationProcessor
+	options.annotationProcessorPath = configurations.annotationProcessor
 }
 ----
 
@@ -91,51 +90,37 @@ Maven::
 +
 [source,xml,indent=0,subs="verbatim,quotes,attributes",role="secondary"]
 ----
-<dependencies>
-	<!-- ... -->
-	<dependency>
-		<groupId>com.querydsl</groupId>
-		<artifactId>querydsl-apt</artifactId>
-		<version>${querydsl.version}</version>
-		<classifier>jpa</classifier>
-		<scope>provided</scope>
-	</dependency>
-	<dependency>
-		<groupId>org.hibernate.javax.persistence</groupId>
-		<artifactId>hibernate-jpa-2.1-api</artifactId>
-		<version>1.0.2.Final</version>
-	</dependency>
-	<dependency>
-		<groupId>javax.annotation</groupId>
-		<artifactId>javax.annotation-api</artifactId>
-		<version>1.3.2</version>
-	</dependency>
-</dependencies>
-<plugins>
-	<!-- Annotation processor configuration -->
-	<plugin>
-		<groupId>com.mysema.maven</groupId>
-		<artifactId>apt-maven-plugin</artifactId>
-		<version>${apt-maven-plugin.version}</version>
-		<executions>
-			<execution>
-				<goals>
-					<goal>process</goal>
-				</goals>
+<build>
+	<plugins>
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-compiler-plugin</artifactId>
 				<configuration>
-					<outputDirectory>target/generated-sources/java</outputDirectory>
-					<processor>com.querydsl.apt.jpa.JPAAnnotationProcessor</processor>
+					<annotationProcessorPaths>
+						<!-- Explicit opt-in required via annotationProcessors or
+										annotationProcessorPaths on Java 22+, see https://bugs.openjdk.org/browse/JDK-8306819 -->
+						<annotationProcessorPath>
+							<groupId>com.querydsl</groupId>
+							<artifactId>querydsl-apt</artifactId>
+							<version>${querydsl.version}</version>
+							<classifier>jakarta</classifier>
+						</annotationProcessorPath>
+						<annotationProcessorPath>
+							<groupId>jakarta.persistence</groupId>
+							<artifactId>jakarta.persistence-api</artifactId>
+						</annotationProcessorPath>
+					</annotationProcessorPaths>
+
+					<!-- Recommended: Some IDE's might require this configuration to include generated sources for IDE usage -->
+					<generatedTestSourcesDirectory>target/generated-test-sources</generatedTestSourcesDirectory>
+					<generatedSourcesDirectory>target/generated-sources</generatedSourcesDirectory>
 				</configuration>
-			</execution>
-		</executions>
-	</plugin>
-</plugins>
+			</plugin>
+	</plugins>
+</build>
 ----
 ======
 
-The {github-10x-branch}/samples/webmvc-http[webmvc-http] sample uses Querydsl for
-`artifactRepositories`.
-
 
 [[data.querydsl.customizations]]
 === Customizations