uk.ac.ed.epcc.safe.accounting.parsers.value

Class SecondDurationParser

java.lang.Object

uk.ac.ed.epcc.safe.accounting.parsers.value.SecondDurationParser

All Implemented Interfaces:

ValueFormatter<java.lang.Integer>, ValueParser<java.lang.Integer>

public class SecondDurationParser
extends java.lang.Object
implements ValueParser<java.lang.Integer>

A parser for identifying durations specified in a particular format. The duration is converted into a number (a long) representing the number of seconds of the duration.

The format must be either HHmmss or HH:mm:ss where H is the number of hours, m is the number of minutes and s is the number of seconds. If the format contains colons, the hour, minute and second fields can contain values with more or less than two digits. For example these formats are legal:

000001 - one second
100101 - ten hours one minute one second
10:01:01 - ten hours one minute one second
100:5:16 - one hundred hours five minutes sixteen seconds
120:05:21 - one hundred and twenty hours five minutes twenty one seconds

However, if colons aren't present, the string must be exactly six characters long with the first two characters representing hours, the second two representing minutes and the third two representing seconds.

Author:

jgreen4

Field Summary

Fields

Modifier and Type	Field and Description
static SecondDurationParser	PARSER

Constructor Summary

Constructors

Constructor and Description
SecondDurationParser()

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	format(java.lang.Integer value) Format a value as a string.
java.lang.Class<java.lang.Integer>	getType() Returns the Class of object this ValueParser can handle.
java.lang.Integer	parse(java.lang.String valueString) Parses the specified string and constructs the appropriate object out of it.

Methods inherited from class java.lang.Object

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

Field Detail

PARSER

public static final SecondDurationParser PARSER

Constructor Detail

SecondDurationParser

public SecondDurationParser()

Method Detail

getType

public java.lang.Class<java.lang.Integer> getType()

Description copied from interface: ValueParser

Returns the Class of object this ValueParser can handle. The ValueParser.parse(String) method must return objects that are assignable to this type. The #format(T) method can format any object assignable to this type. The returned class will be the exact Class (i.e. not a subclass) of this ValueParser's type

Specified by:

getType in interface ValueFormatter<java.lang.Integer>

Specified by:

getType in interface ValueParser<java.lang.Integer>

Returns:

The Type of this ValueParser

parse

public java.lang.Integer parse(java.lang.String valueString)
                        throws java.lang.IllegalArgumentException,
                               java.lang.NullPointerException

Description copied from interface: ValueParser

Parses the specified string and constructs the appropriate object out of it.

Specified by:

parse in interface ValueParser<java.lang.Integer>

Throws:

java.lang.IllegalArgumentException

java.lang.NullPointerException

Parameters:

valueString - The string to parse

Returns:

The object representation of valueString

format

public java.lang.String format(java.lang.Integer value)

Description copied from interface: ValueParser

Format a value as a string. The resulting string must be in a form that can be parsed by this ValueParser

Specified by:

format in interface ValueFormatter<java.lang.Integer>

Specified by:

format in interface ValueParser<java.lang.Integer>

Parameters:

value - The object to format

Returns:

String