Package org.eclipse.aether.internal.impl.synccontext.named

Class GAVNameMapper

java.lang.Object

org.eclipse.aether.internal.impl.synccontext.named.GAVNameMapper

All Implemented Interfaces:

NameMapper

Direct Known Subclasses:

GAECVNameMapper

public class GAVNameMapper
extends Object
implements NameMapper

Artifact GAV NameMapper, uses artifact and metadata coordinates to name their corresponding locks. Is not considering local repository, only the artifact coordinates. May use custom prefixes and suffixes and separators, hence this instance may or may not be filesystem friendly (depends on strings used).

Note: in earlier Resolver 1.9.x versions this mapper was the default, but it changed to GAECVNameMapper in 1.9.25.

Field Summary

Fields

Modifier and Type	Field	Description
protected final String	artifactPrefix
protected final String	artifactSuffix
protected final String	fieldSeparator
protected final boolean	fileSystemFriendly
protected static final String	MAVEN_METADATA
protected final String	metadataPrefix
protected final String	metadataSuffix

Constructor Summary

Constructors

Constructor	Description
GAVNameMapper(boolean fileSystemFriendly, String artifactPrefix, String artifactSuffix, String metadataPrefix, String metadataSuffix, String fieldSeparator)

Method Summary

Modifier and Type	Method	Description
static NameMapper	fileGav()	Deprecated. Use NameMappers to create name mappers instead.
static NameMapper	gav()	Deprecated. Use NameMappers to create name mappers instead.
protected String	getArtifactName(Artifact artifact)
protected String	getMetadataName(Metadata metadata)
boolean	isFileSystemFriendly()	Returns true if lock names returned by this lock name mapper are file system friendly, can be used as file names and paths.
Collection<String>	nameLocks(RepositorySystemSession session, Collection<? extends Artifact> artifacts, Collection<? extends Metadata> metadatas)	Creates (opaque) names for passed in artifacts and metadata.

Methods inherited from class java.lang.Object

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

Field Details

fileSystemFriendly

protected final boolean fileSystemFriendly

artifactPrefix

protected final String artifactPrefix

artifactSuffix

protected final String artifactSuffix

metadataPrefix

protected final String metadataPrefix

metadataSuffix

protected final String metadataSuffix

fieldSeparator

protected final String fieldSeparator

MAVEN_METADATA

protected static final String MAVEN_METADATA

See Also:

• Constant Field Values

Constructor Details

GAVNameMapper

public GAVNameMapper(boolean fileSystemFriendly,
 String artifactPrefix,
 String artifactSuffix,
 String metadataPrefix,
 String metadataSuffix,
 String fieldSeparator)

Method Details

isFileSystemFriendly

public boolean isFileSystemFriendly()

Description copied from interface: NameMapper

Returns true if lock names returned by this lock name mapper are file system friendly, can be used as file names and paths.

Specified by:

isFileSystemFriendly in interface NameMapper

nameLocks

public Collection<String> nameLocks(RepositorySystemSession session,
 Collection<? extends Artifact> artifacts,
 Collection<? extends Metadata> metadatas)

Description copied from interface: NameMapper

Creates (opaque) names for passed in artifacts and metadata. Returned collection has max size of sum of the passed in artifacts and metadata collections, or less. If an empty collection is returned, there will be no locking happening. Never returns null. The resulting collection MUST BE "stable" (always sorted by same criteria) to avoid deadlocks by acquiring locks in same order, essentially disregarding the order of the input collections.

There is no requirement of any kind of "parity" between input element count (sum of two collections, that is) and output collection size, just the returned upper size limit is defined (sum of the passed in two collections size). If returned collection is empty, no locking will happen, if single element, one lock will be used, if two then two named locks will be used etc.

Note: name mapper must not use same string for artifacts and metadata, so even the simplest possible implementation like StaticNameMapper uses two different static strings.

Specified by:

nameLocks in interface NameMapper

getArtifactName

protected String getArtifactName(Artifact artifact)

getMetadataName

protected String getMetadataName(Metadata metadata)

gav

@Deprecated
public static NameMapper gav()

Deprecated.

Use NameMappers to create name mappers instead.

fileGav

@Deprecated
public static NameMapper fileGav()

Deprecated.

Use NameMappers to create name mappers instead.