org.sonatype.aether.util
Class FilterRepositorySystemSession

java.lang.Object
  org.sonatype.aether.util.FilterRepositorySystemSession

All Implemented Interfaces:

RepositorySystemSession

public class FilterRepositorySystemSession
extends java.lang.Object
implements RepositorySystemSession

A repository system session that wraps another session. This class exists merely for the purpose of sub classing where a sub class would intercept one or more methods and present alternative settings to the caller.

Author:

Benjamin Bentmann

Field Summary

protected RepositorySystemSession

session

Constructor Summary

protected

FilterRepositorySystemSession(RepositorySystemSession session) Creates a new repository system session that wraps the specified session.

Method Summary

ArtifactTypeRegistry	getArtifactTypeRegistry() Gets the registry of artifact types recognized by this session.
AuthenticationSelector	getAuthenticationSelector() Gets the authentication selector to use for repositories discovered in artifact descriptors.
RepositoryCache	getCache() Gets the cache the repository system may use to save data for future reuse during the session.
java.lang.String	getChecksumPolicy() Gets the global checksum policy.
java.util.Map<java.lang.String,java.lang.Object>	getConfigProperties() The configuration properties used to tweak internal aspects of the repository system (e.g.
SessionData	getData() Gets the custom data associated with this session.
DependencyGraphTransformer	getDependencyGraphTransformer() Gets the dependency graph transformer to use for building dependency graphs.
DependencyManager	getDependencyManager() Gets the dependency manager to use for building dependency graphs.
DependencySelector	getDependencySelector() Gets the dependency selector to use for building dependency graphs.
DependencyTraverser	getDependencyTraverser() Gets the dependency traverser to use for building dependency graphs.
LocalRepository	getLocalRepository() Gets the local repository used during this session.
LocalRepositoryManager	getLocalRepositoryManager() Gets the local repository manager used during this session.
MirrorSelector	getMirrorSelector() Gets the mirror selector to use for repositories discovered in artifact descriptors.
ProxySelector	getProxySelector() Gets the proxy selector to use for repositories discovered in artifact descriptors.
RepositoryListener	getRepositoryListener() Gets the listener being notified of actions in the repository system.
java.util.Map<java.lang.String,java.lang.String>	getSystemProperties() Gets the system properties to use, e.g.
TransferListener	getTransferListener() Gets the listener being notified of uploads/downloads by the repository system.
java.lang.String	getUpdatePolicy() Gets the global update policy.
java.util.Map<java.lang.String,java.lang.String>	getUserProperties() Gets the user properties to use, e.g.
WorkspaceReader	getWorkspaceReader() Gets the workspace reader used during this session.
boolean	isIgnoreInvalidArtifactDescriptor() Indicates whether invalid artifact descriptors are silently ignored.
boolean	isIgnoreMissingArtifactDescriptor() Indicates whether missing artifact descriptors are silently ignored.
boolean	isNotFoundCachingEnabled() Indicates whether missing artifacts/metadata from resolution attempts should be cached in the local repository.
boolean	isOffline() Indicates whether the repository system operates in offline mode and avoids/refuses any access to remote repositories.
boolean	isTransferErrorCachingEnabled() Indicates whether transfer errors (e.g.

Methods inherited from class java.lang.Object

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

Field Detail

session

protected RepositorySystemSession session

Constructor Detail

FilterRepositorySystemSession

protected FilterRepositorySystemSession(RepositorySystemSession session)

Creates a new repository system session that wraps the specified session.

Parameters:

session - The repository system session to wrap, must not be null.

Method Detail

getArtifactTypeRegistry

public ArtifactTypeRegistry getArtifactTypeRegistry()

Description copied from interface: RepositorySystemSession

Gets the registry of artifact types recognized by this session.

Specified by:

getArtifactTypeRegistry in interface RepositorySystemSession

Returns:

The artifact type registry, never null.

getAuthenticationSelector

public AuthenticationSelector getAuthenticationSelector()

Description copied from interface: RepositorySystemSession

Gets the authentication selector to use for repositories discovered in artifact descriptors. Note that this selector is not used for remote repositories which are passed as request parameters to the repository system, those repositories are supposed to have their authentication (if any) already set.

Specified by:

getAuthenticationSelector in interface RepositorySystemSession

Returns:

The authentication selector to use, never null.

See Also:

RemoteRepository.getAuthentication()

getCache

public RepositoryCache getCache()

Description copied from interface: RepositorySystemSession

Gets the cache the repository system may use to save data for future reuse during the session.

Specified by:

getCache in interface RepositorySystemSession

Returns:

The repository cache or null if none.

getChecksumPolicy

public java.lang.String getChecksumPolicy()

Description copied from interface: RepositorySystemSession

Gets the global checksum policy. If set, the global checksum policy overrides the checksum policies of the remote repositories being used for resolution.

Specified by:

getChecksumPolicy in interface RepositorySystemSession

Returns:

The global checksum policy or null/empty if not set and the per-repository policies apply.

See Also:

RepositoryPolicy

getConfigProperties

public java.util.Map<java.lang.String,java.lang.Object> getConfigProperties()

Description copied from interface: RepositorySystemSession

The configuration properties used to tweak internal aspects of the repository system (e.g. thread pooling, connector-specific behavior, etc.)

Specified by:

getConfigProperties in interface RepositorySystemSession

Returns:

The (read-only) configuration properties, never null.

See Also:

ConfigurationProperties

getDependencyGraphTransformer

public DependencyGraphTransformer getDependencyGraphTransformer()

Description copied from interface: RepositorySystemSession

Gets the dependency graph transformer to use for building dependency graphs.

Specified by:

getDependencyGraphTransformer in interface RepositorySystemSession

Returns:

The dependency graph transformer to use for building dependency graphs, never null.

getDependencyManager

public DependencyManager getDependencyManager()

Description copied from interface: RepositorySystemSession

Gets the dependency manager to use for building dependency graphs.

Specified by:

getDependencyManager in interface RepositorySystemSession

Returns:

The dependency manager to use for building dependency graphs, never null.

getDependencySelector

public DependencySelector getDependencySelector()

Description copied from interface: RepositorySystemSession

Gets the dependency selector to use for building dependency graphs.

Specified by:

getDependencySelector in interface RepositorySystemSession

Returns:

The dependency selector to use for building dependency graphs, never null.

getDependencyTraverser

public DependencyTraverser getDependencyTraverser()

Description copied from interface: RepositorySystemSession

Gets the dependency traverser to use for building dependency graphs.

Specified by:

getDependencyTraverser in interface RepositorySystemSession

Returns:

The dependency traverser to use for building dependency graphs, never null.

getLocalRepository

public LocalRepository getLocalRepository()

Description copied from interface: RepositorySystemSession

Gets the local repository used during this session. This is a convenience method for LocalRepositoryManager.getRepository().

Specified by:

getLocalRepository in interface RepositorySystemSession

Returns:

The local repository being during this session, never null.

getLocalRepositoryManager

public LocalRepositoryManager getLocalRepositoryManager()

Description copied from interface: RepositorySystemSession

Gets the local repository manager used during this session.

Specified by:

getLocalRepositoryManager in interface RepositorySystemSession

Returns:

The local repository manager used during this session, never null.

getMirrorSelector

public MirrorSelector getMirrorSelector()

Description copied from interface: RepositorySystemSession

Gets the mirror selector to use for repositories discovered in artifact descriptors. Note that this selector is not used for remote repositories which are passed as request parameters to the repository system, those repositories are supposed to denote the effective repositories.

Specified by:

getMirrorSelector in interface RepositorySystemSession

Returns:

The mirror selector to use, never null.

getProxySelector

public ProxySelector getProxySelector()

Description copied from interface: RepositorySystemSession

Gets the proxy selector to use for repositories discovered in artifact descriptors. Note that this selector is not used for remote repositories which are passed as request parameters to the repository system, those repositories are supposed to have their proxy (if any) already set.

Specified by:

getProxySelector in interface RepositorySystemSession

Returns:

The proxy selector to use, never null.

See Also:

RemoteRepository.getProxy()

getRepositoryListener

public RepositoryListener getRepositoryListener()

Description copied from interface: RepositorySystemSession

Gets the listener being notified of actions in the repository system.

Specified by:

getRepositoryListener in interface RepositorySystemSession

Returns:

The repository listener or null if none.

getSystemProperties

public java.util.Map<java.lang.String,java.lang.String> getSystemProperties()

Description copied from interface: RepositorySystemSession

Gets the system properties to use, e.g. for processing of artifact descriptors. System properties are usually collected from the runtime environment like System.getProperties() and environment variables.

Specified by:

getSystemProperties in interface RepositorySystemSession

Returns:

The (read-only) system properties, never null.

getTransferListener

public TransferListener getTransferListener()

Description copied from interface: RepositorySystemSession

Gets the listener being notified of uploads/downloads by the repository system.

Specified by:

getTransferListener in interface RepositorySystemSession

Returns:

The transfer listener or null if none.

getUpdatePolicy

public java.lang.String getUpdatePolicy()

Description copied from interface: RepositorySystemSession

Gets the global update policy. If set, the global update policy overrides the update policies of the remote repositories being used for resolution.

Specified by:

getUpdatePolicy in interface RepositorySystemSession

Returns:

The global update policy or null/empty if not set and the per-repository policies apply.

See Also:

RepositoryPolicy

getUserProperties

public java.util.Map<java.lang.String,java.lang.String> getUserProperties()

Description copied from interface: RepositorySystemSession

Gets the user properties to use, e.g. for processing of artifact descriptors. User properties are similar to system properties but are set on the discretion of the user and hence are considered of higher priority than system properties.

Specified by:

getUserProperties in interface RepositorySystemSession

Returns:

The (read-only) user properties, never null.

getWorkspaceReader

public WorkspaceReader getWorkspaceReader()

Description copied from interface: RepositorySystemSession

Gets the workspace reader used during this session. If set, the workspace reader will usually be consulted first to resolve artifacts.

Specified by:

getWorkspaceReader in interface RepositorySystemSession

Returns:

The workspace reader for this session or null if none.

isIgnoreInvalidArtifactDescriptor

public boolean isIgnoreInvalidArtifactDescriptor()

Description copied from interface: RepositorySystemSession

Indicates whether invalid artifact descriptors are silently ignored. If enabled and an artifact descriptor is invalid, an empty stub descriptor is used instead.

Specified by:

isIgnoreInvalidArtifactDescriptor in interface RepositorySystemSession

Returns:

true if invalid artifact descriptors are ignored, false to fail the operation with an exception.

isIgnoreMissingArtifactDescriptor

public boolean isIgnoreMissingArtifactDescriptor()

Description copied from interface: RepositorySystemSession

Indicates whether missing artifact descriptors are silently ignored. If enabled and no artifact descriptor is available, an empty stub descriptor is used instead.

Specified by:

isIgnoreMissingArtifactDescriptor in interface RepositorySystemSession

Returns:

true if missing artifact descriptors are ignored, false to fail the operation with an exception.

isNotFoundCachingEnabled

public boolean isNotFoundCachingEnabled()

Description copied from interface: RepositorySystemSession

Indicates whether missing artifacts/metadata from resolution attempts should be cached in the local repository. If caching is enabled, resolution will not be reattempted until the update policy for the affected resource has expired.

Specified by:

isNotFoundCachingEnabled in interface RepositorySystemSession

Returns:

true if missing resources are cached, false to always reattempt downloading.

isOffline

public boolean isOffline()

Description copied from interface: RepositorySystemSession

Indicates whether the repository system operates in offline mode and avoids/refuses any access to remote repositories.

Specified by:

isOffline in interface RepositorySystemSession

Returns:

true if the repository system is in offline mode, false otherwise.

isTransferErrorCachingEnabled

public boolean isTransferErrorCachingEnabled()

Description copied from interface: RepositorySystemSession

Indicates whether transfer errors (e.g. unreachable host, bad authentication) from resolution attempts should be cached in the local repository. If caching is enabled, resolution will not be reattempted until the update policy for the affected resource has expired.

Specified by:

isTransferErrorCachingEnabled in interface RepositorySystemSession

Returns:

true if transfer errors are cached, false to always reattempt downloading.

getData

public SessionData getData()

Description copied from interface: RepositorySystemSession

Gets the custom data associated with this session.

Specified by:

getData in interface RepositorySystemSession

Returns:

The session data, never null.