net.time4j.engine

Class BasicElement<V extends java.lang.Comparable<V>>

java.lang.Object

net.time4j.engine.BasicElement<V>

Type Parameters:

V - generic type of element values

All Implemented Interfaces:

java.io.Serializable, java.util.Comparator<ChronoDisplay>, ChronoElement<V>

public abstract class BasicElement<V extends java.lang.Comparable<V>>
extends java.lang.Object
implements ChronoElement<V>, java.io.Serializable

Abstract base implementation of a chronological element which has a name and can also define an (unregistered) element rule.

See Also:

Serialized Form

Method Summary

Modifier and Type	Method and Description
int	compare(ChronoDisplay o1, ChronoDisplay o2) Compares the values of this element based on their natural order.
boolean	equals(java.lang.Object obj) Based on equality of element names AND element classes.
char	getSymbol() There is no format symbol by default.
int	hashCode() Based on the element name.
boolean	isLenient() Chronological elements are strict by default.
boolean	isLocal() Elements are local by default and can therefore not be used in a global context.
java.lang.String	name() Returns the name which is unique within the context of a given chronology.
java.lang.String	toString() Serves mainly for debugging support.

Methods inherited from class java.lang.Object

getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface net.time4j.engine.ChronoElement

getDefaultMaximum, getDefaultMinimum, getType, isDateElement, isTimeElement

Methods inherited from interface java.util.Comparator

comparing, comparing, comparingDouble, comparingInt, comparingLong, naturalOrder, nullsFirst, nullsLast, reversed, reverseOrder, thenComparing, thenComparing, thenComparing, thenComparingDouble, thenComparingInt, thenComparingLong

Method Detail

name

public final java.lang.String name()

Description copied from interface: ChronoElement

Returns the name which is unique within the context of a given chronology.

The name can also serve as resource key together with the name of a chronology for a localized description.

Specified by:

name in interface ChronoElement<V extends java.lang.Comparable<V>>

Returns:

name of element, unique within a chronology

compare

public int compare(ChronoDisplay o1,
                   ChronoDisplay o2)

Compares the values of this element based on their natural order.

Specified by:

compare in interface java.util.Comparator<ChronoDisplay>

Specified by:

compare in interface ChronoElement<V extends java.lang.Comparable<V>>

Parameters:

o1 - the first object to be compared

o2 - the second object to be compared

Returns:

a negative integer, zero, or a positive integer as the first argument is less than, equal to, or greater than the second

Throws:

ChronoException - if this element is not registered in any entity and/or if no element rule exists to extract the element value

Since:

3.5/4.3

getSymbol

public char getSymbol()

There is no format symbol by default.

In order to define a format symbol subclasses must override this methode. In that case such an element instance should be annotated with the annotation FormattableElement for documentation support.

Specified by:

getSymbol in interface ChronoElement<V extends java.lang.Comparable<V>>

Returns:

ASCII-0 (placeholder for an undefined format symbol)

See Also:

FormattableElement

isLenient

public boolean isLenient()

Chronological elements are strict by default.

Specified by:

isLenient in interface ChronoElement<V extends java.lang.Comparable<V>>

Returns:

false

See Also:

ElementRule.withValue(T, V, boolean)

isLocal

public boolean isLocal()

Elements are local by default and can therefore not be used in a global context.

Returns:

true

Since:

2.0

See Also:

getVeto(Chronology)

equals

public boolean equals(java.lang.Object obj)

Based on equality of element names AND element classes.

Specified by:

equals in interface java.util.Comparator<ChronoDisplay>

Overrides:

equals in class java.lang.Object

Returns:

true if this instance and the argument are of same class and have same names else false

hashCode

public int hashCode()

Based on the element name.

Overrides:

hashCode in class java.lang.Object

Returns:

int

toString

public java.lang.String toString()

Serves mainly for debugging support.

For display purpose the method name() is to be preferred.

Overrides:

toString in class java.lang.Object

Returns:

String