com.bigdata.util

Class ClassPathUtil

java.lang.Object

com.bigdata.util.ClassPathUtil

public class ClassPathUtil
extends Object

Utility class for returning an instance of an interface.

Author:

bryan

Constructor Summary

Constructors

Constructor and Description
ClassPathUtil()

Method Summary

Methods

Modifier and Type	Method and Description
static <T> T	classForName(String preferredClassName, Class<? extends T> defaultClass, Class<T> sharedClassOrInterface, ClassLoader classLoader) Return an instance of the shared interface.
static <T> T	classForName(String preferredClassName, Class<T> defaultClass, Class<T> sharedInterface)

Methods inherited from class java.lang.Object

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

Constructor Detail

ClassPathUtil

public ClassPathUtil()

Method Detail

classForName

public static <T> T classForName(String preferredClassName,
                 Class<T> defaultClass,
                 Class<T> sharedInterface)

classForName

public static <T> T classForName(String preferredClassName,
                 Class<? extends T> defaultClass,
                 Class<T> sharedClassOrInterface,
                 ClassLoader classLoader)

Return an instance of the shared interface. If possible, an instance of the preferred class will be used. If that class is not found or is does not extend the specified interface, then an instance of the default class will be used.

Parameters:

preferredClassName - The name of the preferred class to use. The class may need to have a zero argument public constructor in order to be instantiated by this this method.

defaultClass - The default class to use (optional). When non- null, the default class must implement the shared interface.

sharedClassOrInterface - A class or interface that the preferred class must implement if it is to be instantiated.

classLoader - The class loader to use.

Returns:

An instance of the preferred class if it can be found, implements the shared interface, and the security checks permit its instantiation -or- an instance of the default class (if given) and otherwise null.

Throws:

IllegalArgumentException - if the preferred class name is null.

IllegalArgumentException - if defaultClass is given and does not implement the shared interface.

RuntimeException - if an attempt to instantiate the default class results in a SecurityException or IllegalAccessException.