Prev Class | Next Class | Frames | No Frames |
Summary: Nested | Field | Method | Constr | Detail: Nested | Field | Method | Constr |
java.lang.Object
org.apache.avalon.framework.Version
public final class Version
extends java.lang.Object
implements Serializable
Component
is made up of three
dot-separated fields:
"major.minor.micro"
The major, minor and micro fields are
integer numbers represented in decimal notation and have the
following meaning:
Constructor Summary | |
|
Method Summary | |
boolean | |
boolean |
|
boolean | |
int |
|
int |
|
int |
|
static Version |
|
String |
|
public Version(int major, int minor, int micro)
Create a new instance of aVersion
object with the specified version numbers.
- Parameters:
major
- ThisVersion
major number.minor
- ThisVersion
minor number.micro
- ThisVersion
micro number.
public boolean complies(Version other)
Check thisVersion
against another for compliancy (compatibility). If thisVersion
is compatible with the specified one, then true is returned, otherwise false. Be careful when using this method since, in example, version 1.3.7 is compliant to version 1.3.6, while the opposite is not. The following example displays the expected behaviour and results of version.final Version v1 = new Version( 1, 3 , 6 ); final Version v2 = new Version( 1, 3 , 7 ); final Version v3 = new Version( 1, 4 , 0 ); final Version v4 = new Version( 2, 0 , 1 ); assert( v1.complies( v1 ) ); assert( ! v1.complies( v2 ) ); assert( v2.complies( v1 ) ); assert( ! v1.complies( v3 ) ); assert( v3.complies( v1 ) ); assert( ! v1.complies( v4 ) ); assert( ! v4.complies( v1 ) );
- Parameters:
other
- The otherVersion
object to be compared with this for compliancy (compatibility).
- Returns:
- true if this
Version
is compatible with the specified one
public boolean equals(Object other)
Indicates whether some other object is "equal to" thisVersion
. Returns true if the other object is an instance ofVersion
and has the same major, minor, and micro components.
- Parameters:
other
- anObject
value
- Returns:
- true if the other object is equal to this
Version
public boolean equals(Version other)
Check thisVersion
against another for equality. If thisVersion
is compatible with the specified one, then true is returned, otherwise false.
- Parameters:
other
- The otherVersion
object to be compared with this for equality.
- Returns:
- true if this
Version
is compatible with the specified one
- Since:
- 4.1
public int getMajor()
Retrieve major component of version.
- Returns:
- the major component of version
- Since:
- 4.1
public int getMicro()
Retrieve micro component of version.
- Returns:
- the micro component of version.
- Since:
- 4.1
public int getMinor()
Retrieve minor component of version.
- Returns:
- the minor component of version
- Since:
- 4.1
public static Version getVersion(String version) throws NumberFormatException, IllegalArgumentException
Parse a version out of a string. The version string format is. . where both minor and micro are optional.
- Parameters:
version
- The input version string
- Returns:
- the new Version object
- Since:
- 4.1
public String toString()
Overload toString to report version correctly.
- Returns:
- the dot seperated version string