at.ipsquare.commons.core.util

Class Classes

java.lang.Object

at.ipsquare.commons.core.util.Classes

public final class Classes
extends Object

Utility methods around Class.

Since:

2.1.0

Author:

Matthias Langer

Method Summary

Methods

Modifier and Type	Method and Description
static Class<?>	forName(String name) A version of Class.forName(String) that uses the ClassLoaders obtained by ClassLoaders.get().
static Class<?>	forName(String name, boolean initialize) A version of Class.forName(String, boolean, ClassLoader) that uses the ClassLoaders obtained by ClassLoaders.get().
static <T> Class<? extends T>	forName(String name, boolean initialize, Class<T> type) An enhanced version of forName(String, boolean) that makes sure that the returned class extends the given type.
static <T> Class<? extends T>	forName(String name, Class<T> type) An enhanced version of forName(String) that makes sure that the returned class extends the given type.

Methods inherited from class java.lang.Object

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

Method Detail

forName

public static Class<?> forName(String name,
               boolean initialize)
                        throws ClassNotFoundException

A version of Class.forName(String, boolean, ClassLoader) that uses the ClassLoaders obtained by ClassLoaders.get().

This method iterates through the ClassLoaders returned by ClassLoaders.get() and tries to load the desired class.

Parameters:

name - the fully qualified name of the desired class.

initialize - whether the class must be initialized.

Returns:

the desired class.

Throws:

ClassNotFoundException - if the specified class could not be located by any loader returned by ClassLoaders.get()

forName

public static Class<?> forName(String name)
                        throws ClassNotFoundException

A version of Class.forName(String) that uses the ClassLoaders obtained by ClassLoaders.get().

Calling this method is equivalent to:

Classes.forName(name, true)

Throws:

ClassNotFoundException

See Also:

forName(String, boolean)

forName

public static <T> Class<? extends T> forName(String name,
                             Class<T> type)
                                  throws ClassNotFoundException

An enhanced version of forName(String) that makes sure that the returned class extends the given type.

Calling this method is equivalent to:

Classes.forName(name, true, type)

Throws:

ClassNotFoundException

forName

public static <T> Class<? extends T> forName(String name,
                             boolean initialize,
                             Class<T> type)
                                  throws ClassNotFoundException

An enhanced version of forName(String, boolean) that makes sure that the returned class extends the given type.

Parameters:

name - the fully qualified name of the desired class.

initialize - whether the class must be initialized.

type - the type the returned class is expected to extend.

Returns:

the desired class.

Throws:

ClassNotFoundException - if the specified class could not be located by any loader returned by ClassLoaders.get().

ClassCastException - if the desired class could be loaded, but does not extend the given type.