org.xins.common.types.standard
Class Date

java.lang.Object
  extended byorg.xins.common.types.Type
      extended byorg.xins.common.types.standard.Date

public class Date
extends Type

Standard type _date. A value of this type represents a certain moment in time, with day-precision, without an indication of the time zone.

The textual representation of a timestamp is always 8 numeric characters, in the format:

YYYYMMDD
where:

Note that all timestamps will be based on the current time zone (see TimeZone.getDefault()).

A number of milliseconds can be used to indicate a specific instant in time. This number of milliseconds is since the UNIX Epoch.

Since:
XINS 1.0.0
Version:
$Revision: 1.38 $ $Date: 2008/07/04 10:22:44 $
Author:
Ernst de Haan, Anthony Goubard

Nested Class Summary
static class Date.Value
          Value for the type _date.
 
Field Summary
static Date SINGLETON
          The only instance of this class.
 
Method Summary
static Date.Value fromStringForOptional(String string)
          Constructs a Date.Value from the specified string.
static Date.Value fromStringForRequired(String string)
          Constructs a Date.Value from the specified string which is guaranteed to be non-null.
protected  Object fromStringImpl(String string)
          Converts from a String to an instance of the value class for this type (implementation method).
 String getDescription()
          Retrieves the description of this type.
protected  boolean isValidValueImpl(String value)
          Determines if the specified String value is considered valid for this type (implementation method).
static Date.Value today()
          Constructs a Date.Value with the value of the current date.
static String toString(Date.Value value)
          Converts the specified Date.Value to a string.
 String toString(Object value)
          Generates a string representation of the specified value for this type.
 
Methods inherited from class org.xins.common.types.Type
checkValue, fromString, getName, getValueClass, isValidValue, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

SINGLETON

public static final Date SINGLETON
The only instance of this class. This field is never null.

Method Detail

today

public static Date.Value today()
Constructs a Date.Value with the value of the current date.

Returns:
the Date.Value for today, never null.

fromStringForRequired

public static Date.Value fromStringForRequired(String string)
                                        throws IllegalArgumentException,
                                               TypeValueException
Constructs a Date.Value from the specified string which is guaranteed to be non-null.

Parameters:
string - the string to convert in the ISO format YYYYMMDD, cannot be null.
Returns:
the Date.Value object, never null.
Throws:
IllegalArgumentException - if string == null.
TypeValueException - if the specified string does not represent a valid value for this type.

fromStringForOptional

public static Date.Value fromStringForOptional(String string)
                                        throws TypeValueException
Constructs a Date.Value from the specified string.

Parameters:
string - the string to convert in the ISO format YYYYMMDD, can be null.
Returns:
the Date.Value, or null if string == null.
Throws:
TypeValueException - if the specified string does not represent a valid value for this type.

toString

public static String toString(Date.Value value)
Converts the specified Date.Value to a string.

Parameters:
value - the value to convert, can be null.
Returns:
the textual representation of the value in the ISO format YYYYMMDD, or null if and only if value == null.

isValidValueImpl

protected final boolean isValidValueImpl(String value)
Description copied from class: Type
Determines if the specified String value is considered valid for this type (implementation method).

This method is called from Type.isValidValue(String). When called from that method, it is guaranteed that the argument is not null.

The implementation of this method in class Type returns true.

Overrides:
isValidValueImpl in class Type
Parameters:
value - the String value that should be checked for validity, never null.
Returns:
true if and only if the specified String value is valid, false otherwise.

fromStringImpl

protected final Object fromStringImpl(String string)
                               throws TypeValueException
Description copied from class: Type
Converts from a String to an instance of the value class for this type (implementation method).

This method is not required to check the validity of the specified value (since Type.isValidValueImpl(String) should have been called before) but if it does, then it may throw a TypeValueException.

Specified by:
fromStringImpl in class Type
Parameters:
string - the string to convert to an instance of the value class, guaranteed to be not null and guaranteed to have been passed to Type.isValidValueImpl(String) without getting an exception.
Returns:
an instance of the value class, cannot be null.
Throws:
TypeValueException - if string is considered to be an invalid value for this type.

toString

public final String toString(Object value)
                      throws IllegalArgumentException,
                             ClassCastException,
                             TypeValueException
Description copied from class: Type
Generates a string representation of the specified value for this type. The specified value must be an instance of the value class for this type (see Type.getValueClass()). Also, it may have to fall within a certain range of valid values, depending on the type.

The default implementation of this method in class Type does the following:

Overrides:
toString in class Type
Parameters:
value - the value, cannot be null.
Returns:
the string representation of the specified value for this type, cannot be null.
Throws:
IllegalArgumentException - if value == null.
ClassCastException - if getValueClass().isInstance(value) == false.
TypeValueException - if the specified value is not in the allowed range.

getDescription

public String getDescription()
Description copied from class: Type
Retrieves the description of this type.

Overrides:
getDescription in class Type
Returns:
the description of this type, never null.


See http://www.xins.org/.