Package org.eclipse.aether.util.artifact
Class DelegatingArtifact
- java.lang.Object
-
- org.eclipse.aether.artifact.AbstractArtifact
-
- org.eclipse.aether.util.artifact.DelegatingArtifact
-
- All Implemented Interfaces:
Artifact
public abstract class DelegatingArtifact extends AbstractArtifact
An artifact that delegates to another artifact instance. This class serves as a base for subclasses that want to carry additional data fields.
-
-
Constructor Summary
Constructors Modifier Constructor Description protected
DelegatingArtifact(Artifact delegate)
Creates a new artifact instance that delegates to the specified artifact.
-
Method Summary
All Methods Instance Methods Abstract Methods Concrete Methods Modifier and Type Method Description boolean
equals(Object obj)
Compares this artifact with the specified object.String
getArtifactId()
Gets the artifact identifier of this artifact, for example "maven-model".String
getBaseVersion()
Gets the base version of this artifact, for example "1.0-SNAPSHOT".String
getClassifier()
Gets the classifier of this artifact, for example "sources".String
getExtension()
Gets the (file) extension of this artifact, for example "jar" or "tar.gz".File
getFile()
Gets the file of this artifact.String
getGroupId()
Gets the group identifier of this artifact, for example "org.apache.maven".Map<String,String>
getProperties()
Gets the properties of this artifact.String
getProperty(String key, String defaultValue)
Gets the specified property.String
getVersion()
Gets the version of this artifact, for example "1.0-20100529-1213".int
hashCode()
Returns a hash code for this artifact.boolean
isSnapshot()
Determines whether this artifact uses a snapshot version.protected abstract DelegatingArtifact
newInstance(Artifact delegate)
Creates a new artifact instance that delegates to the specified artifact.Artifact
setFile(File file)
Sets the file of the artifact.Artifact
setProperties(Map<String,String> properties)
Sets the properties for the artifact.Artifact
setVersion(String version)
Sets the version of the artifact.String
toString()
-
Methods inherited from class org.eclipse.aether.artifact.AbstractArtifact
copyProperties
-
-
-
-
Constructor Detail
-
DelegatingArtifact
protected DelegatingArtifact(Artifact delegate)
Creates a new artifact instance that delegates to the specified artifact.- Parameters:
delegate
- The artifact to delegate to, must not benull
.
-
-
Method Detail
-
newInstance
protected abstract DelegatingArtifact newInstance(Artifact delegate)
Creates a new artifact instance that delegates to the specified artifact. Subclasses should use this hook to instantiate themselves, taking along any data from the current instance that was added.- Parameters:
delegate
- The artifact to delegate to, must not benull
.- Returns:
- The new delegating artifact, never
null
.
-
getGroupId
public String getGroupId()
Description copied from interface:Artifact
Gets the group identifier of this artifact, for example "org.apache.maven".- Returns:
- The group identifier, never
null
.
-
getArtifactId
public String getArtifactId()
Description copied from interface:Artifact
Gets the artifact identifier of this artifact, for example "maven-model".- Returns:
- The artifact identifier, never
null
.
-
getVersion
public String getVersion()
Description copied from interface:Artifact
Gets the version of this artifact, for example "1.0-20100529-1213". Note that in case of meta versions like "1.0-SNAPSHOT", the artifact's version depends on the state of the artifact. Artifacts that have been resolved or deployed will usually have the meta version expanded.- Returns:
- The version, never
null
.
-
setVersion
public Artifact setVersion(String version)
Description copied from interface:Artifact
Sets the version of the artifact.- Specified by:
setVersion
in interfaceArtifact
- Overrides:
setVersion
in classAbstractArtifact
- Parameters:
version
- The version of this artifact, may benull
or empty.- Returns:
- The new artifact, never
null
.
-
getBaseVersion
public String getBaseVersion()
Description copied from interface:Artifact
Gets the base version of this artifact, for example "1.0-SNAPSHOT". In contrast to theArtifact.getVersion()
, the base version will always refer to the unresolved meta version.- Specified by:
getBaseVersion
in interfaceArtifact
- Overrides:
getBaseVersion
in classAbstractArtifact
- Returns:
- The base version, never
null
.
-
isSnapshot
public boolean isSnapshot()
Description copied from interface:Artifact
Determines whether this artifact uses a snapshot version.- Specified by:
isSnapshot
in interfaceArtifact
- Overrides:
isSnapshot
in classAbstractArtifact
- Returns:
true
if the artifact is a snapshot,false
otherwise.
-
getClassifier
public String getClassifier()
Description copied from interface:Artifact
Gets the classifier of this artifact, for example "sources".- Returns:
- The classifier or an empty string if none, never
null
.
-
getExtension
public String getExtension()
Description copied from interface:Artifact
Gets the (file) extension of this artifact, for example "jar" or "tar.gz".- Returns:
- The file extension (without leading period), never
null
.
-
getFile
public File getFile()
Description copied from interface:Artifact
Gets the file of this artifact. Note that only resolved artifacts have a file associated with them. In general, callers must not assume any relationship between an artifact's filename and its coordinates.- Returns:
- The file or
null
if the artifact isn't resolved.
-
setFile
public Artifact setFile(File file)
Description copied from interface:Artifact
Sets the file of the artifact.- Specified by:
setFile
in interfaceArtifact
- Overrides:
setFile
in classAbstractArtifact
- Parameters:
file
- The file of the artifact, may benull
- Returns:
- The new artifact, never
null
.
-
getProperty
public String getProperty(String key, String defaultValue)
Description copied from interface:Artifact
Gets the specified property.- Specified by:
getProperty
in interfaceArtifact
- Overrides:
getProperty
in classAbstractArtifact
- Parameters:
key
- The name of the property, must not benull
.defaultValue
- The default value to return in case the property is not set, may benull
.- Returns:
- The requested property value or
null
if the property is not set and no default value was provided. - See Also:
ArtifactProperties
-
getProperties
public Map<String,String> getProperties()
Description copied from interface:Artifact
Gets the properties of this artifact. Clients may use these properties to associate non-persistent values with an artifact that help later processing when the artifact gets passed around within the application.- Returns:
- The (read-only) properties, never
null
. - See Also:
ArtifactProperties
-
setProperties
public Artifact setProperties(Map<String,String> properties)
Description copied from interface:Artifact
Sets the properties for the artifact. Note that these properties exist merely in memory and are not persisted when the artifact gets installed/deployed to a repository.- Specified by:
setProperties
in interfaceArtifact
- Overrides:
setProperties
in classAbstractArtifact
- Parameters:
properties
- The properties for the artifact, may benull
.- Returns:
- The new artifact, never
null
. - See Also:
ArtifactProperties
-
equals
public boolean equals(Object obj)
Description copied from class:AbstractArtifact
Compares this artifact with the specified object.- Overrides:
equals
in classAbstractArtifact
- Parameters:
obj
- The object to compare this artifact against, may benull
.- Returns:
true
if and only if the specified object is anotherArtifact
with equal coordinates, properties and file,false
otherwise.
-
hashCode
public int hashCode()
Description copied from class:AbstractArtifact
Returns a hash code for this artifact.- Overrides:
hashCode
in classAbstractArtifact
- Returns:
- A hash code for the artifact.
-
toString
public String toString()
- Overrides:
toString
in classAbstractArtifact
-
-