ej.components.dependencyinjection

Class CompositeServiceLoader

java.lang.Object

ej.components.dependencyinjection.CompositeServiceLoader

All Implemented Interfaces:

ServiceLoader, ServiceProvider

public class CompositeServiceLoader
extends Object
implements ServiceLoader

A composite service loader contains a list a service loaders. It searches the requested services in its children sequentially respecting the order they are added.

Constructor Summary

Constructors

Constructor and Description
CompositeServiceLoader() Creates a new empty composite service loader.

Method Summary

Modifier and Type	Method and Description
void	addServiceLoader(ServiceLoader serviceLoader) Adds a service loader at the end of the list a service loaders used by this composite service loader.
<T> T	getService(Class<T> service) Gets the instance of the given service.
<T> T	getService(Class<T> service, boolean singleton) Gets the registered implementation for the given service.
<T> T	getService(Class<T> service, Class<? extends T> defaultImplementation) Gets the registered implementation for the given service.
<T> T	getService(Class<T> service, Class<? extends T> defaultImplementation, boolean singleton) Gets the registered implementation for the given service.

Methods inherited from class java.lang.Object

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

Constructor Detail

CompositeServiceLoader

public CompositeServiceLoader()

Creates a new empty composite service loader.

Method Detail

addServiceLoader

public void addServiceLoader(ServiceLoader serviceLoader)

Adds a service loader at the end of the list a service loaders used by this composite service loader.

Parameters:

serviceLoader - the service loader to add.

Throws:

NullPointerException - if the given service loader is null.

getService

@Nullable
public <T> T getService(Class<T> service)

Description copied from interface: ServiceLoader

Gets the instance of the given service.

Equivalent to calling ServiceLoader.getService(Class, boolean) passing @{code true} as @{code singleton}.

Specified by:

getService in interface ServiceLoader

Specified by:

getService in interface ServiceProvider

Type Parameters:

T - the service type.

Parameters:

service - the service.

Returns:

the instance of the given service.

getService

@Nullable
public <T> T getService(Class<T> service,
                                   boolean singleton)

Description copied from interface: ServiceLoader

Gets the registered implementation for the given service.

If a singleton is asked and if an instance of this service has already been created, this instance is returned. Otherwise, creates a new instance of the implementation type.

Specified by:

getService in interface ServiceLoader

Type Parameters:

T - the service type.

Parameters:

service - the service.

singleton - if true returns an already created instance if any, creates a new one otherwise.

Returns:

an instance of the given service or null if no implementation is available.

getService

public <T> T getService(Class<T> service,
                        Class<? extends T> defaultImplementation)

Description copied from interface: ServiceLoader

Gets the registered implementation for the given service. If there is no registered implementation, an instance of the default implementation is returned.

Specified by:

getService in interface ServiceLoader

Type Parameters:

T - the service type.

Parameters:

service - the service.

defaultImplementation - the default implementation to use.

Returns:

the instance of the given service.

getService

public <T> T getService(Class<T> service,
                        Class<? extends T> defaultImplementation,
                        boolean singleton)

Description copied from interface: ServiceLoader

Gets the registered implementation for the given service. If there is no registered implementation, an instance of the default implementation is returned.

If a singleton is asked and if an instance of this service has already been created, this instance is returned. Otherwise, creates a new instance of the implementation type.

Specified by:

getService in interface ServiceLoader

Type Parameters:

T - the service type.

Parameters:

service - the service.

defaultImplementation - the default implementation to use.

singleton - if true returns an already created instance if any, creates a new one otherwise.

Returns:

an instance of the given service.