nl.nn.adapterframework.util

Class ClassUtils

java.lang.Object

nl.nn.adapterframework.util.ClassUtils

public abstract class ClassUtils
extends Object

A collection of class management utility methods.

Author:

Johan Verrips

Constructor Summary

Constructors

Constructor and Description
ClassUtils()

Method Summary

Modifier and Type	Method and Description
static String	classNameOf(Object o) returns the className of the object, like nameOf(Object), but without [name] suffix for a INamedObject.
static String	debugObject(Object o)
static List<String>	getAllowedProtocols()
static Map<String,Object>	getClassInfo(Class clazz, ClassLoader classLoader)
static List<Object>	getClassInfoList(Class<?> clazz)
static String	getCleanedFilePath(String path) clean up file path, to replace websphere specific classpath references with generic ones.
static Constructor<?>	getConstructorOnType(Class<?> clas, Class<?>[] parameterTypes) Retrieves the constructor of a class, based on the parameters
static Object	getDeclaredFieldValue(Object o, Class<?> c, String name)
static Object	getDeclaredFieldValue(Object o, String name)
static Object	getFieldValue(Object o, Class<?> c, String name)
static Object	getFieldValue(Object o, String name)
static Object	getFieldValueSafe(Object o, String name)
static URL	getResourceURL(IScopeProvider scopeProvider, String resource) Get a resource-URL from a specific IConfigurationClassLoader.
static URL	getResourceURL(IScopeProvider scopeProvider, String resource, String allowedProtocols) Get a resource-URL from a ClassLoader, therefore the resource should not start with a leading slash
static URL	getResourceURL(String resource) Get a resource-URL directly from the ClassPath
static Object	invokeGetter(Object o, String name)
static Object	invokeGetter(Object o, String name, boolean forceAccess)
static Object	invokeGetterSafe(Object o, String name, boolean forceAccess)
static void	invokeSetter(Object bean, Method method, String valueToSet)
static void	invokeSetter(Object o, String name, Object value)
static void	invokeSetter(Object o, String name, Object value, Class<?> clazz)
static String	invokeStringGetter(Object o, String name)
static String	invokeStringGetterSafe(Object o, String name)
static long	lastModified(Class<?> aClass) Determine the last modification date for this class file or its enclosing library
static Class<?>	loadClass(String className) Load a class given its name.
static String	nameOf(ClassLoader classLoader) If the classLoader is derivable of IConfigurationClassLoader return the className + configurationName, else return the className of the object.
static String	nameOf(Object o) returns the className of the object, without the package name.
static Object	newInstance(String className) Create a new instance given a class name.
static Reader	urlToReader(URL url)
static Reader	urlToReader(URL url, int timeoutMs)
static InputStream	urlToStream(URL url, int timeoutMs)
static String	which(Class<?> aClass) Gets the absolute pathname of the class file containing the specified class name, as prescribed by the current classpath.

Methods inherited from class java.lang.Object

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

Constructor Detail

ClassUtils

public ClassUtils()

Method Detail

getConstructorOnType

public static Constructor<?> getConstructorOnType(Class<?> clas,
                                                  Class<?>[] parameterTypes)
                                           throws NoSuchMethodException

Retrieves the constructor of a class, based on the parameters

Throws:

NoSuchMethodException

getResourceURL

public static URL getResourceURL(String resource)

Get a resource-URL directly from the ClassPath

Parameters:

resource - name of the resource you are trying to fetch the URL from

Returns:

URL of the resource or null if it can't be not found

getResourceURL

public static URL getResourceURL(IScopeProvider scopeProvider,
                                 String resource)

Get a resource-URL from a specific IConfigurationClassLoader. This should be used by classes which are part of the Ibis configuration (like pipes and senders) because the configuration might be loaded from outside the webapp ClassPath. Hence the Thread.currentThread().getContextClassLoader() at the time the class was instantiated should be used.

See Also:

IbisContext.init()

getResourceURL

public static URL getResourceURL(IScopeProvider scopeProvider,
                                 String resource,
                                 String allowedProtocols)

Get a resource-URL from a ClassLoader, therefore the resource should not start with a leading slash

Parameters:

scopeProvider - to retrieve the file from, or NULL when you want to retrieve the resource directly from the ClassPath (using an absolute path)

resource - name of the resource you are trying to fetch the URL from

Returns:

URL of the resource or null if it can't be not found

getAllowedProtocols

public static List<String> getAllowedProtocols()

urlToStream

public static InputStream urlToStream(URL url,
                                      int timeoutMs)
                               throws IOException

Throws:

IOException

urlToReader

public static Reader urlToReader(URL url)
                          throws IOException

Throws:

IOException

urlToReader

public static Reader urlToReader(URL url,
                                 int timeoutMs)
                          throws IOException

Throws:

IOException

lastModified

public static long lastModified(Class<?> aClass)
                         throws IllegalArgumentException

Determine the last modification date for this class file or its enclosing library

Parameters:

aClass - A class whose last modification date is queried

Returns:

The time the given class was last modified

Throws:

IllegalArgumentException - The class was not loaded from a file or directory

newInstance

public static Object newInstance(String className)
                          throws Exception

Create a new instance given a class name. The constructor of the class does NOT have parameters.

Parameters:

className - A class name

Returns:

A new instance

Throws:

Exception - If an instantiation error occurs

loadClass

public static Class<?> loadClass(String className)
                          throws ClassNotFoundException

Load a class given its name. BL: We wan't to use a known ClassLoader--hopefully the hierarchy is set correctly.

Parameters:

className - A class name

Returns:

The class pointed to by className

Throws:

ClassNotFoundException - If a loading error occurs

which

public static String which(Class<?> aClass)

Gets the absolute pathname of the class file containing the specified class name, as prescribed by the current classpath.

nameOf

public static String nameOf(ClassLoader classLoader)

If the classLoader is derivable of IConfigurationClassLoader return the className + configurationName, else return the className of the object. Don't return the package name to avoid cluttering the logs.

nameOf

public static String nameOf(Object o)

returns the className of the object, without the package name.

classNameOf

public static String classNameOf(Object o)

returns the className of the object, like nameOf(Object), but without [name] suffix for a INamedObject.

invokeSetter

public static void invokeSetter(Object bean,
                                Method method,
                                String valueToSet)

invokeSetter

public static void invokeSetter(Object o,
                                String name,
                                Object value)
                         throws SecurityException,
                                NoSuchMethodException,
                                IllegalArgumentException,
                                IllegalAccessException,
                                InvocationTargetException

Throws:

SecurityException

NoSuchMethodException

IllegalArgumentException

IllegalAccessException

InvocationTargetException

invokeSetter

public static void invokeSetter(Object o,
                                String name,
                                Object value,
                                Class<?> clazz)
                         throws SecurityException,
                                NoSuchMethodException,
                                IllegalArgumentException,
                                IllegalAccessException,
                                InvocationTargetException

Throws:

SecurityException

NoSuchMethodException

IllegalArgumentException

IllegalAccessException

InvocationTargetException

invokeGetterSafe

public static Object invokeGetterSafe(Object o,
                                      String name,
                                      boolean forceAccess)

invokeGetter

public static Object invokeGetter(Object o,
                                  String name,
                                  boolean forceAccess)
                           throws SecurityException,
                                  NoSuchMethodException,
                                  IllegalArgumentException,
                                  IllegalAccessException,
                                  InvocationTargetException

Throws:

SecurityException

NoSuchMethodException

IllegalArgumentException

IllegalAccessException

InvocationTargetException

invokeGetter

public static Object invokeGetter(Object o,
                                  String name)
                           throws SecurityException,
                                  NoSuchMethodException,
                                  IllegalArgumentException,
                                  IllegalAccessException,
                                  InvocationTargetException

Throws:

SecurityException

NoSuchMethodException

IllegalArgumentException

IllegalAccessException

InvocationTargetException

invokeStringGetterSafe

public static String invokeStringGetterSafe(Object o,
                                            String name)

invokeStringGetter

public static String invokeStringGetter(Object o,
                                        String name)
                                 throws SecurityException,
                                        NoSuchMethodException,
                                        IllegalArgumentException,
                                        IllegalAccessException,
                                        InvocationTargetException

Throws:

SecurityException

NoSuchMethodException

IllegalArgumentException

IllegalAccessException

InvocationTargetException

getFieldValueSafe

public static Object getFieldValueSafe(Object o,
                                       String name)

getFieldValue

public static Object getFieldValue(Object o,
                                   Class<?> c,
                                   String name)
                            throws IllegalArgumentException,
                                   SecurityException,
                                   IllegalAccessException,
                                   NoSuchFieldException

Throws:

IllegalArgumentException

SecurityException

IllegalAccessException

NoSuchFieldException

getFieldValue

public static Object getFieldValue(Object o,
                                   String name)
                            throws IllegalArgumentException,
                                   SecurityException,
                                   IllegalAccessException,
                                   NoSuchFieldException

Throws:

IllegalArgumentException

SecurityException

IllegalAccessException

NoSuchFieldException

getDeclaredFieldValue

public static Object getDeclaredFieldValue(Object o,
                                           Class<?> c,
                                           String name)
                                    throws IllegalArgumentException,
                                           SecurityException,
                                           IllegalAccessException,
                                           NoSuchFieldException

Throws:

IllegalArgumentException

SecurityException

IllegalAccessException

NoSuchFieldException

getDeclaredFieldValue

public static Object getDeclaredFieldValue(Object o,
                                           String name)
                                    throws IllegalArgumentException,
                                           SecurityException,
                                           IllegalAccessException,
                                           NoSuchFieldException

Throws:

IllegalArgumentException

SecurityException

IllegalAccessException

NoSuchFieldException

debugObject

public static String debugObject(Object o)

getCleanedFilePath

public static String getCleanedFilePath(String path)

clean up file path, to replace websphere specific classpath references with generic ones.

getClassInfoList

public static List<Object> getClassInfoList(Class<?> clazz)
                                     throws IOException

Throws:

IOException

getClassInfo

public static Map<String,Object> getClassInfo(Class clazz,
                                              ClassLoader classLoader)
                                       throws IOException

Throws:

IOException