Ability to augment metadata nature for version range request (#1518)

The idea is to let caller be able to augment the nature of metadata to resolve version range from.

Resolver already handles this, and is more elegant, than to have caller fiddle with
filtering the remote repositories or alike. Also, this way client code (ie. Maven)
can expose more fine grained configuration for this.

Author: cstamas

maven-resolver-api/src/main/java/org/eclipse/aether/resolution/VersionRangeRequest.java

@@ -24,6 +24,7 @@
 
 import org.eclipse.aether.RequestTrace;
 import org.eclipse.aether.artifact.Artifact;
+import org.eclipse.aether.metadata.Metadata;
 import org.eclipse.aether.repository.RemoteRepository;
 
 /**
@@ -38,6 +39,8 @@ public final class VersionRangeRequest {
 
     private List<RemoteRepository> repositories = Collections.emptyList();
 
+    private Metadata.Nature nature = Metadata.Nature.RELEASE_OR_SNAPSHOT;
+
     private String context = "";
 
     private RequestTrace trace;
@@ -62,6 +65,22 @@ public VersionRangeRequest(Artifact artifact, List<RemoteRepository> repositorie
         setRequestContext(context);
     }
 
+    /**
+     * Creates a request with the specified properties.
+     *
+     * @param artifact The artifact whose version range should be resolved, may be {@code null}.
+     * @param repositories The repositories to resolve the version from, may be {@code null}.
+     * @param nature The nature of metadata to use for resolving the version from, may be {@code null}.
+     * @param context The context in which this request is made, may be {@code null}.
+     */
+    public VersionRangeRequest(
+            Artifact artifact, List<RemoteRepository> repositories, Metadata.Nature nature, String context) {
+        setArtifact(artifact);
+        setRepositories(repositories);
+        setNature(nature);
+        setRequestContext(context);
+    }
+
     /**
      * Gets the artifact whose version range shall be resolved.
      *
@@ -122,6 +141,32 @@ public VersionRangeRequest addRepository(RemoteRepository repository) {
         return this;
     }
 
+    /**
+     * The nature of metadata to use for resolving the version from, never {@code null}.
+     *
+     * @return The nature, never {@code null}.
+     * @since 1.9.25
+     */
+    public Metadata.Nature getNature() {
+        return nature;
+    }
+
+    /**
+     * Sets the nature of metadata to use for resolving the version from
+     *
+     * @param nature The nature, may be {@code null}.
+     * @return This request for chaining, never {@code null}.
+     * @since 1.9.25
+     */
+    public VersionRangeRequest setNature(Metadata.Nature nature) {
+        if (nature == null) {
+            this.nature = Metadata.Nature.RELEASE_OR_SNAPSHOT;
+        } else {
+            this.nature = nature;
+        }
+        return this;
+    }
+
     /**
      * Gets the context in which this request is made.
      *