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

Class XMLDateTimeParser

java.lang.Object

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

All Implemented Interfaces:

ValueFormatter<java.util.Date>, ValueParser<java.util.Date>

public class XMLDateTimeParser
extends java.lang.Object
implements ValueParser<java.util.Date>

Parser that parses a string into an Java Date. The format of the string should follow the XML schema DateTime specification. A NullPointerException is thrown if the string provided is null.

Author:

jgreen4

Field Summary

Fields

Modifier and Type	Field and Description
static XMLDateTimeParser	PARSER Useful static instance of this object to be used when one doesn't want to generate lots of parsers when one will suffice

Constructor Summary

Constructors

Constructor and Description
XMLDateTimeParser()

Method Summary

Methods

Modifier and Type	Method and Description
java.lang.String	format(java.util.Date value) Format a value as a string.
java.lang.Class<java.util.Date>	getType() Returns the Class of object this ValueParser can handle.
java.util.Date	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 XMLDateTimeParser PARSER

Useful static instance of this object to be used when one doesn't want to generate lots of parsers when one will suffice

Constructor Detail

XMLDateTimeParser

public XMLDateTimeParser()

Method Detail

getType

public java.lang.Class<java.util.Date> 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.util.Date>

Specified by:

getType in interface ValueParser<java.util.Date>

Returns:

The Type of this ValueParser

parse

public java.util.Date 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.util.Date>

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.util.Date 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.util.Date>

Specified by:

format in interface ValueParser<java.util.Date>

Parameters:

value - The object to format

Returns:

String