Package VASSAL.tools.version

Class VassalVersionTokenizer

java.lang.Object

VASSAL.tools.version.VassalVersionTokenizer

All Implemented Interfaces:

VersionTokenizer

public class VassalVersionTokenizer
extends Object
implements VersionTokenizer

A finite-state machine for converting VASSAL version numbers into a series of integers. The integers thus returned from two different tokenizers may be compared to determine the temporal ordering of two VASSAL versions. Valid version strings are dotted decimal digits, followed optionally by a tag, followed optionally by a build number. Anything beyond the build nubmer is ignored. Old version numbers which are not valid by current standards (e.g., 3.0b6) may be successfully parsed far enough to determine their ordering with respect to post-3.1.0 versions.

Since:

3.1.0

Author:

Joel Uckelman

See Also:

VersionFormatException

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	VassalVersionTokenizer.State

Field Summary

Fields

Modifier and Type	Field	Description
protected VassalVersionTokenizer.State	state
protected static Map<String,Integer>	tags
protected String	v

Constructor Summary

Constructors

Constructor	Description
VassalVersionTokenizer(String version)	Constructs a VersionTokenizer which operates on a version String.

Method Summary

Modifier and Type	Method	Description
boolean	hasNext()	Returns true if the version String is not fully parsed.
int	next()	Returns an integer representing the next token.

Methods inherited from class java.lang.Object

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

Field Details

v

protected String v

state

protected VassalVersionTokenizer.State state

tags

protected static Map<String,Integer> tags

Constructor Details

VassalVersionTokenizer

public VassalVersionTokenizer(String version)

Constructs a VersionTokenizer which operates on a version String.

Parameters:

version - the version String to parse

Throws:

IllegalArgumentException - if version == null.

Method Details

hasNext

public boolean hasNext()

Returns true if the version String is not fully parsed.

Specified by:

hasNext in interface VersionTokenizer

Returns:

true if VersionTokenizer.next() will return more integers

next

public int next() throws VersionFormatException

Returns an integer representing the next token.

Specified by:

next in interface VersionTokenizer

Returns:

the integer representing the next token

Throws:

VersionFormatException - if the string deviates from the current version formatting rules at the next token.