Package org.threeten.bp.zone

Class ZoneRulesInitializer

java.lang.Object

org.threeten.bp.zone.ZoneRulesInitializer

Direct Known Subclasses:

ZoneRulesInitializer.DoNothingZoneRulesInitializer, ZoneRulesInitializer.ServiceLoaderZoneRulesInitializer

public abstract class ZoneRulesInitializer
extends java.lang.Object

Controls how the time-zone rules are initialized.

The default behavior is to use ServiceLoader to find instances of ZoneRulesProvider. Use the setInitializer(ZoneRulesInitializer) method to replace this behavior. The initializer instance must perform the work of creating the ZoneRulesProvider within the initializeProviders() method to ensure that the provider is not initialized too early.

The initializer must be set before class loading of any other ThreeTen-Backport class to have any effect!

This class has been added primarily for the benefit of Android.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	ZoneRulesInitializer.DoNothingZoneRulesInitializer	Implementation that does nothing.
(package private) static class	ZoneRulesInitializer.ServiceLoaderZoneRulesInitializer	Implementation that uses the service loader.

Field Summary

Fields

Modifier and Type	Field	Description
static ZoneRulesInitializer	DO_NOTHING	An instance that does nothing.
private static java.util.concurrent.atomic.AtomicBoolean	INITIALIZED
private static java.util.concurrent.atomic.AtomicReference<ZoneRulesInitializer>	INITIALIZER

Constructor Summary

Constructors

Constructor	Description
ZoneRulesInitializer()

Method Summary

Modifier and Type	Method	Description
(package private) static void	initialize()
protected abstract void	initializeProviders()	Initialize the providers.
static void	setInitializer(ZoneRulesInitializer initializer)	Sets the initializer to use.

Methods inherited from class java.lang.Object

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

Field Detail

DO_NOTHING

public static final ZoneRulesInitializer DO_NOTHING

An instance that does nothing. Call setInitializer(ZoneRulesInitializer) with this instance to block the service loader search. This will leave the system with no providers.

INITIALIZED

private static final java.util.concurrent.atomic.AtomicBoolean INITIALIZED

INITIALIZER

private static final java.util.concurrent.atomic.AtomicReference<ZoneRulesInitializer> INITIALIZER

Constructor Detail

ZoneRulesInitializer

public ZoneRulesInitializer()

Method Detail

setInitializer

public static void setInitializer(ZoneRulesInitializer initializer)

Sets the initializer to use.

This can only be invoked before the ZoneRulesProvider class is loaded. Invoking this method at a later point will throw an exception.

Parameters:

initializer - the initializer to use

Throws:

java.lang.IllegalStateException - if initialization has already occurred or another initializer has been set

initialize

static void initialize()

initializeProviders

protected abstract void initializeProviders()

Initialize the providers.

The implementation should perform whatever work is necessary to initialize the providers. This will result in one or more calls to ZoneRulesProvider.registerProvider(ZoneRulesProvider).

It is vital that the instance of ZoneRulesProvider is not created until this method is invoked.

It is guaranteed that this method will be invoked once and only once.