rescuecore2.misc.java

Class JavaTools

java.lang.Object

rescuecore2.misc.java.JavaTools

public final class JavaTools
extends java.lang.Object

A set of useful functions related to the Java language.

Method Summary

Modifier and Type	Method and Description
static <T> T	instantiate(java.lang.String className, java.lang.Class<T> outputClass) Instantiate a class by reflection.
static <T> T	instantiateFactory(java.lang.String classname, java.lang.Class<T> outputClass) Instantiate a factory class by reflection.

Methods inherited from class java.lang.Object

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

Method Detail

instantiate

public static <T> T instantiate(java.lang.String className,
                                java.lang.Class<T> outputClass)

Instantiate a class by reflection. This method will not throw exceptions but will return null on error.

Type Parameters:

T - The desired return type.

Parameters:

className - The class name to instantiate.

outputClass - The class that specifies the type that should be returned. This will usually be a superclass of the given class name.

Returns:

A new instance of the given class name cast as the output class, or null if the class cannot be instantiated.

instantiateFactory

public static <T> T instantiateFactory(java.lang.String classname,
                                       java.lang.Class<T> outputClass)

Instantiate a factory class by reflection. Essentially the same as instantiate(String, Class) except that it will look for a static field called INSTANCE that contains an instance of the right class. If this doesn't exist (or in inaccessable or the wrong type) then a constructor will be used.

Type Parameters:

T - The desired return type.

Parameters:

classname - The class name to instantiate.

outputClass - The class that specifies the type that should be returned. This will usually be a superclass of the given class name.

Returns:

The content of the INSTANCE field if it exists; a new instance of the given class name cast as the output class, or null if the class cannot be instantiated.