net.time4j.base

Class ResourceLoader

java.lang.Object

net.time4j.base.ResourceLoader

public abstract class ResourceLoader
extends java.lang.Object

Defines a general access point of loading any text resources and services.

Specification: All external subclasses must have a public no-arg constructor.

Since:

3.5/4.3

Field Summary

Fields

Modifier and Type	Field and Description
static java.lang.String	EXTERNAL_RESOURCE_LOADER Name der system property, über die eine externe Instanz verwendet wird.

Method Summary

Modifier and Type	Method and Description
static ResourceLoader	getInstance() Applications should never use the constructor but this static method to achieve a general instance.
abstract java.io.InputStream	load(java.net.URI uri, boolean noCache) Loads given resource as input stream.
abstract java.net.URI	locate(java.lang.String moduleName, java.lang.Class<?> moduleRef, java.lang.String path) Constructs an URI for given module resource.
abstract <S> java.lang.Iterable<S>	services(java.lang.Class<S> serviceInterface) Finds a collection of service providers available for given service provider interface.

Methods inherited from class java.lang.Object

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

Field Detail

EXTERNAL_RESOURCE_LOADER

public static final java.lang.String EXTERNAL_RESOURCE_LOADER

Name der system property, über die eine externe Instanz verwendet wird.

Time4J wird einen Error werfen, wenn der Konfigurationseintrag falsch ist.

See Also:

Constant Field Values

Method Detail

getInstance

public static ResourceLoader getInstance()

Applications should never use the constructor but this static method to achieve a general instance.

Returns:

ResourceLoader

Since:

3.5/4.3

locate

public abstract java.net.URI locate(java.lang.String moduleName,
                                    java.lang.Class<?> moduleRef,
                                    java.lang.String path)

Constructs an URI for given module resource.

Some implementations might yield an uri without verifying if the uri resource really exists.

Parameters:

moduleName - name of related time4j-module

moduleRef - module-specific class reference

path - path to text resource (must be understandable by class loaders)

Returns:

uri of resource or null if unable to locate the resource

Since:

3.5/4.3

load

public abstract java.io.InputStream load(java.net.URI uri,
                                         boolean noCache)

Loads given resource as input stream.

Callers are responsible for closing the result stream.

Parameters:

uri - uniform resource identifier as result of locate-method (optional)

noCache - avoid caching?

Returns:

input stream or null if the resource could not be opened

Since:

3.5/4.3

See Also:

locate(String, Class, String)

services

public abstract <S> java.lang.Iterable<S> services(java.lang.Class<S> serviceInterface)

Finds a collection of service providers available for given service provider interface.

Type Parameters:

S - generic service type

Parameters:

serviceInterface - service provider interface

Returns:

iterable collection of service providers

Since:

3.5/4.3