org.fossnova.finder

Class FactoryFinder

java.lang.Object

org.fossnova.finder.FactoryFinder

public final class FactoryFinder
extends java.lang.Object

Factory finder utility as alternative to java.util.ServiceLoader. Its main design goal is to avoid class loader leaks. To achieve this it doesn't create any internal caches.

Author:

Richard Opalka

Method Summary

Modifier and Type	Method and Description
static <T> T	find(java.lang.Class<T> factoryIface) Instantiates a factory object given the factory's interface class.
static <T> T	find(java.lang.Class<T> factoryIface, java.lang.String fallbackImpl) Instantiates a factory object given the factory's interface class.

Methods inherited from class java.lang.Object

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

Method Detail

find

public static <T> T find(java.lang.Class<T> factoryIface)

Instantiates a factory object given the factory's interface class. First it seeks for system property -DfactoryIface=factoryImpl. If such property is not specified then factoryIface classloader is inspected whether it contains META-INF/services/factoryIface entity. If neither system property nor META-INF service is defined exception is thrown. If either system property or META-INF service is defined factoryIface classloader is used to instantiate the implementation class.

Type Parameters:

T - interface class type

Parameters:

factoryIface - required factory interface class to look implementation for

Returns:

a factory object

find

public static <T> T find(java.lang.Class<T> factoryIface,
                         java.lang.String fallbackImpl)

Instantiates a factory object given the factory's interface class. First it seeks for system property -DfactoryIface=factoryImpl. If such property is not specified then factoryIface classloader is inspected whether it contains META-INF/services/factoryIface entity. If neither system property nor META-INF service nor fallbackImpl is defined exception is thrown. If either system property or META-INF service or fallbackImpl is defined factoryIface classloader is used to instantiate the implementation class.

Type Parameters:

T - interface class type

Parameters:

factoryIface - required factory interface class to look impl. for

fallbackImpl - optional fallback factory impl. class name

Returns:

a factory object