Package org.eclipse.aether.internal.impl.session

Class DefaultCloseableSession

java.lang.Object

org.eclipse.aether.internal.impl.session.DefaultCloseableSession

All Implemented Interfaces:

Closeable, AutoCloseable, RepositorySystemSession, RepositorySystemSession.CloseableSession

public final class DefaultCloseableSession
extends Object
implements RepositorySystemSession.CloseableSession

A default implementation of repository system session that is immutable and thread-safe.

Nested Class Summary

Nested classes/interfaces inherited from interface org.eclipse.aether.RepositorySystemSession

RepositorySystemSession.CloseableSession, RepositorySystemSession.SessionBuilder

Constructor Summary

Constructors

Constructor

Description

DefaultCloseableSession(String sessionId, AtomicBoolean closed, boolean offline, boolean ignoreArtifactDescriptorRepositories, ResolutionErrorPolicy resolutionErrorPolicy, ArtifactDescriptorPolicy artifactDescriptorPolicy, String checksumPolicy, String artifactUpdatePolicy, String metadataUpdatePolicy, LocalRepositoryManager localRepositoryManager, List<LocalRepository> localRepositories, WorkspaceReader workspaceReader, RepositoryListener repositoryListener, TransferListener transferListener, Map<String,String> systemProperties, Map<String,String> userProperties, Map<String,Object> configProperties, MirrorSelector mirrorSelector, ProxySelector proxySelector, AuthenticationSelector authenticationSelector, ArtifactTypeRegistry artifactTypeRegistry, DependencyTraverser dependencyTraverser, DependencyManager dependencyManager, DependencySelector dependencySelector, VersionFilter versionFilter, DependencyGraphTransformer dependencyGraphTransformer, SessionData data, RepositoryCache cache, RepositorySystem repositorySystem, RepositorySystemLifecycle repositorySystemLifecycle)

Method Summary

Modifier and Type	Method	Description
boolean	addOnSessionEndedHandler(Runnable handler)	Registers a handler to execute when this session closed.
void	close()	Closes the session.
RepositorySystemSession.SessionBuilder	copy()	Copies this session into a pre-populated builder, effectively making a mutable copy of itself, builder builds same session.
ArtifactDescriptorPolicy	getArtifactDescriptorPolicy()	Gets the policy which controls how errors related to reading artifact descriptors should be handled.
ArtifactTypeRegistry	getArtifactTypeRegistry()	Gets the registry of artifact types recognized by this session, for instance when processing artifact descriptors.
String	getArtifactUpdatePolicy()	Gets the global artifact update policy.
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.
String	getChecksumPolicy()	Gets the global checksum policy.
Map<String,Object>	getConfigProperties()	Gets 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.
String	getMetadataUpdatePolicy()	Gets the global metadata update policy.
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.
ResolutionErrorPolicy	getResolutionErrorPolicy()	Gets the policy which controls whether resolutions errors from remote repositories should be cached.
Map<String,String>	getSystemProperties()	Gets the system properties to use, e.g.
TransferListener	getTransferListener()	Gets the listener being notified of uploads/downloads by the repository system.
String	getUpdatePolicy()	Gets the global update policy, or null if not set.
Map<String,String>	getUserProperties()	Gets the user properties to use, e.g.
VersionFilter	getVersionFilter()	Gets the version filter to use for building dependency graphs.
WorkspaceReader	getWorkspaceReader()	Gets the workspace reader used during this session.
boolean	isIgnoreArtifactDescriptorRepositories()	Indicates whether repositories declared in artifact descriptors should be ignored during transitive dependency collection.
boolean	isOffline()	Indicates whether the repository system operates in offline mode and avoids/refuses any access to remote repositories.
String	sessionId()	Returns the ID of this closeable session instance.

Methods inherited from class java.lang.Object

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

Constructor Details

DefaultCloseableSession

public DefaultCloseableSession(String sessionId,
 AtomicBoolean closed,
 boolean offline,
 boolean ignoreArtifactDescriptorRepositories,
 ResolutionErrorPolicy resolutionErrorPolicy,
 ArtifactDescriptorPolicy artifactDescriptorPolicy,
 String checksumPolicy,
 String artifactUpdatePolicy,
 String metadataUpdatePolicy,
 LocalRepositoryManager localRepositoryManager,
 List<LocalRepository> localRepositories,
 WorkspaceReader workspaceReader,
 RepositoryListener repositoryListener,
 TransferListener transferListener,
 Map<String,String> systemProperties,
 Map<String,String> userProperties,
 Map<String,Object> configProperties,
 MirrorSelector mirrorSelector,
 ProxySelector proxySelector,
 AuthenticationSelector authenticationSelector,
 ArtifactTypeRegistry artifactTypeRegistry,
 DependencyTraverser dependencyTraverser,
 DependencyManager dependencyManager,
 DependencySelector dependencySelector,
 VersionFilter versionFilter,
 DependencyGraphTransformer dependencyGraphTransformer,
 SessionData data,
 RepositoryCache cache,
 RepositorySystem repositorySystem,
 RepositorySystemLifecycle repositorySystemLifecycle)

Method Details

sessionId

public String sessionId()

Description copied from interface: RepositorySystemSession.CloseableSession

Returns the ID of this closeable session instance. Each closeable session has different ID, unique within repository system they were created with.

Specified by:

sessionId in interface RepositorySystemSession.CloseableSession

Returns:

The session ID that is never null.

copy

public RepositorySystemSession.SessionBuilder copy()

Description copied from interface: RepositorySystemSession.CloseableSession

Copies this session into a pre-populated builder, effectively making a mutable copy of itself, builder builds same session. Important: this session remains unchanged upon return of this method but this session and returned builder created session will have same identity. It is up to client code, will it close only the original (this) session or new session, or both. Important is, that at least one of the sessions must be closed, and consequence is that once either one is closed, the other session is closed as well.

This pattern should be applied in "filter" like constructs, when code needs to alter the incoming session and subsequently pass it downstream.

Specified by:

copy in interface RepositorySystemSession.CloseableSession

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.

isIgnoreArtifactDescriptorRepositories

public boolean isIgnoreArtifactDescriptorRepositories()

Description copied from interface: RepositorySystemSession

Indicates whether repositories declared in artifact descriptors should be ignored during transitive dependency collection. If enabled, only the repositories originally provided with the collect request will be considered.

Specified by:

isIgnoreArtifactDescriptorRepositories in interface RepositorySystemSession

Returns:

true if additional repositories from artifact descriptors are ignored, false to merge those with the originally specified repositories.

getResolutionErrorPolicy

public ResolutionErrorPolicy getResolutionErrorPolicy()

Description copied from interface: RepositorySystemSession

Gets the policy which controls whether resolutions errors from remote repositories should be cached.

Specified by:

getResolutionErrorPolicy in interface RepositorySystemSession

Returns:

The resolution error policy for this session or null if resolution errors should generally not be cached.

getArtifactDescriptorPolicy

public ArtifactDescriptorPolicy getArtifactDescriptorPolicy()

Description copied from interface: RepositorySystemSession

Gets the policy which controls how errors related to reading artifact descriptors should be handled.

Specified by:

getArtifactDescriptorPolicy in interface RepositorySystemSession

Returns:

The descriptor error policy for this session or null if descriptor errors should generally not be tolerated.

getChecksumPolicy

public 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.CHECKSUM_POLICY_FAIL
• RepositoryPolicy.CHECKSUM_POLICY_IGNORE
• RepositoryPolicy.CHECKSUM_POLICY_WARN

getUpdatePolicy

public String getUpdatePolicy()

Description copied from interface: RepositorySystemSession

Gets the global update policy, or null if not set.

This method is meant for code that does not want to distinguish between artifact and metadata policies. Note: applications should either use get/set updatePolicy (this method and DefaultRepositorySystemSession.setUpdatePolicy(String)) or also distinguish between artifact and metadata update policies (and use other methods), but should not mix the two!

Specified by:

getUpdatePolicy in interface RepositorySystemSession

See Also:

• RepositorySystemSession.getArtifactUpdatePolicy()
• RepositorySystemSession.getMetadataUpdatePolicy()

getArtifactUpdatePolicy

public String getArtifactUpdatePolicy()

Description copied from interface: RepositorySystemSession

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

Specified by:

getArtifactUpdatePolicy in interface RepositorySystemSession

Returns:

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

See Also:

• RepositoryPolicy.UPDATE_POLICY_ALWAYS
• RepositoryPolicy.UPDATE_POLICY_DAILY
• RepositoryPolicy.UPDATE_POLICY_NEVER

getMetadataUpdatePolicy

public String getMetadataUpdatePolicy()

Description copied from interface: RepositorySystemSession

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

Specified by:

getMetadataUpdatePolicy in interface RepositorySystemSession

Returns:

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

See Also:

• RepositoryPolicy.UPDATE_POLICY_ALWAYS
• RepositoryPolicy.UPDATE_POLICY_DAILY
• RepositoryPolicy.UPDATE_POLICY_NEVER

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.

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.

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.

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.

getSystemProperties

public Map<String,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.

getUserProperties

public Map<String,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.

getConfigProperties

public Map<String,Object> getConfigProperties()

Description copied from interface: RepositorySystemSession

Gets 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

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.

See Also:

• RepositorySystem.newResolutionRepositories(RepositorySystemSession, java.util.List)

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()
• RepositorySystem.newResolutionRepositories(RepositorySystemSession, java.util.List)

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()
• RepositorySystem.newResolutionRepositories(RepositorySystemSession, java.util.List)

getArtifactTypeRegistry

public ArtifactTypeRegistry getArtifactTypeRegistry()

Description copied from interface: RepositorySystemSession

Gets the registry of artifact types recognized by this session, for instance when processing artifact descriptors.

Specified by:

getArtifactTypeRegistry in interface RepositorySystemSession

Returns:

The artifact type registry, 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 or null if dependencies are unconditionally traversed.

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 or null if dependency management is not performed.

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 or null if dependencies are unconditionally included.

getVersionFilter

public VersionFilter getVersionFilter()

Description copied from interface: RepositorySystemSession

Gets the version filter to use for building dependency graphs.

Specified by:

getVersionFilter in interface RepositorySystemSession

Returns:

The version filter to use for building dependency graphs or null if versions aren't filtered.

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 or null if none.

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.

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.

addOnSessionEndedHandler

public boolean addOnSessionEndedHandler(Runnable handler)

Description copied from interface: RepositorySystemSession

Registers a handler to execute when this session closed.

Note: Resolver 1.x sessions will not be able to register handlers. Migrate to Resolver 2.x way of handling sessions to make full use of new features. New features (like HTTP/2 transport) depend on this functionality. While they will function with Resolver 1.x sessions, they may produce resource leaks.

Specified by:

addOnSessionEndedHandler in interface RepositorySystemSession

Parameters:

handler - the handler, never null.

Returns:

true if handler successfully registered, false otherwise.

close

public void close()

Description copied from interface: RepositorySystemSession.CloseableSession

Closes the session. The session should be closed by its creator. A closed session should not be used anymore. This method may be invoked multiple times, but close will act only once (first time).

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

Specified by:

close in interface RepositorySystemSession.CloseableSession