Package org.apache.maven.api.services

Interface VersionRangeResolver

All Superinterfaces:

Service

All Known Implementing Classes:

DefaultVersionRangeResolver

@Experimental
@Consumer
public interface VersionRangeResolver
extends Service

Parses and evaluates version ranges encountered in dependency declarations.

Since:

4.0.0

Method Summary

Modifier and Type	Method	Description
VersionRangeResolverResult	resolve(VersionRangeResolverRequest request)
default VersionRangeResolverResult	resolve(Session session, ArtifactCoordinates artifactCoordinates)	Expands a version range to a list of matching versions, in ascending order.
default VersionRangeResolverResult	resolve(Session session, ArtifactCoordinates artifactCoordinates, List<RemoteRepository> repositories)	Expands a version range to a list of matching versions, in ascending order.

Method Details

resolve

@Nonnull
default VersionRangeResolverResult resolve(@Nonnull
 Session session,
 @Nonnull
 ArtifactCoordinates artifactCoordinates)
                                    throws VersionResolverException

Expands a version range to a list of matching versions, in ascending order. For example, resolves "[3.8,4.0)" to "3.8", "3.8.1", "3.8.2". The returned list of versions is only dependent on the configured repositories and their contents. The supplied request may also refer to a single concrete version rather than a version range. In this case though, the result contains simply the (parsed) input version, regardless of the repositories and their contents.

Parameters:

session - the session to use

artifactCoordinates - t

Returns:

the version range resolution result

Throws:

VersionResolverException - if an errors occurs

resolve

@Nonnull
default VersionRangeResolverResult resolve(@Nonnull
 Session session,
 @Nonnull
 ArtifactCoordinates artifactCoordinates,
 @Nullable
 List<RemoteRepository> repositories)
                                    throws VersionResolverException

Expands a version range to a list of matching versions, in ascending order. For example, resolves "[3.8,4.0)" to "3.8", "3.8.1", "3.8.2". The returned list of versions is only dependent on the configured repositories and their contents. The supplied request may also refer to a single concrete version rather than a version range. In this case though, the result contains simply the (parsed) input version, regardless of the repositories and their contents.

Parameters:

session - the session to use

artifactCoordinates - t

repositories - the repositories to use (if null, the session repositories are used)

Returns:

the version range resolution result

Throws:

VersionResolverException - if an errors occurs

resolve

@Nonnull
VersionRangeResolverResult resolve(@Nonnull
 VersionRangeResolverRequest request)
                            throws VersionRangeResolverException

Throws:

VersionRangeResolverException