Package org.eclipse.aether.util.graph.transformer

Class ConfigurableVersionSelector

java.lang.Object

org.eclipse.aether.util.graph.transformer.ConflictResolver.VersionSelector

org.eclipse.aether.util.graph.transformer.ConfigurableVersionSelector

public class ConfigurableVersionSelector
extends ConflictResolver.VersionSelector

A configurable version selector for use with ConflictResolver that resolves version conflicts using a specified strategy. If there is no single node that satisfies all encountered version ranges, the selector will fail. Based on configuration, this selector may fail for other reasons as well.

Since:

2.0.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	ConfigurableVersionSelector.ConflictGroup
static class	ConfigurableVersionSelector.Highest	Selection strategy that selects "highest" version.
static class	ConfigurableVersionSelector.MajorVersionConvergence	Example selection strategy (used in tests and demos), is not recommended to be used in production.
static class	ConfigurableVersionSelector.Nearest	Selection strategy that selects "nearest" (to the root) version.
static interface	ConfigurableVersionSelector.SelectionStrategy	The strategy how "winner" is being selected.
static class	ConfigurableVersionSelector.VersionConvergence	Example selection strategy (used in tests and demos), is not recommended to be used in production.

Field Summary

Fields

Modifier and Type	Field	Description
protected final ConfigurableVersionSelector.SelectionStrategy	selectionStrategy	The strategy of winner selection, never null.

Constructor Summary

Constructors

Constructor	Description
ConfigurableVersionSelector()	Creates a new instance of this version selector that works "as Maven did so far".
ConfigurableVersionSelector(ConfigurableVersionSelector.SelectionStrategy selectionStrategy)	Creates a new instance of this version selector.

Method Summary

Modifier and Type	Method	Description
protected void	backtrack(ConfigurableVersionSelector.ConflictGroup group, ConflictResolver.ConflictContext context)
protected boolean	isAcceptableByConstraints(ConfigurableVersionSelector.ConflictGroup group, org.eclipse.aether.version.Version version)
static org.eclipse.aether.collection.UnsolvableVersionConflictException	newFailure(String message, ConflictResolver.ConflictContext context)	Helper method to create failure, creates instance of UnsolvableVersionConflictException.
void	selectVersion(ConflictResolver.ConflictContext context)	Determines the winning node among conflicting dependencies.

Methods inherited from class org.eclipse.aether.util.graph.transformer.ConflictResolver.VersionSelector

getInstance

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

selectionStrategy

protected final ConfigurableVersionSelector.SelectionStrategy selectionStrategy

The strategy of winner selection, never null.

Constructor Details

ConfigurableVersionSelector

public ConfigurableVersionSelector()

Creates a new instance of this version selector that works "as Maven did so far".

ConfigurableVersionSelector

public ConfigurableVersionSelector(ConfigurableVersionSelector.SelectionStrategy selectionStrategy)

Creates a new instance of this version selector.

Parameters:

selectionStrategy - The winner selection strategy, must not be null. Maven3 used ConfigurableVersionSelector.Nearest strategy.

Method Details

selectVersion

public void selectVersion(ConflictResolver.ConflictContext context)
                   throws org.eclipse.aether.RepositoryException

Description copied from class: ConflictResolver.VersionSelector

Determines the winning node among conflicting dependencies. Implementations will usually iterate ConflictResolver.ConflictContext.getItems(), inspect ConflictResolver.ConflictItem.getNode() and eventually call ConflictResolver.ConflictContext.setWinner(ConflictResolver.ConflictItem) to deliver the winner. Failure to select a winner will automatically fail the entire conflict resolution.

Specified by:

selectVersion in class ConflictResolver.VersionSelector

Parameters:

context - The conflict context, must not be null.

Throws:

org.eclipse.aether.RepositoryException - If the version selection failed.

backtrack

protected void backtrack(ConfigurableVersionSelector.ConflictGroup group,
 ConflictResolver.ConflictContext context)
                  throws org.eclipse.aether.collection.UnsolvableVersionConflictException

Throws:

org.eclipse.aether.collection.UnsolvableVersionConflictException

isAcceptableByConstraints

protected boolean isAcceptableByConstraints(ConfigurableVersionSelector.ConflictGroup group,
 org.eclipse.aether.version.Version version)

newFailure

public static org.eclipse.aether.collection.UnsolvableVersionConflictException newFailure(String message,
 ConflictResolver.ConflictContext context)

Helper method to create failure, creates instance of UnsolvableVersionConflictException.