org.tentackle.common

Class ServiceFactory

java.lang.Object

org.tentackle.common.ServiceFactory

public class ServiceFactory
extends Object

Factory for services based on ServiceFinder.
This is the only factory that cannot be replaced by a @Service-annotation.

Author:

harald

Method Summary

Modifier and Type	Method and Description
static <T> T	createService(Class<T> serviceClass) Utility method to create a service instance. This is the standard way to instantiate singletons.
static <T> T	createService(Class<T> serviceClass, Class<? extends T> defaultClass) Utility method to create a service instance with a default if not found.
static <T> Class<T>	createServiceClass(Class<T> serviceClass) Utility method to create a service instance. This is the standard way to instantiate singletons.
static ServiceFinder	getServiceFinder() Gets a service finder. If the finder does not exist yet, it will be created.
static ServiceFinder	getServiceFinder(ClassLoader loader, String servicePath) Gets a service finder for a given classloader and service path. If the finder does not exist yet, it will be created.
static ServiceFinder	getServiceFinder(String servicePath) Gets a service finder for a given service path. If the finder does not exist yet, it will be created.

Methods inherited from class java.lang.Object

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

Method Detail

getServiceFinder

public static ServiceFinder getServiceFinder(ClassLoader loader,
                                             String servicePath)

Gets a service finder for a given classloader and service path.
If the finder does not exist yet, it will be created.

Parameters:

loader - the classloader

servicePath - the service path prefix

Returns:

the finder

getServiceFinder

public static ServiceFinder getServiceFinder(String servicePath)

Gets a service finder for a given service path.
If the finder does not exist yet, it will be created. The classloader used is Thread.currentThread().getContextClassLoader().

Parameters:

servicePath - the service path prefix

Returns:

the finder

getServiceFinder

public static ServiceFinder getServiceFinder()

Gets a service finder.
If the finder does not exist yet, it will be created. The classloader used is Thread.currentThread().getContextClassLoader() and the service path is "META_INF/services/".

Returns:

the finder

createServiceClass

public static <T> Class<T> createServiceClass(Class<T> serviceClass)

Utility method to create a service instance.
This is the standard way to instantiate singletons. Finds the first service implementation along the classpath.

Type Parameters:

T - the service type

Parameters:

serviceClass - the service class

Returns:

an instance of the service

createService

public static <T> T createService(Class<T> serviceClass)

Utility method to create a service instance.
This is the standard way to instantiate singletons. Finds the first service implementation along the classpath.

Type Parameters:

T - the service type

Parameters:

serviceClass - the service class

Returns:

an instance of the service

createService

public static <T> T createService(Class<T> serviceClass,
                                  Class<? extends T> defaultClass)

Utility method to create a service instance with a default if not found.

Type Parameters:

T - the service type

Parameters:

serviceClass - the service class

defaultClass - the default class if no service found

Returns:

an instance of the service