[CXF-8066] Support Doclet API (JDK13+)

• Type: Improvement
• Status: Closed
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 3.3.2
• Fix Version/s: 3.3.3
• Estimated Complexity: Unknown
• Assignee: Andriy Redko
• Reporter: Andriy Redko
• Created: 01/Jul/19 22:25
• Updated: 14/Aug/19 13:29
• Resolved: 13/Jul/19 16:32

Description

The com.sun.javadoc.* API is gone in JDK 13 and is replaced with Doclet API. As such, the CXF builds are started to fail on JDK13 for

cxf-java2wadl-plugin

 Example:

[INFO] ------------------------------------------------------------------------
[ERROR] Failed to execute goal org.apache.maven.plugins:maven-compiler-plugin:3.8.1:compile (default-compile) on project cxf-java2wadl-plugin: Fatal error compiling: CompilerException: NullPointerException -> [Help 1]
[ERROR] 
[ERROR] To see the full stack trace of the errors, re-run Maven with the -e switch.
[ERROR] Re-run Maven using the -X switch to enable full debug logging.
[ERROR] 
[ERROR] For more information about the errors and possible solutions, please read the following articles:
[ERROR] [Help 1] http://cwiki.apache.org/confluence/display/MAVEN/MojoExecutionException
[ERROR] 
[ERROR] After correcting the problems, you can resume the build with the command
[ERROR]   mvn <goals> -rf :cxf-java2wadl-plugin

(by adding the <forceJavacCompilerUse>true</forceJavacCompilerUse> to maven-compiler-plugin it is possible to get the clear error).

The official migration guide: https://download.java.net/java/early_access/jdk13/docs/api/jdk.javadoc/jdk/javadoc/doclet/package-summary.html#migration

We may need to introduce the multi-release JAR since the Java 8/9/10/11 and 13+ implementation are not compatible.

Related projects / issues:

• maven-javadoc-plugin (is still using the old API): https://builds.apache.org/job/maven-box/job/maven-javadoc-plugin/job/master
• https://bugs.openjdk.java.net/browse/JDK-8215608
• https://bugs.openjdk.java.net/browse/JDK-8199325
• https://jdk.java.net/13/release-notes

 

Issue Links

• is related to: CXF-8074 Use toolchain to build multi-release JARs
• links to: GitHub Pull Request #566