[MNG-8015] Adjustments in new API related to PathType (#1501)

* Javadoc cleanup and replacement of some `System.getProperty("...")` by more specific standard methods.

* Add Type.PROCESSOR, MODULAR_PROCESSOR and CLASSPATH_PROCESSOR.

* Modification of the path type API:

* Add a `warningForFilenameBasedAutomodules()` method in `DependencyResolverResult`.
* Add relationships from `JavaPathType` to `javax.tool` location API.
* Modify the `PathType.option(Iterable<? extends Path>)` return type
  because the option and the value need to be two separated arguments.

* Fixes according some comments on the pull request.

api/maven-api-core/src/main/java/org/apache/maven/api/JavaPathType.java

@@ -18,6 +18,10 @@
  */
 package org.apache.maven.api;
 
+import javax.tools.DocumentationTool;
+import javax.tools.JavaFileManager;
+import javax.tools.StandardLocation;
+
 import java.io.File;
 import java.nio.file.Path;
 import java.util.Objects;
@@ -40,6 +44,13 @@ import org.apache.maven.api.annotations.Nonnull;
  * <p>Path types are often exclusive. For example, a dependency should not be both on the Java class-path
  * and on the Java module-path.</p>
  *
+ * <h2>Relationship with Java compiler standard location</h2>
+ * This enumeration is closely related to the {@link JavaFileManager.Location} enumerations.
+ * A difference is that the latter enumerates input and output files, while {@code JavaPathType}
+ * enumerates only input dependencies. Another difference is that {@code JavaPathType} contains
+ * some enumeration values used only at runtime and therefore not available in {@code javax.tool},
+ * such as agent paths.
+ *
  * @see org.apache.maven.api.services.DependencyResolverResult#getDispatchedPaths()
  *
  * @since 4.0.0
@@ -49,11 +60,12 @@ public enum JavaPathType implements PathType {
     /**
      * The path identified by the Java {@code --class-path} option.
      * Used for compilation, execution and Javadoc among others.
+     * The Java tools location is {@link StandardLocation#CLASS_PATH}.
      *
-     * <p><b>Context-sensitive interpretation:</b>
+     * <h4>Context-sensitive interpretation</h4>
      * A dependency with this path type will not necessarily be placed on the class-path.
      * There are two circumstances where the dependency may nevertheless be placed somewhere else:
-     * </p>
+     *
      * <ul>
      *   <li>If {@link #MODULES} path type is also set, then the dependency can be placed either on the
      *       class-path or on the module-path, but only one of those. The choice is up to the plugin,
@@ -63,16 +75,17 @@ public enum JavaPathType implements PathType {
      *       class-path.</li>
      * </ul>
      */
-    CLASSES("--class-path"),
+    CLASSES(StandardLocation.CLASS_PATH, "--class-path"),
 
     /**
      * The path identified by the Java {@code --module-path} option.
      * Used for compilation, execution and Javadoc among others.
+     * The Java tools location is {@link StandardLocation#MODULE_PATH}.
      *
-     * <p><b>Context-sensitive interpretation:</b>
+     * <h4>Context-sensitive interpretation</h4>
      * A dependency with this flag will not necessarily be placed on the module-path.
      * There are two circumstances where the dependency may nevertheless be placed somewhere else:
-     * </p>
+     *
      * <ul>
      *   <li>If {@link #CLASSES} path type is also set, then the dependency <em>should</em> be placed on the
      *       module-path, but is also compatible with placement on the class-path. Compatibility can
@@ -84,57 +97,63 @@ public enum JavaPathType implements PathType {
      *       {@code --module-path} option.</li>
      * </ul>
      */
-    MODULES("--module-path"),
+    MODULES(StandardLocation.MODULE_PATH, "--module-path"),
 
     /**
      * The path identified by the Java {@code --upgrade-module-path} option.
+     * The Java tools location is {@link StandardLocation#UPGRADE_MODULE_PATH}.
      */
-    UPGRADE_MODULES("--upgrade-module-path"),
+    UPGRADE_MODULES(StandardLocation.UPGRADE_MODULE_PATH, "--upgrade-module-path"),
 
     /**
      * The path identified by the Java {@code --patch-module} option.
+     * The Java tools location is {@link StandardLocation#PATCH_MODULE_PATH}.
+     *
      * Note that this option is incomplete, because it must be followed by a module name.
      * Use this type only when the module to patch is unknown.
      *
      * @see #patchModule(String)
      */
-    PATCH_MODULE("--patch-module"),
+    PATCH_MODULE(StandardLocation.PATCH_MODULE_PATH, "--patch-module"),
 
     /**
      * The path identified by the Java {@code --processor-path} option.
+     * The Java tools location is {@link StandardLocation#ANNOTATION_PROCESSOR_PATH}.
      */
-    PROCESSOR_CLASSES("--processor-path"),
+    PROCESSOR_CLASSES(StandardLocation.ANNOTATION_PROCESSOR_PATH, "--processor-path"),
 
     /**
      * The path identified by the Java {@code --processor-module-path} option.
+     * The Java tools location is {@link StandardLocation#ANNOTATION_PROCESSOR_MODULE_PATH}.
      */
-    PROCESSOR_MODULES("--processor-module-path"),
+    PROCESSOR_MODULES(StandardLocation.ANNOTATION_PROCESSOR_MODULE_PATH, "--processor-module-path"),
 
     /**
      * The path identified by the Java {@code -agentpath} option.
      */
-    AGENT("-agentpath"),
+    AGENT(null, "-agentpath"),
 
     /**
      * The path identified by the Javadoc {@code -doclet} option.
+     * The Java tools location is {@link DocumentationTool.Location#DOCLET_PATH}.
      */
-    DOCLET("-doclet"),
+    DOCLET(DocumentationTool.Location.DOCLET_PATH, "-doclet"),
 
     /**
      * The path identified by the Javadoc {@code -tagletpath} option.
+     * The Java tools location is {@link DocumentationTool.Location#TAGLET_PATH}.
      */
-    TAGLETS("-tagletpath");
+    TAGLETS(DocumentationTool.Location.TAGLET_PATH, "-tagletpath");
 
     /**
      * Creates a path identified by the Java {@code --patch-module} option.
      * Contrarily to the other types of paths, this path is applied to only
      * one specific module. Used for compilation and execution among others.
      *
-     * <p><b>Context-sensitive interpretation:</b>
+     * <h4>Context-sensitive interpretation</h4>
      * This path type makes sense only when a main module is added on the module-path by another dependency.
      * In no main module is found, the patch dependency may be added on the class-path or module-path
      * depending on whether {@link #CLASSES} or {@link #MODULES} is present.
-     * </p>
      *
      * @param moduleName name of the module on which to apply the path
      * @return an identification of the patch-module path for the given module.
@@ -146,6 +165,13 @@ public enum JavaPathType implements PathType {
         return PATCH_MODULE.new Modular(moduleName);
     }
 
+    /**
+     * The {@code javax.tool} enumeration value corresponding to this {@code JavaPathType}, or {@code null} if none.
+     *
+     * @see #location()
+     */
+    private final JavaFileManager.Location location;
+
     /**
      * The tools option for this path, or {@code null} if none.
      *
@@ -156,17 +182,51 @@ public enum JavaPathType implements PathType {
     /**
      * Creates a new enumeration value for a path associated to the given tool option.
      *
+     * @param location the {@code javax.tool} enumeration value, or {@code null} if none.
      * @param option the Java tools option for this path, or {@code null} if none
      */
-    JavaPathType(String option) {
+    JavaPathType(JavaFileManager.Location location, String option) {
+        this.location = location;
         this.option = option;
     }
 
+    /**
+     * Returns the unique name of this path type.
+     *
+     * @return the programmatic name of this enumeration value
+     */
     @Override
     public String id() {
         return name();
     }
 
+    /**
+     * Returns the identification of this path in the {@code javax.tool} API.
+     * The value may be an instance of {@link StandardLocation} or {@link DocumentationTool.Location},
+     * depending which tool will use this location.
+     *
+     * @return the {@code javax.tool} enumeration value corresponding to this {@code JavaPathType}
+     */
+    public Optional<JavaFileManager.Location> location() {
+        return Optional.ofNullable(location);
+    }
+
+    /**
+     * Returns the path type associated to the given {@code javax.tool} location.
+     * This method is the converse of {@link #location()}.
+     *
+     * @param location identification of a path in the {@code javax.tool} API
+     * @return Java path type associated to the given location
+     */
+    public static Optional<JavaPathType> valueOf(JavaFileManager.Location location) {
+        for (JavaPathType type : JavaPathType.values()) {
+            if (location.equals(type.location)) {
+                return Optional.of(type);
+            }
+        }
+        return Optional.empty();
+    }
+
     /**
      * Returns the name of the tool option for this path. For example, if this path type
      * is {@link #MODULES}, then this method returns {@code "--module-path"}. The option
@@ -187,31 +247,38 @@ public enum JavaPathType implements PathType {
      *
      * @param paths the path to format as a tool option
      * @return the option associated to this path type followed by the given path elements,
-     *         or an empty string if there is no path element
+     *         or an empty array if there is no path element
      * @throws IllegalStateException if no option is associated to this path type
      */
     @Nonnull
     @Override
-    public String option(Iterable<? extends Path> paths) {
+    public String[] option(Iterable<? extends Path> paths) {
         return format(null, paths);
     }
 
     /**
      * Implementation shared with {@link Modular}.
      */
-    String format(String moduleName, Iterable<? extends Path> paths) {
+    final String[] format(String moduleName, Iterable<? extends Path> paths) {
         if (option == null) {
             throw new IllegalStateException("No option is associated to this path type.");
         }
-        String prefix = (moduleName == null) ? (option + ' ') : (option + ' ' + moduleName + '=');
+        String prefix = (moduleName == null) ? "" : (moduleName + '=');
         StringJoiner joiner = new StringJoiner(File.pathSeparator, prefix, "");
         joiner.setEmptyValue("");
         for (Path p : paths) {
             joiner.add(p.toString());
         }
-        return joiner.toString();
+        String value = joiner.toString();
+        if (value.isEmpty()) {
+            return new String[0];
+        }
+        return new String[] {option, value};
     }
 
+    /**
+     * {@return a string representation of this path type for debugging purposes}.
+     */
     @Override
     public String toString() {
         return "PathType[" + id() + "]";
@@ -240,11 +307,6 @@ public enum JavaPathType implements PathType {
             this.moduleName = Objects.requireNonNull(moduleName);
         }
 
-        @Override
-        public String id() {
-            return JavaPathType.this.name() + ":" + moduleName;
-        }
-
         /**
          * Returns the type of path without indication about the target module.
          * This is usually {@link #PATCH_MODULE}.
@@ -256,12 +318,23 @@ public enum JavaPathType implements PathType {
             return JavaPathType.this;
         }
 
+        /**
+         * Returns the name of the tool option for this path, including the module name.
+         *
+         * @return name of the tool option for this path, including the module name
+         */
+        @Override
+        public String id() {
+            return JavaPathType.this.name() + ":" + moduleName;
+        }
+
         /**
          * Returns the name of the tool option for this path, not including the module name.
          *
          * @return name of the tool option for this path, not including the module name
          */
         @Nonnull
+        @Override
         public String name() {
             return JavaPathType.this.name();
         }
@@ -295,11 +368,11 @@ public enum JavaPathType implements PathType {
          *
          * @param paths the path to format as a string
          * @return the option associated to this path type followed by the given path elements,
-         *         or an empty string if there is no path element.
+         *         or an empty array if there is no path element.
          */
         @Nonnull
         @Override
-        public String option(Iterable<? extends Path> paths) {
+        public String[] option(Iterable<? extends Path> paths) {
             return format(moduleName, paths);
         }
 

api/maven-api-core/src/main/java/org/apache/maven/api/PathType.java

@@ -61,8 +61,8 @@ public interface PathType {
         }
 
         @Override
-        public String option(Iterable<? extends Path> paths) {
+        public String[] option(Iterable<? extends Path> paths) {
-            return "";
+            return new String[0];
         }
     };
 
@@ -94,23 +94,24 @@ public interface PathType {
      * The path elements are separated by an option-specific or platform-specific separator.
      * If the given {@code paths} argument contains no element, then this method returns an empty string.
      *
-     * <p><b>Examples:</b>
+     * <h4>Examples</h4>
-     * If {@code paths} is a list containing two elements, {@code path1} and {@code path2}, then:
+     * If {@code paths} is a list containing two elements, {@code dir/path1} and {@code dir/path2}, then:
-     * </p>
+     *
      * <ul>
      *   <li>If this type is {@link JavaPathType#MODULES}, then this method returns
-     *       {@code "--module-path path1:path2"} on Unix or {@code "--module-path path1;path2"} on Windows.</li>
+     *       {@code {"--module-path", "dir/path1:dir/path2"}} on Unix or
+     *       {@code {"--module-path", "dir\path1;dir\path2"}} on Windows.</li>
      *   <li>If this type was created by {@code JavaPathType.patchModule("foo.bar")}, then the method returns
-     *       {@code "--patch-module foo.bar=path1:path2"} on Unix or {@code "--patch-module foo.bar=path1;path2"}
+     *       {@code {"--patch-module", "foo.bar=dir/path1:dir/path2"}} on Unix or
-     *       on Windows.</li>
+     *       {@code {"--patch-module", "foo.bar=dir\path1;dir\path2"}} on Windows.</li>
      * </ul>
      *
      * @param paths the path to format as a string
      * @return the option associated to this path type followed by the given path elements,
-     *         or an empty string if there is no path element.
+     *         or an empty array if there is no path element.
      */
     @Nonnull
-    String option(Iterable<? extends Path> paths);
+    String[] option(Iterable<? extends Path> paths);
 
     /**
      * Returns the name of this path type. For example, if this path type
@@ -122,7 +123,7 @@ public interface PathType {
     String name();
 
     /**
-     * Returns a string representation for this extensible enum describing a path type.
+     * {@return a string representation for this extensible enum describing a path type}.
      * For example {@code "PathType[PATCH_MODULE:foo.bar]"}.
      */
     @Nonnull

api/maven-api-core/src/main/java/org/apache/maven/api/Toolchain.java

@@ -30,7 +30,7 @@ import org.apache.maven.api.annotations.Experimental;
 @Experimental
 public interface Toolchain {
     /**
-     * get the type of toolchain.
+     * Gets the type of toolchain.
      *
      * @return the toolchain type
      */
@@ -47,7 +47,8 @@ public interface Toolchain {
     /**
      * Let the toolchain decide if it matches requirements defined
      * in the toolchain plugin configuration.
-     * @param requirements Map<String, String> key value pair, may not be {@code null}
+     *
+     * @param requirements key value pair, may not be {@code null}
      * @return {@code true} if the requirements match, otherwise {@code false}
      */
     boolean matchesRequirements(Map<String, String> requirements);

api/maven-api-core/src/main/java/org/apache/maven/api/Type.java

@@ -81,6 +81,24 @@ public interface Type extends ExtensibleEnum {
      */
     String MODULAR_JAR = "modular-jar";
 
+    /**
+     * Artifact type name for a JAR file that can be placed either on the annotation processor class-path
+     * or module-path. The path (classes or modules) is chosen by the plugin, possibly using heuristic rules.
+     */
+    String PROCESSOR = "processor";
+
+    /**
+     * Artifact type name for a JAR file to unconditionally place on the annotation processor class-path.
+     * If the JAR is modular, its module information are ignored.
+     */
+    String CLASSPATH_PROCESSOR = "classpath-processor";
+
+    /**
+     * Artifact type name for a JAR file to unconditionally place on the annotation processor module-path.
+     * If the JAR is not modular, then it is loaded by Java as an unnamed module.
+     */
+    String MODULAR_PROCESSOR = "modular-processor";
+
     /**
      * Artifact type name for source code packaged in a JAR file.
      */

api/maven-api-core/src/main/java/org/apache/maven/api/plugin/Log.java

@@ -24,8 +24,8 @@ import org.apache.maven.api.annotations.Experimental;
 import org.apache.maven.api.annotations.Provider;
 
 /**
- * This interface supplies the API for providing feedback to the user from the <code>Mojo</code>, using standard
+ * This interface supplies the API for providing feedback to the user from the {@code Mojo},
- * <code>Maven</code> channels.<br>
+ * using standard Maven channels.
  * There should be no big surprises here, although you may notice that the methods accept
  * <code>java.lang.CharSequence</code> rather than <code>java.lang.String</code>. This is provided mainly as a
  * convenience, to enable developers to pass things like <code>java.lang.StringBuffer</code> directly into the logger,
@@ -37,31 +37,31 @@ import org.apache.maven.api.annotations.Provider;
 @Provider
 public interface Log {
     /**
-     * @return true if the <b>debug</b> error level is enabled
+     * {@return true if the <b>debug</b> error level is enabled}.
      */
     boolean isDebugEnabled();
 
     /**
-     * Send a message to the user in the <b>debug</b> error level.
+     * Sends a message to the user in the <b>debug</b> error level.
      *
-     * @param content
+     * @param content the message to log
      */
     void debug(CharSequence content);
 
     /**
-     * Send a message (and accompanying exception) to the user in the <b>debug</b> error level.<br>
+     * Sends a message (and accompanying exception) to the user in the <b>debug</b> error level.
      * The error's stacktrace will be output when this error level is enabled.
      *
-     * @param content
+     * @param content the message to log
-     * @param error
+     * @param error the error that caused this log
      */
     void debug(CharSequence content, Throwable error);
 
     /**
-     * Send an exception to the user in the <b>debug</b> error level.<br>
+     * Sends an exception to the user in the <b>debug</b> error level.
      * The stack trace for this exception will be output when this error level is enabled.
      *
-     * @param error
+     * @param error the error that caused this log
      */
     void debug(Throwable error);
 
@@ -70,31 +70,31 @@ public interface Log {
     void debug(Supplier<String> content, Throwable error);
 
     /**
-     * @return true if the <b>info</b> error level is enabled
+     * {@return true if the <b>info</b> error level is enabled}.
      */
     boolean isInfoEnabled();
 
     /**
-     * Send a message to the user in the <b>info</b> error level.
+     * Sends a message to the user in the <b>info</b> error level.
      *
-     * @param content
+     * @param content the message to log
      */
     void info(CharSequence content);
 
     /**
-     * Send a message (and accompanying exception) to the user in the <b>info</b> error level.<br>
+     * Sends a message (and accompanying exception) to the user in the <b>info</b> error level.
      * The error's stacktrace will be output when this error level is enabled.
      *
-     * @param content
+     * @param content the message to log
-     * @param error
+     * @param error the error that caused this log
      */
     void info(CharSequence content, Throwable error);
 
     /**
-     * Send an exception to the user in the <b>info</b> error level.<br>
+     * Sends an exception to the user in the <b>info</b> error level.
      * The stack trace for this exception will be output when this error level is enabled.
      *
-     * @param error
+     * @param error the error that caused this log
      */
     void info(Throwable error);
 
@@ -103,31 +103,31 @@ public interface Log {
     void info(Supplier<String> content, Throwable error);
 
     /**
-     * @return true if the <b>warn</b> error level is enabled
+     * {@return true if the <b>warn</b> error level is enabled}.
      */
     boolean isWarnEnabled();
 
     /**
-     * Send a message to the user in the <b>warn</b> error level.
+     * Sends a message to the user in the <b>warn</b> error level.
      *
-     * @param content
+     * @param content the message to log
      */
     void warn(CharSequence content);
 
     /**
-     * Send a message (and accompanying exception) to the user in the <b>warn</b> error level.<br>
+     * Sends a message (and accompanying exception) to the user in the <b>warn</b> error level.
      * The error's stacktrace will be output when this error level is enabled.
      *
-     * @param content
+     * @param content the message to log
-     * @param error
+     * @param error the error that caused this log
      */
     void warn(CharSequence content, Throwable error);
 
     /**
-     * Send an exception to the user in the <b>warn</b> error level.<br>
+     * Sends an exception to the user in the <b>warn</b> error level.
      * The stack trace for this exception will be output when this error level is enabled.
      *
-     * @param error
+     * @param error the error that caused this log
      */
     void warn(Throwable error);
 
@@ -136,31 +136,31 @@ public interface Log {
     void warn(Supplier<String> content, Throwable error);
 
     /**
-     * @return true if the <b>error</b> error level is enabled
+     * {@return true if the <b>error</b> error level is enabled}.
      */
     boolean isErrorEnabled();
 
     /**
-     * Send a message to the user in the <b>error</b> error level.
+     * Sends a message to the user in the <b>error</b> error level.
      *
-     * @param content
+     * @param content the message to log
      */
     void error(CharSequence content);
 
     /**
-     * Send a message (and accompanying exception) to the user in the <b>error</b> error level.<br>
+     * Sends a message (and accompanying exception) to the user in the <b>error</b> error level.
      * The error's stacktrace will be output when this error level is enabled.
      *
-     * @param content
+     * @param content the message to log
-     * @param error
+     * @param error the error that caused this log
      */
     void error(CharSequence content, Throwable error);
 
     /**
-     * Send an exception to the user in the <b>error</b> error level.<br>
+     * Sends an exception to the user in the <b>error</b> error level.
      * The stack trace for this exception will be output when this error level is enabled.
      *
-     * @param error
+     * @param error the error that caused this log
      */
     void error(Throwable error);
 

api/maven-api-core/src/main/java/org/apache/maven/api/plugin/Mojo.java

@@ -22,10 +22,9 @@ import org.apache.maven.api.annotations.Consumer;
 import org.apache.maven.api.annotations.Experimental;
 
 /**
- * This interface forms the contract required for <code>Mojos</code> to interact with the <code>Maven</code>
+ * This interface forms the contract required for Mojos to interact with the Maven infrastructure.
- * infrastructure.<br>
+ * It features an {@link #execute()} method, which triggers the Mojo's build-process behavior,
- * It features an <code>execute()</code> method, which triggers the Mojo's build-process behavior, and can throw
+ * and can throw a {@link MojoException} if error conditions occur.
- * a MojoException if error conditions occur.<br>
  *
  * @since 4.0.0
  */
@@ -34,9 +33,9 @@ import org.apache.maven.api.annotations.Experimental;
 @Consumer
 public interface Mojo {
     /**
-     * Perform whatever build-process behavior this <code>Mojo</code> implements.<br>
+     * Perform whatever build-process behavior this {@code Mojo} implements.
-     * This is the main trigger for the <code>Mojo</code> inside the <code>Maven</code> system, and allows
+     * This is the main trigger for the {@code Mojo} inside the Maven system,
-     * the <code>Mojo</code> to communicate errors.
+     * and allows the {@code Mojo} to communicate errors.
      *
      * @throws MojoException if a problem occurs
      */

api/maven-api-core/src/main/java/org/apache/maven/api/plugin/MojoException.java

@@ -34,8 +34,8 @@ public class MojoException extends MavenException {
     protected String longMessage;
 
     /**
-     * Construct a new <code>MojoException</code> exception providing the source and a short and long message:
+     * Constructs a new {@code MojoException} providing the source and a short and long message.
-     * these messages are used to improve the message written at the end of Maven build.
+     * These messages are used to improve the message written at the end of Maven build.
      */
     public MojoException(Object source, String shortMessage, String longMessage) {
         super(shortMessage);
@@ -44,22 +44,22 @@ public class MojoException extends MavenException {
     }
 
     /**
-     * Construct a new <code>MojoExecutionException</code> exception wrapping an underlying <code>Throwable</code>
+     * Constructs a new {@code MojoException} wrapping an underlying {@code Throwable}
-     * and providing a <code>message</code>.
+     * and providing a {@code message}.
      */
     public MojoException(String message, Throwable cause) {
         super(message, cause);
     }
 
     /**
-     * Construct a new <code>MojoExecutionException</code> exception providing a <code>message</code>.
+     * Constructs a new {@code MojoException} providing a {@code message}.
      */
     public MojoException(String message) {
         super(message);
     }
 
     /**
-     * Constructs a new {@code MojoExecutionException} exception wrapping an underlying {@code Throwable}.
+     * Constructs a new {@code MojoExecutionException} wrapping an underlying {@code Throwable}.
      *
      * @param cause the cause which is saved for later retrieval by the {@link #getCause()} method.
      *              A {@code null} value is permitted, and indicates that the cause is nonexistent or unknown.

api/maven-api-core/src/main/java/org/apache/maven/api/services/DependencyResolverResult.java

@@ -24,6 +24,7 @@ import java.util.Map;
 import java.util.Optional;
 
 import org.apache.maven.api.Dependency;
+import org.apache.maven.api.JavaPathType;
 import org.apache.maven.api.Node;
 import org.apache.maven.api.PathType;
 import org.apache.maven.api.annotations.Experimental;
@@ -43,6 +44,8 @@ public interface DependencyResolverResult extends DependencyCollectorResult {
     /**
      * Returns the file paths of all dependencies, regardless on which tool option those paths should be placed.
      * The returned list may contain a mix of Java class-path, Java module-path, and other types of path elements.
+     * This collection has the same content than {@code getDependencies.values()} except that it does not contain
+     * null elements.
      *
      * @return the paths of all dependencies
      */
@@ -55,36 +58,31 @@ public interface DependencyResolverResult extends DependencyCollectorResult {
      * In the case of Java tools, the map may also contain {@code --patch-module} options, which are
      * {@linkplain org.apache.maven.api.JavaPathType#patchModule(String) handled in a special way}.
      *
-     * <p><b>Design note:</b>
+     * <h4>Design note</h4>
      * All types of path are determined together because they are sometime mutually exclusive.
      * For example, an artifact of type {@value org.apache.maven.api.Type#JAR} can be placed
      * either on the class-path or on the module-path. The project needs to make a choice
      * (possibly using heuristic rules), then to add the dependency in only one of the options
-     * identified by {@link PathType}.</p>
+     * identified by {@link PathType}.
      *
      * @return file paths to place on the different tool options
      */
     @Nonnull
     Map<PathType, List<Path>> getDispatchedPaths();
 
+    /**
+     * {@return all dependencies associated to their paths}.
+     * Some dependencies may be associated to a null value if there is no path available.
+     */
     @Nonnull
     Map<Dependency, Path> getDependencies();
 
     /**
-     * Formats the command-line option for the path of the specified type.
+     * If the module-path contains at least one filename-based auto-module, prepares a warning message.
-     * The option are documented in {@link org.apache.maven.api.JavaPathType} enumeration values.
+     * The module path is the collection of dependencies associated to {@link JavaPathType#MODULES}.
+     * It is caller's responsibility to send the message to a logger.
      *
-     * @param type the desired type of path (class-path, module-path, …)
+     * @return warning message if at least one filename-based auto-module was found
-     * @return the option to pass to Java tools
      */
-    default Optional<String> formatOption(PathType type) {
+    Optional<String> warningForFilenameBasedAutomodules();
-        List<Path> paths = getDispatchedPaths().get(type);
-        if (paths != null) {
-            String option = type.option(paths);
-            if (!option.isEmpty()) {
-                return Optional.of(option);
-            }
-        }
-        return Optional.empty();
-    }
 }

maven-api-impl/src/main/java/org/apache/maven/internal/impl/DefaultDependencyResolverResult.java

@@ -26,6 +26,7 @@ import java.util.Collections;
 import java.util.LinkedHashMap;
 import java.util.List;
 import java.util.Map;
+import java.util.Optional;
 import java.util.Set;
 import java.util.function.Predicate;
 
@@ -33,6 +34,7 @@ import org.apache.maven.api.Dependency;
 import org.apache.maven.api.JavaPathType;
 import org.apache.maven.api.Node;
 import org.apache.maven.api.PathType;
+import org.apache.maven.api.services.DependencyResolverException;
 import org.apache.maven.api.services.DependencyResolverRequest;
 import org.apache.maven.api.services.DependencyResolverResult;
 
@@ -42,8 +44,8 @@ import org.apache.maven.api.services.DependencyResolverResult;
  * to the following methods, in that order:
  *
  * <ul>
- *   <li>{@link #addOutputDirectory(Path, Path, PathModularizationCache)} (optional)</li>
+ *   <li>{@link #addOutputDirectory(Path, Path)} (optional)</li>
- *   <li>{@link #addDependency(Node, Dependency, Predicate, Path, PathModularizationCache)}</li>
+ *   <li>{@link #addDependency(Node, Dependency, Predicate, Path)}</li>
  * </ul>
  *
  * @see DefaultDependencyResolver#resolve(DependencyResolverRequest)
@@ -85,15 +87,22 @@ class DefaultDependencyResolverResult implements DependencyResolverResult {
      */
     private PathModularization outputModules;
 
+    /**
+     * Cache of module information about each dependency.
+     */
+    private final PathModularizationCache cache;
+
     /**
      * Creates an initially empty result. Callers should add path elements by calls
      * to {@link #addDependency(Node, Dependency, Predicate, Path, PathModularizationCache)}.
      *
+     * @param cache cache of module information about each dependency
      * @param exceptions the exceptions that occurred while building the dependency graph
      * @param root the root node of the dependency graph
      * @param count estimated number of dependencies
      */
-    DefaultDependencyResolverResult(List<Exception> exceptions, Node root, int count) {
+    DefaultDependencyResolverResult(PathModularizationCache cache, List<Exception> exceptions, Node root, int count) {
+        this.cache = cache;
         this.exceptions = exceptions;
         this.root = root;
         nodes = new ArrayList<>(count);
@@ -137,18 +146,17 @@ class DefaultDependencyResolverResult implements DependencyResolverResult {
      *   </li>
      * </ul>
      *
-     * This method must be invoked before {@link #addDependency(Node, Dependency, Predicate, Path, PathModularizationCache)}
+     * This method must be invoked before {@link #addDependency(Node, Dependency, Predicate, Path)}
      * if output directories are desired on the class-path or module-path.
      * This method can be invoked at most once.
      *
      * @param main the main output directory, or {@code null} if none
      * @param test the test output directory, or {@code null} if none
-     * @param cache cache of module information about each dependency
      * @throws IOException if an error occurred while reading module information
      *
      * TODO: this is currently not called
      */
-    void addOutputDirectory(Path main, Path test, PathModularizationCache cache) throws IOException {
+    void addOutputDirectory(Path main, Path test) throws IOException {
         if (outputModules != null) {
             throw new IllegalStateException("Output directories must be set first and only once.");
         }
@@ -201,11 +209,9 @@ class DefaultDependencyResolverResult implements DependencyResolverResult {
      * @param dep the dependency for the given node, or {@code null} if none
      * @param filter filter the paths accepted by the tool which will consume the path.
      * @param path the path to the dependency, or {@code null} if the dependency was null
-     * @param cache cache of module information about each dependency
      * @throws IOException if an error occurred while reading module information
      */
-    void addDependency(Node node, Dependency dep, Predicate<PathType> filter, Path path, PathModularizationCache cache)
+    void addDependency(Node node, Dependency dep, Predicate<PathType> filter, Path path) throws IOException {
-            throws IOException {
         nodes.add(node);
         if (dep == null) {
             return;
@@ -235,7 +241,7 @@ class DefaultDependencyResolverResult implements DependencyResolverResult {
                     cache.getModuleInfo(path).getModuleNames().entrySet()) {
                 String moduleName = info.getValue();
                 type = JavaPathType.patchModule(moduleName);
-                if (!containsModule(moduleName, cache)) {
+                if (!containsModule(moduleName)) {
                     /*
                      * Not patching an existing module. This case should be unusual. If it nevertheless
                      * happens, add on class-path or module-path if allowed, or keep patching otherwise.
@@ -288,9 +294,8 @@ class DefaultDependencyResolverResult implements DependencyResolverResult {
      * Returns whether at least one previously added modular dependency contains a module of the given name.
      *
      * @param moduleName name of the module to search
-     * @param cache cache of module information about each dependency
      */
-    private boolean containsModule(String moduleName, PathModularizationCache cache) throws IOException {
+    private boolean containsModule(String moduleName) throws IOException {
         for (Path path : dispatchedPaths.getOrDefault(JavaPathType.MODULES, Collections.emptyList())) {
             if (cache.getModuleInfo(path).containsModule(moduleName)) {
                 return true;
@@ -345,4 +350,13 @@ class DefaultDependencyResolverResult implements DependencyResolverResult {
     public Map<Dependency, Path> getDependencies() {
         return dependencies;
     }
+
+    @Override
+    public Optional<String> warningForFilenameBasedAutomodules() {
+        try {
+            return cache.warningForFilenameBasedAutomodules(dispatchedPaths.get(JavaPathType.MODULES));
+        } catch (IOException e) {
+            throw new DependencyResolverException("Cannot read module information.", e);
+        }
+    }
 }

maven-api-impl/src/main/java/org/apache/maven/internal/impl/PathModularization.java

@@ -24,6 +24,7 @@ import java.io.UncheckedIOException;
 import java.lang.module.ModuleDescriptor;
 import java.nio.file.Files;
 import java.nio.file.Path;
+import java.util.Collection;
 import java.util.Collections;
 import java.util.HashMap;
 import java.util.Map;
@@ -58,6 +59,11 @@ class PathModularization {
      */
     private static final Attributes.Name AUTO_MODULE_NAME = new Attributes.Name("Automatic-Module-Name");
 
+    /**
+     * Filename of the path specified at construction time.
+     */
+    private final String filename;
+
     /**
      * Module information for the path specified at construction time.
      * This map is usually either empty if no module was found, or a singleton map.
@@ -88,6 +94,7 @@ class PathModularization {
      * @see #NONE
      */
     private PathModularization() {
+        filename = "(none)";
         descriptors = Collections.emptyMap();
         isModuleHierarchy = false;
     }
@@ -128,6 +135,7 @@ class PathModularization {
      * @throws IOException if an error occurred while reading the JAR file or the module descriptor
      */
     PathModularization(Path path, boolean resolve) throws IOException {
+        filename = path.getFileName().toString();
         if (Files.isDirectory(path)) {
             /*
              * Package hierarchy: only one module with descriptor at the root.
@@ -213,7 +221,7 @@ class PathModularization {
     }
 
     /**
-     * Returns the module name declared in the given {@code module-info} descriptor.
+     * {@return the module name declared in the given {@code module-info} descriptor}.
      * The input stream may be for a file or for an entry in a JAR file.
      */
     @Nonnull
@@ -222,7 +230,7 @@ class PathModularization {
     }
 
     /**
-     * Returns the type of path detected. The return value is {@link JavaPathType#MODULES}
+     * {@return the type of path detected}. The return value is {@link JavaPathType#MODULES}
      * if the dependency is a modular JAR file or a directory containing module descriptor(s),
      * or {@link JavaPathType#CLASSES} otherwise. A JAR file without module descriptor but with
      * an "Automatic-Module-Name" manifest attribute is considered modular.
@@ -232,7 +240,21 @@ class PathModularization {
     }
 
     /**
-     * Returns whether module hierarchy was detected. If false, then package hierarchy is assumed.
+     * If the module has no name, adds the filename of the JAR file in the given collection.
+     * This method should be invoked for dependencies placed on {@link JavaPathType#MODULES}
+     * for preparing a warning asking to not deploy the build artifact on a public repository.
+     * If the module has an explicit name either with a {@code module-info.class} file or with
+     * an {@code "Automatic-Module-Name"} attribute in the {@code META-INF/MANIFEST.MF} file,
+     * then this method does nothing.
+     */
+    public void addIfFilenameBasedAutomodules(Collection<String> automodulesDetected) {
+        if (descriptors.isEmpty()) {
+            automodulesDetected.add(filename);
+        }
+    }
+
+    /**
+     * {@return whether module hierarchy was detected}. If {@code false}, then package hierarchy is assumed.
      * In a package hierarchy, the {@linkplain #getModuleNames()} map of modules has either zero or one entry.
      * In a module hierarchy, the descriptors map may have an arbitrary number of entries,
      * including one (so the map size cannot be used as a criterion).
@@ -242,7 +264,7 @@ class PathModularization {
     }
 
     /**
-     * Returns the module names for the path specified at construction time.
+     * {@return the module names for the path specified at construction time}.
      * This map is usually either empty if no module was found, or a singleton map.
      * It may however contain more than one entry if module hierarchy was detected,
      * in which case there is one key per sub-directory.
@@ -257,9 +279,18 @@ class PathModularization {
     }
 
     /**
-     * Returns whether the dependency contains a module of the given name.
+     * {@return whether the dependency contains a module of the given name}.
      */
     public boolean containsModule(String name) {
         return descriptors.containsValue(name);
     }
+
+    /**
+     * {@return a string representation of this object for debugging purposes}.
+     * This string representation may change in any future version.
+     */
+    @Override
+    public String toString() {
+        return getClass().getCanonicalName() + '[' + filename + ']';
+    }
 }

maven-api-impl/src/main/java/org/apache/maven/internal/impl/PathModularizationCache.java

@@ -20,10 +20,13 @@ package org.apache.maven.internal.impl;
 
 import java.io.IOException;
 import java.nio.file.Path;
+import java.util.ArrayList;
+import java.util.Collection;
 import java.util.HashMap;
 import java.util.Map;
 import java.util.Optional;
 import java.util.Set;
+import java.util.StringJoiner;
 import java.util.function.Predicate;
 
 import org.apache.maven.api.JavaPathType;
@@ -108,12 +111,18 @@ class PathModularizationCache {
         boolean classes = false;
         boolean modules = false;
         boolean unknown = false;
+        boolean processorClasses = false;
+        boolean processorModules = false;
         for (PathType type : types) {
             if (filter.test(type)) {
                 if (JavaPathType.CLASSES.equals(type)) {
                     classes = true;
                 } else if (JavaPathType.MODULES.equals(type)) {
                     modules = true;
+                } else if (JavaPathType.PROCESSOR_CLASSES.equals(type)) {
+                    processorClasses = true;
+                } else if (JavaPathType.PROCESSOR_MODULES.equals(type)) {
+                    processorModules = true;
                 } else {
                     unknown = true;
                 }
@@ -126,9 +135,54 @@ class PathModularizationCache {
                 }
             }
         }
-        if (classes & modules) {
+        /*
+         * If the dependency can be both on the class-path and the module-path, we need to chose one of these.
+         * The choice done below will overwrite the current `selected` value because the latter is only the
+         * first value encountered in iteration order, which may be random.
+         */
+        if (classes | modules) {
+            if (classes & modules) {
+                selected = getPathType(path);
+            } else if (classes) {
+                selected = JavaPathType.CLASSES;
+            } else {
+                selected = JavaPathType.MODULES;
+            }
+        } else if (processorClasses & processorModules) {
             selected = getPathType(path);
+            if (JavaPathType.CLASSES.equals(selected)) {
+                selected = JavaPathType.PROCESSOR_CLASSES;
+            } else if (JavaPathType.MODULES.equals(selected)) {
+                selected = JavaPathType.PROCESSOR_MODULES;
+            }
         }
         return Optional.ofNullable(selected);
     }
+
+    /**
+     * If the module-path contains a filename-based auto-module, prepares a warning message.
+     * It is caller's responsibility to send the message to a logger.
+     *
+     * @param modulePaths content of the module path, or {@code null} if none
+     * @return warning message if at least one filename-based auto-module was found
+     * @throws IOException if an error occurred while reading module information
+     */
+    Optional<String> warningForFilenameBasedAutomodules(Collection<Path> modulePaths) throws IOException {
+        if (modulePaths == null) {
+            return Optional.empty();
+        }
+        var automodulesDetected = new ArrayList<String>();
+        for (Path p : modulePaths) {
+            getModuleInfo(p).addIfFilenameBasedAutomodules(automodulesDetected);
+        }
+        if (automodulesDetected.isEmpty()) {
+            return Optional.empty();
+        }
+        var joiner = new StringJoiner(
+                ", ",
+                "Filename-based automodules detected on the module-path: ",
+                "Please don't publish this project to a public artifact repository.");
+        automodulesDetected.forEach(joiner::add);
+        return Optional.of(joiner.toString());
+    }
 }

maven-core/src/main/java/org/apache/maven/internal/impl/DefaultDependencyResolver.java

@@ -91,12 +91,12 @@ public class DefaultDependencyResolver implements DependencyResolver {
                 .collect(Collectors.toList());
         Map<Artifact, Path> artifacts = session.resolveArtifacts(coordinates);
         DefaultDependencyResolverResult result = new DefaultDependencyResolverResult(
-                collectorResult.getExceptions(), collectorResult.getRoot(), nodes.size());
+                cache, collectorResult.getExceptions(), collectorResult.getRoot(), nodes.size());
         for (Node node : nodes) {
             Dependency d = node.getDependency();
             Path path = (d != null) ? artifacts.get(d) : null;
             try {
-                result.addDependency(node, d, filter, path, cache);
+                result.addDependency(node, d, filter, path);
             } catch (IOException e) {
                 throw cannotReadModuleInfo(path, e);
             }

maven-embedder/src/main/java/org/fusesource/jansi/Ansi.java

@@ -825,7 +825,7 @@ public class Ansi implements Appendable {
 
     public Ansi newline() {
         flushAttributes();
-        builder.append(System.getProperty("line.separator"));
+        builder.append(System.lineSeparator());
         return this;
     }
 

maven-model-builder/src/main/java/org/apache/maven/utils/Os.java

@@ -18,6 +18,7 @@
  */
 package org.apache.maven.utils;
 
+import java.io.File;
 import java.util.Locale;
 import java.util.stream.Stream;
 
@@ -124,11 +125,6 @@ public class Os {
      */
     private static final String DARWIN = "darwin";
 
-    /**
-     * The path separator.
-     */
-    private static final String PATH_SEP = System.getProperty("path.separator");
-
     static {
         // Those two public constants are initialized here, as they need all the private constants
         // above to be initialized first, but the code style imposes the public constants to be
@@ -187,13 +183,13 @@ public class Os {
             case FAMILY_NETWARE:
                 return actualOsName.contains(FAMILY_NETWARE);
             case FAMILY_DOS:
-                return PATH_SEP.equals(";") && !isFamily(FAMILY_NETWARE, actualOsName) && !isWindows;
+                return File.pathSeparatorChar == ';' && !isFamily(FAMILY_NETWARE, actualOsName) && !isWindows;
             case FAMILY_MAC:
                 return actualOsName.contains(FAMILY_MAC) || actualOsName.contains(DARWIN);
             case FAMILY_TANDEM:
                 return actualOsName.contains("nonstop_kernel");
             case FAMILY_UNIX:
-                return PATH_SEP.equals(":")
+                return File.pathSeparatorChar == ':'
                         && !isFamily(FAMILY_OPENVMS, actualOsName)
                         && (!isFamily(FAMILY_MAC, actualOsName) || actualOsName.endsWith("x"));
             case FAMILY_ZOS:

maven-resolver-provider/src/main/java/org/apache/maven/repository/internal/type/DefaultTypeProvider.java

@@ -58,6 +58,28 @@ public class DefaultTypeProvider implements TypeProvider {
                 new DefaultType(Type.MODULAR_JAR, Language.JAVA_FAMILY, "jar", null, false, JavaPathType.MODULES),
                 new DefaultType(Type.CLASSPATH_JAR, Language.JAVA_FAMILY, "jar", null, false, JavaPathType.CLASSES),
                 new DefaultType(Type.FATJAR, Language.JAVA_FAMILY, "jar", null, true, JavaPathType.CLASSES),
+                new DefaultType(
+                        Type.PROCESSOR,
+                        Language.JAVA_FAMILY,
+                        "jar",
+                        null,
+                        false,
+                        JavaPathType.PROCESSOR_CLASSES,
+                        JavaPathType.PROCESSOR_MODULES),
+                new DefaultType(
+                        Type.MODULAR_PROCESSOR,
+                        Language.JAVA_FAMILY,
+                        "jar",
+                        null,
+                        false,
+                        JavaPathType.PROCESSOR_MODULES),
+                new DefaultType(
+                        Type.CLASSPATH_PROCESSOR,
+                        Language.JAVA_FAMILY,
+                        "jar",
+                        null,
+                        false,
+                        JavaPathType.PROCESSOR_CLASSES),
                 // j2ee types
                 new DefaultType("ejb", Language.JAVA_FAMILY, "jar", null, false, JavaPathType.CLASSES),
                 new DefaultType("ejb-client", Language.JAVA_FAMILY, "jar", "client", false, JavaPathType.CLASSES),