[MESOS-10129] Build fails on Maven javadoc generation when using JDK11

• Type: Bug
• Status: Resolved
• Priority: Major
• Resolution: Invalid
• Affects Version/s: master, 1.10.0
• Component/s: build
• Labels: Java11 beginner build java11 jdk11

Environment

Debian 10 Buster (2020-04-29) with OpenJdk 11.0.7 (2020-04-14)

• Flags: Patch
• Assignee: Unassigned
• Reporter: Carlos Saltos
• Created: 17/May/20 16:08
• Updated: 30/Jun/21 13:09
• Resolved: 24/Jun/21 19:09

Description

CURRENT BEHAVIOR:

When using Java 11 (or newer versions) the Javadoc generation step fails with the error:

[ERROR] Failed to execute goal org.apache.maven.plugins:maven-javadoc-plugin:2.8.1:jar (build-and-attach-javadocs) on project mesos: MavenReportException: Error while creating archive:
[ERROR] Exit code: 1 - javadoc: error - The code being documented uses modules but the packages defined in http://download.oracle.com/javase/6/docs/api/ are in the unnamed module.
[ERROR]
[ERROR] Command line was: /usr/lib/jvm/java-11-openjdk-amd64/bin/javadoc @options
[ERROR]
[ERROR] Refer to the generated Javadoc files in '/home/admin/mesos-deb-packaging/mesos-repo/build/src/java/target/apidocs' dir.
[ERROR] -> [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
make[1]: *** [Makefile:17533: java/target/mesos-1.11.0.jar] Error 1
make[1]: Leaving directory '/home/admin/mesos-deb-packaging/mesos-repo/build/src'
make: *** [Makefile:785: all-recursive] Error 1

NOTE: The error is at the Maven javadoc plugin call when it tries to include references to the non-existant old Java 6 documentation.

POSSIBLE SOLUTION:

Just remove the old reference with adding <detectJavaApiLink>false</detectJavaApiLink> to the  javadoc maven plugin configuration section

Issue Links

• links to: GitHub Pull Request #364