org.apache.maven.artifact.versioning
Class VersionRange

java.lang.Object
  org.apache.maven.artifact.versioning.VersionRange

public class VersionRange
extends java.lang.Object

Construct a version range from a specification.

Version:

$Id: VersionRange.java 495147 2007-01-11 07:47:53Z jvanzyl $

Author:

Brett Porter

Method Summary

VersionRange	cloneOf()
boolean	containsVersion(ArtifactVersion version)
static VersionRange	createFromVersion(java.lang.String version)
static VersionRange	createFromVersionSpec(java.lang.String spec) Create a version range from a string representation Some spec examples are 1.0 Version 1.0 [1.0,2.0) Versions 1.0 (included) to 2.0 (not included) [1.0,2.0] Versions 1.0 to 2.0 (both included) [1.5,) Versions 1.5 and higher (,1.0],[1.2,) Versions up to 1.0 (included) and 1.2 or higher
ArtifactVersion	getRecommendedVersion()
java.util.List	getRestrictions()
ArtifactVersion	getSelectedVersion(Artifact artifact)
boolean	hasRestrictions()
boolean	isSelectedVersionKnown(Artifact artifact)
ArtifactVersion	matchVersion(java.util.List versions)
VersionRange	restrict(VersionRange restriction)
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Method Detail

getRecommendedVersion

public ArtifactVersion getRecommendedVersion()

getRestrictions

public java.util.List getRestrictions()

cloneOf

public VersionRange cloneOf()

createFromVersionSpec

public static VersionRange createFromVersionSpec(java.lang.String spec)
                                          throws InvalidVersionSpecificationException

Create a version range from a string representation Some spec examples are

• 1.0 Version 1.0
• [1.0,2.0) Versions 1.0 (included) to 2.0 (not included)
• [1.0,2.0] Versions 1.0 to 2.0 (both included)
• [1.5,) Versions 1.5 and higher
• (,1.0],[1.2,) Versions up to 1.0 (included) and 1.2 or higher

Parameters:

spec - string representation of a version or version range

Returns:

a new VersionRange object that represents the spec

Throws:

InvalidVersionSpecificationException

createFromVersion

public static VersionRange createFromVersion(java.lang.String version)

restrict

public VersionRange restrict(VersionRange restriction)

getSelectedVersion

public ArtifactVersion getSelectedVersion(Artifact artifact)
                                   throws OverConstrainedVersionException

Throws:

OverConstrainedVersionException

isSelectedVersionKnown

public boolean isSelectedVersionKnown(Artifact artifact)
                               throws OverConstrainedVersionException

Throws:

OverConstrainedVersionException

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

matchVersion

public ArtifactVersion matchVersion(java.util.List versions)

containsVersion

public boolean containsVersion(ArtifactVersion version)

hasRestrictions

public boolean hasRestrictions()