org.apache.sling.feature

Class ArtifactId

java.lang.Object

org.apache.sling.feature.ArtifactId

All Implemented Interfaces:

Comparable<ArtifactId>

public class ArtifactId
extends Object
implements Comparable<ArtifactId>

An artifact identifier. An artifact is described by it's Apache Maven coordinates consisting of group id, artifact id, and version. In addition, the classifier and type can be specified. If no type is specified, jar is assumed. This class is not thread-safe.

Constructor Summary

Constructors

Constructor and Description
ArtifactId(String groupId, String artifactId, String version, String classifier, String type) Create a new artifact object

Method Summary

Modifier and Type	Method and Description
int	compareTo(ArtifactId o)
boolean	equals(Object o)
static ArtifactId	fromMvnId(String coordinates) Create a new artifact id from maven coordinates/id groupId:artifactId[:packaging[:classifier]]:version
static ArtifactId	fromMvnUrl(String url) Create a new artifact id from a maven url, 'mvn:' group-id '/' artifact-id [ '/' [version] [ '/' [type] [ '/' classifier ] ] ] ]
String	getArtifactId() Return the artifact id.
String	getClassifier() Return the optional classifier.
String	getGroupId() Return the group id.
org.osgi.framework.Version	getOSGiVersion() Return the OSGi version
String	getType() Return the type.
String	getVersion() Return the version.
int	hashCode()
boolean	isSame(ArtifactId id) Test whether the artifact id is pointing to the same artifact but potentially a different version
static ArtifactId	parse(String s) Create a new artifact id from a string, the string must either be a mvn url or a mvn id (= coordinates)
String	toMvnId() Return a mvn id
String	toMvnPath() Create a Maven like relative repository path.
String	toMvnUrl() Return a mvn url
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

ArtifactId

public ArtifactId(String groupId,
                  String artifactId,
                  String version,
                  String classifier,
                  String type)

Create a new artifact object

Parameters:

groupId - The group id (required)

artifactId - The artifact id (required)

version - The version (required)

classifier - The classifier (optional)

type - The type/extension (optional, defaults to jar)

Throws:

IllegalArgumentException - If group id, artifact id or version are null or if the version is not a valid version.

Method Detail

parse

public static ArtifactId parse(String s)

Create a new artifact id from a string, the string must either be a mvn url or a mvn id (= coordinates)

Parameters:

s - The string to parse

Returns:

The artifact id

Throws:

IllegalArgumentException - if the string can't be parsed to a valid artifact id.

fromMvnUrl

public static ArtifactId fromMvnUrl(String url)

Create a new artifact id from a maven url, 'mvn:' group-id '/' artifact-id [ '/' [version] [ '/' [type] [ '/' classifier ] ] ] ]

Parameters:

url - The url

Returns:

A new artifact id

Throws:

IllegalArgumentException - If the url is not valid

fromMvnId

public static ArtifactId fromMvnId(String coordinates)

Create a new artifact id from maven coordinates/id groupId:artifactId[:packaging[:classifier]]:version

Parameters:

coordinates - The coordinates as outlined above

Returns:

A new artifact id

Throws:

IllegalArgumentException - If the id is not valid

toMvnUrl

public String toMvnUrl()

Return a mvn url

Returns:

A mvn url

See Also:

fromMvnUrl(String)

toMvnId

public String toMvnId()

Return a mvn id

Returns:

The mvn id #see fromMvnId(String)

getGroupId

public String getGroupId()

Return the group id.

Returns:

The group id.

getArtifactId

public String getArtifactId()

Return the artifact id.

Returns:

The artifact id.

getClassifier

public String getClassifier()

Return the optional classifier.

Returns:

The classifier or null.

getType

public String getType()

Return the type.

Returns:

The type.

getVersion

public String getVersion()

Return the version.

Returns:

The version.

isSame

public boolean isSame(ArtifactId id)

Test whether the artifact id is pointing to the same artifact but potentially a different version

Parameters:

id - The artifact id

Returns:

true if group id, artifact id, type and classifier equal

getOSGiVersion

public org.osgi.framework.Version getOSGiVersion()

Return the OSGi version

Returns:

The OSGi version

toMvnPath

public String toMvnPath()

Create a Maven like relative repository path.

Returns:

A relative repository path. The path does not start with a slash.

hashCode

public int hashCode()

Overrides:

hashCode in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

compareTo

public int compareTo(ArtifactId o)

Specified by:

compareTo in interface Comparable<ArtifactId>

toString

public String toString()

Overrides:

toString in class Object