public class DiscriminatingNameMapper extends java.lang.Object implements NameMapper
NameMapper
, that wraps another NameMapper
and adds a "discriminator" as prefix, that
makes lock names unique including the hostname and local repository (by default). The discriminator may be passed
in via RepositorySystemSession
or is automatically calculated based on the local hostname and repository
path. The implementation retains order of collection elements as it got it from
NameMapper.nameLocks(RepositorySystemSession, Collection, Collection)
method.
The default setup wraps GAVNameMapper
, but manually may be created any instance needed.
Modifier and Type | Field and Description |
---|---|
private static java.lang.String |
CONFIG_PROP_DISCRIMINATOR
Configuration property to pass in discriminator
|
private static java.lang.String |
CONFIG_PROP_HOSTNAME
Configuration property to pass in hostname
|
private static java.lang.String |
DEFAULT_DISCRIMINATOR_DIGEST |
private static java.lang.String |
DEFAULT_HOSTNAME |
private NameMapper |
delegate |
private java.lang.String |
hostname |
private static org.slf4j.Logger |
LOGGER |
Constructor and Description |
---|
DiscriminatingNameMapper(NameMapper delegate) |
Modifier and Type | Method and Description |
---|---|
private java.lang.String |
createDiscriminator(RepositorySystemSession session) |
private java.lang.String |
getHostname() |
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. |
java.util.Collection<java.lang.String> |
nameLocks(RepositorySystemSession session,
java.util.Collection<? extends Artifact> artifacts,
java.util.Collection<? extends Metadata> metadatas)
Creates (opaque) names for passed in artifacts and metadata.
|
private static final java.lang.String CONFIG_PROP_DISCRIMINATOR
private static final java.lang.String CONFIG_PROP_HOSTNAME
private static final java.lang.String DEFAULT_DISCRIMINATOR_DIGEST
private static final java.lang.String DEFAULT_HOSTNAME
private static final org.slf4j.Logger LOGGER
private final NameMapper delegate
private final java.lang.String hostname
public DiscriminatingNameMapper(NameMapper delegate)
public boolean isFileSystemFriendly()
NameMapper
true
if lock names returned by this lock name mapper are file system friendly, can be used
as file names and paths.isFileSystemFriendly
in interface NameMapper
public java.util.Collection<java.lang.String> nameLocks(RepositorySystemSession session, java.util.Collection<? extends Artifact> artifacts, java.util.Collection<? extends Metadata> metadatas)
NameMapper
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.
nameLocks
in interface NameMapper
private java.lang.String getHostname()
private java.lang.String createDiscriminator(RepositorySystemSession session)