Package org.eclipse.aether.internal.impl.collect

Class DependencyCollectorDelegate

java.lang.Object

org.eclipse.aether.internal.impl.collect.DependencyCollectorDelegate

All Implemented Interfaces:

DependencyCollector

Direct Known Subclasses:

BfDependencyCollector, DfDependencyCollector

public abstract class DependencyCollectorDelegate
extends Object
implements DependencyCollector

Helper class for delegate implementations, they MUST subclass this class.

Since:

1.8.0

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	DependencyCollectorDelegate.Results	Helper class used during collection.

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CONFIG_PROP_MAX_CYCLES	Only up to the given amount cyclic dependencies are emitted.
static final String	CONFIG_PROP_MAX_EXCEPTIONS	Only exceptions up to the number given in this configuration property are emitted.
static final int	DEFAULT_MAX_CYCLES
static final int	DEFAULT_MAX_EXCEPTIONS
protected final ArtifactDescriptorReader	descriptorReader
protected final org.slf4j.Logger	logger
protected final RemoteRepositoryManager	remoteRepositoryManager
protected final VersionRangeResolver	versionRangeResolver

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	DependencyCollectorDelegate(RemoteRepositoryManager remoteRepositoryManager, ArtifactDescriptorReader artifactDescriptorReader, VersionRangeResolver versionRangeResolver)

Method Summary

Modifier and Type	Method	Description
protected VersionRangeResult	cachedResolveRangeResult(VersionRangeRequest rangeRequest, DataPool pool, RepositorySystemSession session)
final CollectResult	collectDependencies(RepositorySystemSession session, CollectRequest request)	Collects the transitive dependencies of some artifacts and builds a dependency graph.
protected RequestTrace	collectStepTrace(RequestTrace trace, String context, List<DependencyNode> path, Dependency node)	Creates child RequestTrace instance from passed in RequestTrace and parameters by creating CollectStepDataImpl instance out of passed in data.
protected static ArtifactDescriptorRequest	createArtifactDescriptorRequest(String requestContext, RequestTrace requestTrace, List<RemoteRepository> repositories, Dependency d)
protected static DefaultDependencyNode	createDependencyNode(List<Artifact> relocations, PremanagedDependency preManaged, VersionRangeResult rangeResult, Version version, Dependency d, Collection<Artifact> aliases, List<RemoteRepository> repos, String requestContext)
protected static DefaultDependencyNode	createDependencyNode(List<Artifact> relocations, PremanagedDependency preManaged, VersionRangeResult rangeResult, Version version, Dependency d, ArtifactDescriptorResult descriptorResult, DependencyNode cycleNode)
protected static VersionRangeRequest	createVersionRangeRequest(String requestContext, RequestTrace requestTrace, List<RemoteRepository> repositories, Dependency dependency)
protected abstract void	doCollectDependencies(RepositorySystemSession session, RequestTrace trace, DataPool pool, DefaultDependencyCollectionContext context, DefaultVersionFilterContext versionContext, CollectRequest request, DependencyNode node, List<RemoteRepository> repositories, List<Dependency> dependencies, List<Dependency> managedDependencies, DependencyCollectorDelegate.Results results)
protected static List<? extends Version>	filterVersions(Dependency dependency, VersionRangeResult rangeResult, VersionFilter verFilter, DefaultVersionFilterContext verContext)
protected static String	getId(Artifact a)
protected static List<RemoteRepository>	getRemoteRepositories(ArtifactRepository repository, List<RemoteRepository> repositories)
protected static boolean	isLackingDescriptor(Artifact artifact)
protected List<Dependency>	mergeDeps(List<Dependency> dominant, List<Dependency> recessive)
protected RepositorySystemSession	optimizeSession(RepositorySystemSession session)

Methods inherited from class java.lang.Object

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

Field Details

CONFIG_PROP_MAX_EXCEPTIONS

public static final String CONFIG_PROP_MAX_EXCEPTIONS

Only exceptions up to the number given in this configuration property are emitted. Exceptions which exceed that number are swallowed.

See Also:

• Constant Field Values

Sourced from:

RepositorySystemSession.getConfigProperties()

Value type:

Integer

Default value:

DEFAULT_MAX_EXCEPTIONS

DEFAULT_MAX_EXCEPTIONS

public static final int DEFAULT_MAX_EXCEPTIONS

See Also:

• Constant Field Values

CONFIG_PROP_MAX_CYCLES

public static final String CONFIG_PROP_MAX_CYCLES

Only up to the given amount cyclic dependencies are emitted.

See Also:

• Constant Field Values

Sourced from:

RepositorySystemSession.getConfigProperties()

Value type:

Integer

Default value:

DEFAULT_MAX_CYCLES

DEFAULT_MAX_CYCLES

public static final int DEFAULT_MAX_CYCLES

See Also:

• Constant Field Values

logger

protected final org.slf4j.Logger logger

remoteRepositoryManager

protected final RemoteRepositoryManager remoteRepositoryManager

descriptorReader

protected final ArtifactDescriptorReader descriptorReader

versionRangeResolver

protected final VersionRangeResolver versionRangeResolver

Constructor Details

DependencyCollectorDelegate

protected DependencyCollectorDelegate(RemoteRepositoryManager remoteRepositoryManager,
 ArtifactDescriptorReader artifactDescriptorReader,
 VersionRangeResolver versionRangeResolver)

Method Details

collectDependencies

public final CollectResult collectDependencies(RepositorySystemSession session,
 CollectRequest request)
                                        throws DependencyCollectionException

Description copied from interface: DependencyCollector

Collects the transitive dependencies of some artifacts and builds a dependency graph. Note that this operation is only concerned about determining the coordinates of the transitive dependencies and does not actually resolve the artifact files. The supplied session carries various hooks to customize the dependency graph that must be invoked throughout the operation.

Specified by:

collectDependencies in interface DependencyCollector

Parameters:

session - The repository session, must not be null.

request - The collection request, must not be null.

Returns:

The collection result, never null.

Throws:

DependencyCollectionException - If the dependency tree could not be built.

See Also:

• RepositorySystemSession.getDependencyTraverser()
• RepositorySystemSession.getDependencyManager()
• RepositorySystemSession.getDependencySelector()
• RepositorySystemSession.getVersionFilter()
• RepositorySystemSession.getDependencyGraphTransformer()
• RepositorySystem.collectDependencies(RepositorySystemSession, CollectRequest)

collectStepTrace

protected RequestTrace collectStepTrace(RequestTrace trace,
 String context,
 List<DependencyNode> path,
 Dependency node)

Creates child RequestTrace instance from passed in RequestTrace and parameters by creating CollectStepDataImpl instance out of passed in data. Caller must ensure that passed in parameters are NOT affected by threading (or that there is no multi threading involved). In other words, the passed in values should be immutable.

Parameters:

trace - The current trace instance.

context - The context from CollectRequest.getRequestContext(), never null.

path - List representing the path of dependency nodes, never null. Caller must ensure, that this list does not change during the lifetime of the requested RequestTrace instance. If it may change, simplest is to pass here a copy of used list.

node - Currently collected node, that collector came by following the passed in path.

Returns:

A child request trance instance, never null.

doCollectDependencies

protected abstract void doCollectDependencies(RepositorySystemSession session,
 RequestTrace trace,
 DataPool pool,
 DefaultDependencyCollectionContext context,
 DefaultVersionFilterContext versionContext,
 CollectRequest request,
 DependencyNode node,
 List<RemoteRepository> repositories,
 List<Dependency> dependencies,
 List<Dependency> managedDependencies,
 DependencyCollectorDelegate.Results results)
                                       throws DependencyCollectionException

Throws:

DependencyCollectionException

optimizeSession

protected RepositorySystemSession optimizeSession(RepositorySystemSession session)

mergeDeps

protected List<Dependency> mergeDeps(List<Dependency> dominant,
 List<Dependency> recessive)

getId

protected static String getId(Artifact a)

createDependencyNode

protected static DefaultDependencyNode createDependencyNode(List<Artifact> relocations,
 PremanagedDependency preManaged,
 VersionRangeResult rangeResult,
 Version version,
 Dependency d,
 Collection<Artifact> aliases,
 List<RemoteRepository> repos,
 String requestContext)

createDependencyNode

protected static DefaultDependencyNode createDependencyNode(List<Artifact> relocations,
 PremanagedDependency preManaged,
 VersionRangeResult rangeResult,
 Version version,
 Dependency d,
 ArtifactDescriptorResult descriptorResult,
 DependencyNode cycleNode)

createArtifactDescriptorRequest

protected static ArtifactDescriptorRequest createArtifactDescriptorRequest(String requestContext,
 RequestTrace requestTrace,
 List<RemoteRepository> repositories,
 Dependency d)

createVersionRangeRequest

protected static VersionRangeRequest createVersionRangeRequest(String requestContext,
 RequestTrace requestTrace,
 List<RemoteRepository> repositories,
 Dependency dependency)

cachedResolveRangeResult

protected VersionRangeResult cachedResolveRangeResult(VersionRangeRequest rangeRequest,
 DataPool pool,
 RepositorySystemSession session)
                                               throws VersionRangeResolutionException

Throws:

VersionRangeResolutionException

isLackingDescriptor

protected static boolean isLackingDescriptor(Artifact artifact)

getRemoteRepositories

protected static List<RemoteRepository> getRemoteRepositories(ArtifactRepository repository,
 List<RemoteRepository> repositories)

filterVersions

protected static List<? extends Version> filterVersions(Dependency dependency,
 VersionRangeResult rangeResult,
 VersionFilter verFilter,
 DefaultVersionFilterContext verContext)
                                                 throws VersionRangeResolutionException

Throws:

VersionRangeResolutionException