true to include debugging information in the compiled class files.
+ * @see javac -g
+ * @see #debuglevel
*/
@Parameter(property = "maven.compiler.debug", defaultValue = "true")
private boolean debug = true;
@@ -145,19 +145,23 @@ public abstract class AbstractCompilerMojo extends AbstractMojo {
/**
* Set to true to generate metadata for reflection on method parameters.
* @since 3.6.2
+ * @see javac -parameters
*/
@Parameter(property = "maven.compiler.parameters", defaultValue = "false")
private boolean parameters;
/**
- * Set to true to Enable preview language features of the java compiler
+ * Set to true to enable preview language features of the java compiler
* @since 3.10.1
+ * @see javac --enable-preview
*/
@Parameter(property = "maven.compiler.enablePreview", defaultValue = "false")
private boolean enablePreview;
/**
* Set to true to show messages about what the compiler is doing.
+ *
+ * @see javac -verbose
*/
@Parameter(property = "maven.compiler.verbose", defaultValue = "false")
private boolean verbose;
@@ -183,39 +187,44 @@ public abstract class AbstractCompilerMojo extends AbstractMojo {
private boolean showWarnings;
/**
- * The -source argument for the Java compiler.
+ *The {@code -source} argument for the Java compiler.
* *NOTE:
*Since 3.8.0 the default value has changed from 1.5 to 1.6
*Since 3.9.0 the default value has changed from 1.6 to 1.7
*Since 3.11.0 the default value has changed from 1.7 to 1.8
+ * @see javac -source */ @Parameter(property = "maven.compiler.source", defaultValue = DEFAULT_SOURCE) protected String source; /** - *The -target argument for the Java compiler.
+ *The {@code -target} argument for the Java compiler.
* *NOTE:
*Since 3.8.0 the default value has changed from 1.5 to 1.6
*Since 3.9.0 the default value has changed from 1.6 to 1.7
*Since 3.11.0 the default value has changed from 1.7 to 1.8
+ * + * @see javac -target */ @Parameter(property = "maven.compiler.target", defaultValue = DEFAULT_TARGET) protected String target; /** - * The -release argument for the Java compiler, supported since Java9 + * The {@code -release} argument for the Java compiler, supported since Java9 * * @since 3.6 + * @see javac -release */ @Parameter(property = "maven.compiler.release") protected String release; /** - * The -encoding argument for the Java compiler. + * The {@code -encoding} argument for the Java compiler. * * @since 2.1 + * @see javac -encoding */ @Parameter(property = "encoding", defaultValue = "${project.build.sourceEncoding}") private String encoding; @@ -236,7 +245,10 @@ public abstract class AbstractCompilerMojo extends AbstractMojo { /** * Version of the compiler to use, ex. "1.3", "1.5", if {@link #fork} is set totrue.
+ * @deprecated This parameter is no longer evaluated by the underlying compilers, instead the actual
+ * version of the {@code javac} binary is automatically retrieved.
*/
+ @Deprecated
@Parameter(property = "maven.compiler.compilerVersion")
private String compilerVersion;
@@ -280,11 +292,16 @@ public abstract class AbstractCompilerMojo extends AbstractMojo {
* none - no annotation processing is performed.only - only annotation processing is done, no compilation.full - annotation processing and compilation.full is the default. Starting with JDK 21, this option must be set explicitly.
+ *
* @since 2.2
+ * @see javac -proc
+ * @see javac Annotation Processing
*/
- @Parameter
+ @Parameter(property = "maven.compiler.proc")
private String proc;
/**
@@ -294,6 +311,8 @@ public abstract class AbstractCompilerMojo extends AbstractMojo {
*
*
* @since 2.2
+ * @see javac -processor
+ * @see javac Annotation Processing
*/
@Parameter
private String[] annotationProcessors;
@@ -332,6 +351,9 @@ public abstract class AbstractCompilerMojo extends AbstractMojo {
* Note: Exclusions are supported from version 3.11.0.
*
* @since 3.5
+ * @see javac -processorpath
+ * @see javac Annotation Processing
+ *
*/
@Parameter
private List* This flag does not enable / disable the ability to resolve the version of annotation processor paths - * from dependency management section. It only influences the resolution o transitive dependencies of those + * from dependency management section. It only influences the resolution of transitive dependencies of those * top-level paths. *
* @@ -400,6 +422,7 @@ public abstract class AbstractCompilerMojo extends AbstractMojo { * * * @since 3.1 + * @see javac -J */ @Parameter protected List* Note that {@code -J} options are only passed through if {@link #fork} is set to {@code true}. *
+ * @see javac -J */ @Parameter protected String compilerArgument; @@ -432,9 +456,10 @@ public abstract class AbstractCompilerMojo extends AbstractMojo { * Keyword list to be appended to the-g command-line switch. Legal values are none or a
* comma-separated list of the following keywords: lines, vars, and source.
* If debug level is not specified, by default, nothing will be appended to -g.
- * If debug is not turned on, this attribute will be ignored.
+ * If {@link #debug} is not turned on, this attribute will be ignored.
*
* @since 2.1
+ * @see javac -G:[lines,vars,source]
*/
@Parameter(property = "maven.compiler.debuglevel")
private String debuglevel;
@@ -443,6 +468,7 @@ public abstract class AbstractCompilerMojo extends AbstractMojo {
* Keyword to be appended to the -implicit: command-line switch.
*
* @since 3.10.2
+ * @see javac -implicit
*/
@Parameter(property = "maven.compiler.implicit")
private String implicit;
@@ -543,14 +569,28 @@ public abstract class AbstractCompilerMojo extends AbstractMojo {
private boolean skipMultiThreadWarning;
/**
- * compiler can now use javax.tools if available in your current jdk, you can disable this feature
- * using -Dmaven.compiler.forceJavacCompilerUse=true or in the plugin configuration
- *
+ * Legacy parameter name of {@link #forceLegacyJavacApi}. Only considered if {@link #forceLegacyJavacApi} is
+ * not set or {@code false}.
* @since 3.0
+ * @deprecated Use {@link #forceLegacyJavacApi} instead
*/
+ @Deprecated
@Parameter(defaultValue = "false", property = "maven.compiler.forceJavacCompilerUse")
private boolean forceJavacCompilerUse;
+ /**
+ * The underlying compiler now uses {@code javax.tools} API
+ * if available in your current JDK.
+ * Set this to {@code true} to always use the legacy
+ * {@code com.sun.tools.javac} API instead.
+ *
+ * This only has an effect for {@link #compilerId} being {@code javac} and {@link #fork} being {@code false}.
+ *
+ * @since 3.13
+ */
+ @Parameter(defaultValue = "false", property = "maven.compiler.forceLegacyJavacApi")
+ private boolean forceLegacyJavacApi;
+
/**
* @since 3.0 needed for storing the status for the incremental build support.
*/
@@ -680,7 +720,7 @@ public void execute() throws MojoExecutionException, CompilationFailureException
try {
compiler = compilerManager.getCompiler(compilerId);
} catch (NoSuchCompilerException e) {
- throw new MojoExecutionException("No such compiler '" + e.getCompilerId() + "'.");
+ throw new MojoExecutionException("No such compiler '" + e.getCompilerId() + "'.", e);
}
// -----------toolchains start here ----------------------------------
@@ -874,7 +914,7 @@ public void execute() throws MojoExecutionException, CompilationFailureException
getLog().debug("CompilerReuseStrategy: "
+ compilerConfiguration.getCompilerReuseStrategy().getStrategy());
- compilerConfiguration.setForceJavacCompilerUse(forceJavacCompilerUse);
+ compilerConfiguration.setForceJavacCompilerUse(forceLegacyJavacApi || forceJavacCompilerUse);
boolean canUpdateTarget;
@@ -1037,7 +1077,7 @@ public void execute() throws MojoExecutionException, CompilationFailureException
try {
if (fork) {
if (compilerConfiguration.getExecutable() != null) {
- getLog().debug("Excutable: ");
+ getLog().debug("Executable: ");
getLog().debug(" " + compilerConfiguration.getExecutable());
}
}
@@ -1457,31 +1497,13 @@ private String getMemoryValue(String setting) {
return value;
}
- // TODO remove the part with ToolchainManager lookup once we depend on
- // 3.0.9 (have it as prerequisite). Define as regular component field then.
protected final Toolchain getToolchain() {
Toolchain tc = null;
if (jdkToolchain != null) {
- // Maven 3.3.1 has plugin execution scoped Toolchain Support
- try {
- Method getToolchainsMethod = toolchainManager
- .getClass()
- .getMethod("getToolchains", MavenSession.class, String.class, Map.class);
-
- @SuppressWarnings("unchecked")
- List
* Specify where to place generated source files created by annotation processing. Only applies to JDK 1.6+
- *