org.apache.jackrabbit.value
Class DateValue

java.lang.Object
  org.apache.jackrabbit.value.BaseValue
      org.apache.jackrabbit.value.DateValue

All Implemented Interfaces:

Value

public class DateValue
extends BaseValue

A DateValue provides an implementation of the Value interface representing a date value.

Field Summary

static int

TYPE

Fields inherited from class org.apache.jackrabbit.value.BaseValue

DEFAULT_ENCODING, stream, type

Constructor Summary

DateValue(Calendar date)
Constructs a DateValue object representing a date.

Method Summary

boolean	equals(Object obj) Indicates whether some other object is "equal to" this one.
boolean	getBoolean()
Calendar	getDate()
BigDecimal	getDecimal()
double	getDouble()
protected String	getInternalString() Returns the internal string representation of this value without modifying the value state.
long	getLong()
int	hashCode() Returns zero to satisfy the Object equals/hashCode contract.
static DateValue	valueOf(String s) Returns a new DateValue initialized to the value represented by the specified String.

Methods inherited from class org.apache.jackrabbit.value.BaseValue

getBinary, getStream, getString, getType

Methods inherited from class java.lang.Object

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

Field Detail

TYPE

public static final int TYPE

See Also:

Constant Field Values

Constructor Detail

DateValue

public DateValue(Calendar date)
          throws IllegalArgumentException

Constructs a DateValue object representing a date.

Parameters:

date - the date this DateValue should represent

Throws:

IllegalArgumentException - if the given date cannot be represented as defined by ISO 8601.

Method Detail

valueOf

public static DateValue valueOf(String s)
                         throws ValueFormatException

Returns a new DateValue initialized to the value represented by the specified String.

The specified String must be a ISO8601-compliant date/time string.

Parameters:

s - the string to be parsed.

Returns:

a newly constructed DateValue representing the the specified value.

Throws:

ValueFormatException - If the String is not a valid ISO8601-compliant date/time string.

See Also:

ISO8601

equals

public boolean equals(Object obj)

Indicates whether some other object is "equal to" this one.

The result is true if and only if the argument is not null and is a DateValue object that represents the same value as this object.

The value comparison is performed using the ISO 8601 string representation of the dates, since the native Calendar.equals() method may produce false negatives (see JSR-598).

Note that the comparison still returns false when comparing the same time in different time zones, but that seems to be the intent of JSR 170. Compare the Value.getDate().getTime() values if you need an exact time comparison in UTC.

Overrides:

equals in class Object

Parameters:

obj - the reference object with which to compare.

Returns:

true if this object is the same as the obj argument; false otherwise.

hashCode

public int hashCode()

Returns zero to satisfy the Object equals/hashCode contract. This class is mutable and not meant to be used as a hash key.

Overrides:

hashCode in class Object

Returns:

always zero

See Also:

Object.hashCode()

getInternalString

protected String getInternalString()
                            throws ValueFormatException

Returns the internal string representation of this value without modifying the value state.

Specified by:

getInternalString in class BaseValue

Returns:

the internal string representation

Throws:

ValueFormatException - if the value can not be represented as a String or if the value is null.

getDate

public Calendar getDate()
                 throws ValueFormatException,
                        IllegalStateException,
                        RepositoryException

Specified by:

getDate in interface Value

Overrides:

getDate in class BaseValue

Throws:

ValueFormatException

IllegalStateException

RepositoryException

getLong

public long getLong()
             throws ValueFormatException,
                    IllegalStateException,
                    RepositoryException

Specified by:

getLong in interface Value

Overrides:

getLong in class BaseValue

Throws:

ValueFormatException

IllegalStateException

RepositoryException

getBoolean

public boolean getBoolean()
                   throws ValueFormatException,
                          IllegalStateException,
                          RepositoryException

Specified by:

getBoolean in interface Value

Overrides:

getBoolean in class BaseValue

Throws:

ValueFormatException

IllegalStateException

RepositoryException

getDouble

public double getDouble()
                 throws ValueFormatException,
                        IllegalStateException,
                        RepositoryException

Specified by:

getDouble in interface Value

Overrides:

getDouble in class BaseValue

Throws:

ValueFormatException

IllegalStateException

RepositoryException

getDecimal

public BigDecimal getDecimal()
                      throws ValueFormatException,
                             IllegalStateException,
                             RepositoryException

Specified by:

getDecimal in interface Value

Overrides:

getDecimal in class BaseValue

Throws:

ValueFormatException

IllegalStateException

RepositoryException