org.apache.tamaya.spi

Interface ServiceContext

public interface ServiceContext

This class models the component that is managing the lifecycle current the services used by the Configuration API.

Method Summary

Modifier and Type	Method and Description
<T> T	create(Class<T> serviceType) Factory method to create a type, hereby a new instance is created on each access.
URL	getResource(String resource, ClassLoader cl) Loads a resource from the current runtime context.
Enumeration<URL>	getResources(String resource, ClassLoader cl) Loads resources from the current runtime context.
<T> T	getService(Class<T> serviceType) Access a service singleton via its type.
<T> List<T>	getServices(Class<T> serviceType) Access a list current services, given its type.
int	ordinal()

Method Detail

ordinal

int ordinal()

Returns:

ordinal of the ServiceContext. The one with the highest ordinal will be taken.

getService

<T> T getService(Class<T> serviceType)

Access a service singleton via its type. If multiple implementations for the very serviceType exist then the one with the highest Priority will be used.

Type Parameters:

T - the type of the service type.

Parameters:

serviceType - the service type.

Returns:

The instance to be used, or null

Throws:

ConfigException - if there are multiple service implementations with the maximum priority.

create

<T> T create(Class<T> serviceType)

Factory method to create a type, hereby a new instance is created on each access. If multiple implementations for the very serviceType exist then the one with the highest Priority will be used as the base for creating subsequent instances.

Type Parameters:

T - the type of the service type.

Parameters:

serviceType - the service type.

Returns:

The new instance to be used, or null

Throws:

ConfigException - if there are multiple service implementations with the maximum priority.

getServices

<T> List<T> getServices(Class<T> serviceType)

Access a list current services, given its type. The bootstrap mechanism should order the instance for precedence, hereby the most significant should be first in order.

Type Parameters:

T - the type of the list element returned by this method

Parameters:

serviceType - the service type.

Returns:

The instance to be used, never null

getResources

Enumeration<URL> getResources(String resource,
                              ClassLoader cl)
                       throws IOException

Loads resources from the current runtime context. This method allows to use runtime specific code to load resources, e.g. within OSGI environments.

Parameters:

resource - the resource, not null.

cl - the desired classloader context, if null, the current thread context classloader is used.

Returns:

the resources found

Throws:

IOException

getResource

URL getResource(String resource,
                ClassLoader cl)

Loads a resource from the current runtime context. This method allows to use runtime specific code to load a resource, e.g. within OSGI environments.

Parameters:

resource - the resource, not null.

cl - the desired classloader context, if null, the current thread context classloader is used.

Returns:

the resource found, or null.

Throws:

IOException