net.time4j.engine

Interface ChronoExtension

public interface ChronoExtension

Defines a configuration-dependent extension of the chronological elements of a Chronology.

Author:

Meno Hochschild

Method Summary

Methods

Modifier and Type	Method and Description
Set<ChronoElement<?>>	getElements(Locale locale, AttributeQuery attributes) Returns the element set for given configuration.
<T extends ChronoEntity<T>> T	resolve(T entity) Updates the given value source if necessary in order to resolve the values of extension elements to values of standard elements.

Method Detail

getElements

Set<ChronoElement<?>> getElements(Locale locale,
                                AttributeQuery attributes)

Returns the element set for given configuration.

An empty Set indicates that this extension is not relevant for the given configuration.

Parameters:

locale - language and country setting

attributes - configuration attributes

Returns:

extended element model

resolve

<T extends ChronoEntity<T>> T resolve(T entity)

Updates the given value source if necessary in order to resolve the values of extension elements to values of standard elements.

Implementations are allowed to use null as pseudo-value in order to delete an element from given source via the expression parsedValues.with(element, null). Note: The argument has exceptionally no chronology.

Parameters:

entity - any kind of map from chronological elements to their values (note that the main use case of parsed data has no chronology and allows the virtual value null to be set as indication for removing associated element)

Returns:

eventually changed argument

See Also:

ChronoEntity.with(ChronoElement, V)