Class ResourceZoneRulesDataProvider

java.lang.Object

javax.time.calendar.zone.ResourceZoneRulesDataProvider

All Implemented Interfaces:

ZoneRulesDataProvider

final class ResourceZoneRulesDataProvider
extends Object
implements ZoneRulesDataProvider

Loads time-zone rules stored in a file accessed via class loader.

ResourceZoneRulesDataProvider is thread-safe and immutable.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
(package private) static class	ResourceZoneRulesDataProvider.ResourceZoneRulesVersion	Version of the rules.

Field Summary

Fields

Modifier and Type	Field	Description
private final String	groupID	The group ID.
private final Set<String>	regions	All the regions in the provider.
private final AtomicReferenceArray<Object>	rules	The rules.
private final Set<ZoneRulesVersion>	versions	All the versions in the provider.

Constructor Summary

Constructors

Modifier	Constructor	Description
private	ResourceZoneRulesDataProvider(URL url)	Loads the rules from a URL, often in a jar file.

Method Summary

Modifier and Type	Method	Description
String	getGroupID()	Gets the time-zone group ID of the data available via this provider, such as 'TZDB'.
Set<String>	getRegionIDs()	Gets the provided region IDs.
Set<ZoneRulesVersion>	getVersions()	Gets the provided rules, version by version.
(package private) static void	load()	Loads any time-zone rules data stored in files.
private static List<ResourceZoneRulesDataProvider>	loadResources()	Loads the rules from files in the class loader, often jar files.
(package private) ZoneRules	loadRule(short index)	Loads the rule.
String	toString()

Methods inherited from class Object

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

Field Details

groupID

private final String groupID

The group ID.

versions

private final Set<ZoneRulesVersion> versions

All the versions in the provider.

regions

private final Set<String> regions

All the regions in the provider.

rules

private final AtomicReferenceArray<Object> rules

The rules.

Constructor Details

ResourceZoneRulesDataProvider

private ResourceZoneRulesDataProvider(URL url)
                               throws ClassNotFoundException,
IOException

Loads the rules from a URL, often in a jar file.

Parameters:

url - the jar file to load, not null

providers - the list to add to, not null

Throws:

Exception - if an error occurs

ClassNotFoundException

IOException

Method Details

load

static void load()

Loads any time-zone rules data stored in files.

Throws:

RuntimeException - if the time-zone rules cannot be loaded

loadResources

private static List<ResourceZoneRulesDataProvider> loadResources()

Loads the rules from files in the class loader, often jar files.

Returns:

the list of loaded rules, never null

Throws:

Exception - if an error occurs

getGroupID

public String getGroupID()

Gets the time-zone group ID of the data available via this provider, such as 'TZDB'.

Group IDs must match regex [A-Za-z0-9._-]+. Group IDs should use reverse domain name notation, like packages. Group IDs without a dot are reserved.

Specified by:

getGroupID in interface ZoneRulesDataProvider

Returns:

the ID of the group, never null

getVersions

public Set<ZoneRulesVersion> getVersions()

Gets the provided rules, version by version.

Specified by:

getVersions in interface ZoneRulesDataProvider

Returns:

the provided rules, not to be modified, never null

getRegionIDs

public Set<String> getRegionIDs()

Gets the provided region IDs.

Specified by:

getRegionIDs in interface ZoneRulesDataProvider

Returns:

the provided region IDs, not to be modified, never null

loadRule

ZoneRules loadRule(short index)
            throws Exception

Loads the rule.

Parameters:

index - the index to retrieve

Returns:

the rules, should not be null

Throws:

Exception

toString

public String toString()

Overrides:

toString in class Object