Package 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

Fields

Modifier and Type	Field	Description
static final int	TYPE

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
boolean	equals(Object obj)	Indicates whether some other object is "equal to" this one.
boolean	getBoolean()	Returns a Boolean representation of this value.
Calendar	getDate()	Returns a Calendar representation of this value.
BigDecimal	getDecimal()	Returns a BigDecimal representation of this value.
double	getDouble()	Returns a double representation of this value.
long	getLong()	Returns a long representation of this value.
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

getClass, notify, notifyAll, toString, wait, wait, wait

Field Details

TYPE

public static final int TYPE

See Also:

• Constant Field Values

Constructor Details

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 Details

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()

getDate

public Calendar getDate()
                 throws ValueFormatException,
IllegalStateException,
RepositoryException

Returns a Calendar representation of this value.

The object returned is a copy of the stored value, so changes to it are not reflected in internal storage.

Specified by:

getDate in interface Value

Overrides:

getDate in class BaseValue

Returns:

A Calendar representation of this value.

Throws:

ValueFormatException - if conversion to a Calendar is not possible.

RepositoryException - if another error occurs.

IllegalStateException

getLong

public long getLong()
             throws ValueFormatException,
IllegalStateException,
RepositoryException

Returns a long representation of this value.

Specified by:

getLong in interface Value

Overrides:

getLong in class BaseValue

Returns:

A long representation of this value.

Throws:

ValueFormatException - if conversion to an long is not possible.

RepositoryException - if another error occurs.

IllegalStateException

getBoolean

public boolean getBoolean()
                   throws ValueFormatException,
IllegalStateException,
RepositoryException

Returns a Boolean representation of this value.

Specified by:

getBoolean in interface Value

Overrides:

getBoolean in class BaseValue

Returns:

A Boolean representation of this value.

Throws:

ValueFormatException - if conversion to a Boolean is not possible.

RepositoryException - if another error occurs.

IllegalStateException

getDouble

public double getDouble()
                 throws ValueFormatException,
IllegalStateException,
RepositoryException

Returns a double representation of this value.

Specified by:

getDouble in interface Value

Overrides:

getDouble in class BaseValue

Returns:

A double representation of this value.

Throws:

ValueFormatException - if conversion to a double is not possible.

RepositoryException - if another error occurs.

IllegalStateException

getDecimal

public BigDecimal getDecimal()
                      throws ValueFormatException,
IllegalStateException,
RepositoryException

Returns a BigDecimal representation of this value.

Specified by:

getDecimal in interface Value

Overrides:

getDecimal in class BaseValue

Returns:

A BigDecimal representation of this value.

Throws:

ValueFormatException - if conversion to a BigDecimal is not possible.

RepositoryException - if another error occurs.

IllegalStateException