netx.jnlp
Class Version

java.lang.Object
  |
  +--netx.jnlp.Version

public class Version

extends java.lang.Object

A JNLP Version string in the form "1.2-3_abc" followed by an optional + (includes all later versions) or * (matches any suffixes on versions). More than one version can be included in a string by separating them with spaces.

Version strings are divided by "._-" charecters into parts. These parts are compared numerically if they can be parsed as integers or lexographically as strings otherwise. If the number of parts is different between two version strings then the smaller one is padded with zero or the empty string. Note that the padding in this version means that 1.2+ matches 1.4.0-beta1, but may not in future versions.

Version:

$Revision: 1.4 $

Author:

Jon A. Maxwell (JAM) - initial author

Constructor Summary

Version(java.lang.String versions)
Create a Version object based on a version string (ie, "1.2.3+ 4.56*").

Method Summary

protected int	compare(java.lang.String part1, java.lang.String part2) Compares two parts of a version string, by value if both can be interpreted as integers or lexically otherwise.
protected boolean	equal(java.util.List parts1, java.util.List parts2) Returns whether the parts of one version are equal to the parts of another version.
protected java.util.List	getParts(java.lang.String oneVersion) Return the constituent parts of a version string.
protected java.util.List	getVersionStrings() Return the individual version strings that make up a Version.
protected boolean	greater(java.util.List parts1, java.util.List parts2) Returns whether the parts of one version are greater than the parts of another version.
boolean	isVersionId() Returns true if the version represents a version-id (a single version number such as 1.2) and false otherwise.
boolean	matches(java.lang.String version) Returns true if all of this version's version-ids match one or more of the specifed version's version-id.
boolean	matches(Version version) Returns true if all of this version's version-ids match one or more of the specifed version's version-id.
boolean	matchesAny(java.lang.String version) Returns true if any of this version's version-ids match one or more of the specifed version's version-id.
boolean	matchesAny(Version version) Returns true if any of this version's version-ids match one or more of the specifed version's version-id.
protected void	normalize(java.util.List[] versions, int maxLength) Normalize version strings so that they contain the same number of constituent parts.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

Version

public Version(java.lang.String versions)

Create a Version object based on a version string (ie, "1.2.3+ 4.56*").

Method Detail

isVersionId

public boolean isVersionId()

Returns true if the version represents a version-id (a single version number such as 1.2) and false otherwise.

matches

public boolean matches(java.lang.String version)

Returns true if all of this version's version-ids match one or more of the specifed version's version-id.

Parameters:

version - a version string

matches

public boolean matches(Version version)

Returns true if all of this version's version-ids match one or more of the specifed version's version-id.

Parameters:

version - a Version object

matchesAny

public boolean matchesAny(java.lang.String version)

Returns true if any of this version's version-ids match one or more of the specifed version's version-id.

Parameters:

version - a version string

matchesAny

public boolean matchesAny(Version version)

Returns true if any of this version's version-ids match one or more of the specifed version's version-id.

Parameters:

version - a Version object

equal

protected boolean equal(java.util.List parts1,
                        java.util.List parts2)

Returns whether the parts of one version are equal to the parts of another version.

Parameters:

parts1 - normalized version parts

parts2 - normalized version parts

greater

protected boolean greater(java.util.List parts1,
                          java.util.List parts2)

Returns whether the parts of one version are greater than the parts of another version.

Parameters:

parts1 - normalized version parts

parts2 - normalized version parts

compare

protected int compare(java.lang.String part1,
                      java.lang.String part2)

Compares two parts of a version string, by value if both can be interpreted as integers or lexically otherwise. If a part is the result of normalization then it can be the Integer zero or an empty string. Returns a value equivalent to part1.compareTo(part2);

Parameters:

part1 - a part of a version string

part2 - a part of a version string

Returns:

comparison of the two parts

normalize

protected void normalize(java.util.List[] versions,
                         int maxLength)

Normalize version strings so that they contain the same number of constituent parts.

Parameters:

versions - list array of parts of a version string

maxLength - truncate lists to this maximum length

getVersionStrings

protected java.util.List getVersionStrings()

Return the individual version strings that make up a Version.

getParts

protected java.util.List getParts(java.lang.String oneVersion)

Return the constituent parts of a version string.

Parameters:

oneVersion - a single version id string (not compound)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object