org.gradle.util

Class ServiceLocator

java.lang.Object

org.gradle.util.ServiceLocator

All Implemented Interfaces:

ServiceRegistry

public class ServiceLocator
extends java.lang.Object
implements ServiceRegistry

Uses the Jar service resource specification to locate service implementations.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ServiceLocator.ServiceFactory<T>

Constructor Summary

Constructors

Constructor and Description
ServiceLocator(java.lang.ClassLoader classLoader)

Method Summary

Methods

Modifier and Type	Method and Description
<T> ServiceLocator.ServiceFactory<T>	findFactory(java.lang.Class<T> serviceType) Locates a factory for a given service.
<T> T	get(java.lang.Class<T> serviceType) Locates the service of the given type.
<T> ServiceLocator.ServiceFactory<T>	getFactory(java.lang.Class<T> serviceType) Locates a factory which can create services of the given type.
<T> T	newInstance(java.lang.Class<T> type) Creates a new service instance of the given type.

Methods inherited from class java.lang.Object

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

Constructor Detail

ServiceLocator

public ServiceLocator(java.lang.ClassLoader classLoader)

Method Detail

get

public <T> T get(java.lang.Class<T> serviceType)
      throws UnknownServiceException

Description copied from interface: ServiceRegistry

Locates the service of the given type. There is a single instance for each service type.

Specified by:

get in interface ServiceRegistry

Type Parameters:

T - The service type.

Parameters:

serviceType - The service type.

Returns:

The service instance. Never returns null.

Throws:

UnknownServiceException - When there is no service of the given type available.

getFactory

public <T> ServiceLocator.ServiceFactory<T> getFactory(java.lang.Class<T> serviceType)
                                            throws UnknownServiceException

Description copied from interface: ServiceRegistry

Locates a factory which can create services of the given type.

Specified by:

getFactory in interface ServiceRegistry

Type Parameters:

T - The service type that the factory should create.

Parameters:

serviceType - The service type that the factory should create.

Returns:

The factory. Never returns null.

Throws:

UnknownServiceException - When there is no factory available for services of the given type.

findFactory

public <T> ServiceLocator.ServiceFactory<T> findFactory(java.lang.Class<T> serviceType)

Locates a factory for a given service. Returns null when no service implementation is available.

newInstance

public <T> T newInstance(java.lang.Class<T> type)
              throws UnknownServiceException

Description copied from interface: ServiceRegistry

Creates a new service instance of the given type.

Specified by:

newInstance in interface ServiceRegistry

Type Parameters:

T - The service type.

Parameters:

type - The service type

Returns:

The instance. Never returns null.

Throws:

UnknownServiceException - When there is no factory available for services of the given type.