jadex.commons

Class SReflect

java.lang.Object

jadex.commons.SReflect

public class SReflect
extends Object

This class provides several useful static reflection methods.

Constructor Summary

Constructors

Constructor and Description
SReflect()

Method Summary

Methods

Modifier and Type	Method and Description
static Class<?>	classForName(String name, ClassLoader classloader) Extension for Class.forName(), because primitive types are not supported.
static Class	classForName0(String name, boolean initialize, ClassLoader classloader) Extension for Class.forName(), because primitive types are not supported.
static Class	classForName0(String name, ClassLoader classloader) Extension for Class.forName(), because primitive types are not supported.
static Object	convertWrappedValue(Object value, Class clazz) Convert a value to the correct wrapped type.
static <T> Class<T>	findClass(String clname, String[] imports, ClassLoader classloader) Find a class.
static <T> Class<T>	findClass0(String clname, String[] imports, ClassLoader classloader) Find a class.
static Method[]	getAllMethods(Class clazz) Get all methods of a class including public, protected and private methods of the class and its superclasses.
static int	getAndroidVersion() Get Android API version.
static Object	getArray(Object collection) Get an array for an arbitrary collection object.
static Field	getCachedField(Class clazz, String name) Get a cached field.
static Class<?>	getClass(Type type) Get the class for a type.
static String	getClassName(Class clazz) Beautifies names of arrays (eg 'String[]' instead of '[LString;').
static Object	getDeclared(Object o, String fieldname) Get the declared object, doesnt cumulate through superclasses.
static Object	getDefaultValue(Class clazz) Get default value for basic types.
static Field	getField(Class clazz, String name) Get a field of the class, or any of it's superclasses.
static String	getInnerClassName(Class clazz) Get inner class name.
static Type	getInnerGenericType(Type type) Unwrap a generic type.
static <T> Iterator<T>	getIterator(Object collection) Get an iterator for an arbitrary collection object.
static Method	getMethod(Class clazz, String name, Class[] types) Get a method of the class.
static String	getMethodName() Get the current method name from the caller.
static Method[]	getMethods(Class clazz, String name) Get public method(s) of the class by name.
static String	getPackageName(Class clazz) Get the package of a class.
static Class[]	getSuperInterfaces(Class[] interfaces) Get the super interfaces.
static String	getUnqualifiedClassName(Class clazz) Get unqualified class name.
static String	getUnqualifiedTypeName(String name) Get unqualified type name.
static Class	getWrappedType(Class clazz) Get the wrapped type.
static boolean	hasXmlSupport() Checks wether the Platform has the necessary classes to provide XML encoding and decoding support.
static boolean	instanceOf(Object o, Class c) Is an object instanceof a class or its superclasses.
static boolean	isAndroid() Test if running on android.
static boolean	isBasicType(Class clazz) Is basic type.
static boolean	isIterable(Object obj) Test if object is some kind of collection.
static boolean	isIterableClass(Class clazz) Test if class is some kind of collection.
static boolean	isStringConvertableType(Class clazz) Test if the class is automatically convertable from/to a string.
static boolean	isSupertype(Class clazz1, Class clazz2) Check if a class is a supertype of, or the same as another class.
static int[]	matchArgumentTypes(Class[] argtypes, Class[][] paramtypes) Match the given argument types to a set of parameter type arrays.
static void	scanDir(URL[] urls, File file, IFilter filter, List<String> results, List<String> donedirs) Scan directories.
static Class<?>[]	scanForClasses(ClassLoader classloader, IFilter filefilter, IFilter classfilter) Scan for classes that fulfill certain criteria as specified by the file and classfilters.
static Class<?>[]	scanForClasses(URL[] urls, ClassLoader classloader, IFilter filefilter, IFilter classfilter) Scan for classes that fulfill certain criteria as specified by the file and classfilters.
static String[]	scanForFiles(URL[] urls, IFilter filter) Scan for files in a given list of urls.
static Class<?>	unwrapGenericType(Type type) Unwrap a generic type.
static Object	wrapValue(boolean val)
static Object	wrapValue(byte val)
static Object	wrapValue(char val)
static Object	wrapValue(double val)
static Object	wrapValue(float val)
static Object	wrapValue(int val)
static Object	wrapValue(long val)
static Object	wrapValue(Object val)
static Object	wrapValue(short val)

Methods inherited from class java.lang.Object

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

Constructor Detail

SReflect

public SReflect()

Method Detail

getWrappedType

public static Class getWrappedType(Class clazz)

Get the wrapped type. This method converts basic types such as boolean or int to the object types Boolean, Integer.

Parameters:

clazz - The basic class.

Returns:

The wrapped type, return clazz when it is no basic type.

unwrapGenericType

public static Class<?> unwrapGenericType(Type type)

Unwrap a generic type.

Parameters:

type - The generic type.

Returns:

The unwrapped class.

getInnerGenericType

public static Type getInnerGenericType(Type type)

Unwrap a generic type.

Parameters:

type - The generic type.

Returns:

The unwrapped class.

getClass

public static Class<?> getClass(Type type)

Get the class for a type.

isStringConvertableType

public static boolean isStringConvertableType(Class clazz)

Test if the class is automatically convertable from/to a string. Is valid for all basic types and their object pendants.

Parameters:

clazz - The class.

Returns:

True, if convertable.

isBasicType

public static boolean isBasicType(Class clazz)

Is basic type.

Returns:

True, if the class is a basic type.

wrapValue

public static Object wrapValue(boolean val)

wrapValue

public static Object wrapValue(int val)

wrapValue

public static Object wrapValue(long val)

wrapValue

public static Object wrapValue(byte val)

wrapValue

public static Object wrapValue(char val)

wrapValue

public static Object wrapValue(float val)

wrapValue

public static Object wrapValue(double val)

wrapValue

public static Object wrapValue(short val)

wrapValue

public static Object wrapValue(Object val)

classForName0

public static Class classForName0(String name,
                  ClassLoader classloader)

Extension for Class.forName(), because primitive types are not supported. Uses static cache to speed up lookup.

Parameters:

name - The class name.

Returns:

The class, or null if not found.

classForName0

public static Class classForName0(String name,
                  boolean initialize,
                  ClassLoader classloader)

Extension for Class.forName(), because primitive types are not supported.

Parameters:

name - The class name.

Returns:

The class, or null if not found.

classForName

public static Class<?> classForName(String name,
                    ClassLoader classloader)
                             throws ClassNotFoundException

Extension for Class.forName(), because primitive types are not supported. Uses static cache to speed up lookup.

Parameters:

name - The class name.

Returns:

The class.

Throws:

ClassNotFoundException

getClassName

public static String getClassName(Class clazz)

Beautifies names of arrays (eg 'String[]' instead of '[LString;').

Returns:

The beautified name of a class.

getUnqualifiedClassName

public static String getUnqualifiedClassName(Class clazz)

Get unqualified class name. Also beautifies names of arrays (eg 'String[]' instead of '[LString;').

Returns:

The unqualified (without package) name of a class.

getUnqualifiedTypeName

public static String getUnqualifiedTypeName(String name)

Get unqualified type name.

Returns:

The unqualified (without package) name of a class.

getInnerClassName

public static String getInnerClassName(Class clazz)

Get inner class name.

Returns:

The inner class's name (without declaring class).

getPackageName

public static String getPackageName(Class clazz)

Get the package of a class.

Returns:

The name of the package.

getField

public static Field getField(Class clazz,
             String name)

Get a field of the class, or any of it's superclasses. Unlike Class.getField(String), this will also return nonpublic fields (except when running in netscape :-( ).

Parameters:

clazz - The class to search.

name - The name of the field to search for.

Returns:

The field (or null if not found).

getCachedField

public static Field getCachedField(Class clazz,
                   String name)
                            throws NoSuchFieldException

Get a cached field.

Parameters:

clazz - The clazz.

name - The name.

Returns:

The field.

Throws:

NoSuchFieldException

getDeclared

public static Object getDeclared(Object o,
                 String fieldname)

Get the declared object, doesnt cumulate through superclasses.

Parameters:

o - The object.

fieldname - The name of the array.

getMethod

public static Method getMethod(Class clazz,
               String name,
               Class[] types)

Get a method of the class. Unlike Class.getMethod(String, Class[]), this uses the methodcache.

Parameters:

clazz - The class to search.

name - The name of the method to search for.

types - The parameter types.

Returns:

The method (or null if not found).

getMethods

public static Method[] getMethods(Class clazz,
                  String name)

Get public method(s) of the class by name.

Parameters:

clazz - The class to search.

name - The name of the method to search for.

Returns:

The method(s).

getAllMethods

public static Method[] getAllMethods(Class clazz)

Get all methods of a class including public, protected and private methods of the class and its superclasses.

findClass

public static <T> Class<T> findClass(String clname,
                     String[] imports,
                     ClassLoader classloader)
                          throws ClassNotFoundException

Find a class. When the class name is not fully qualified, the list of imported packages is searched for the class.

Parameters:

clname - The class name.

imports - The comma separated list of imported packages.

Throws:

ClassNotFoundException - when the class is not found in the imports.

findClass0

public static <T> Class<T> findClass0(String clname,
                      String[] imports,
                      ClassLoader classloader)

Find a class. Also supports basic types and arrays. When the class name is not fully qualified, the list of imported packages is searched for the class.

Parameters:

clname - The class name.

imports - The comma separated list of imported packages.

Returns:

null, when the class is not found in the imports.

matchArgumentTypes

public static int[] matchArgumentTypes(Class[] argtypes,
                       Class[][] paramtypes)

Match the given argument types to a set of parameter type arrays. The argument type array may contain null values, when an argument type is unknown. For convenience, the length of a parameter type array does not have to equal the argument array length. (although it will of course never match). The method returns the indices of the matching parameter type arrays. An empty array is returned, if no match is found. The returned matches are sorted by quality (best match first).

Parameters:

argtypes - The array of argument types.

paramtypes - The array of parameter type arrays.

Returns:

The indices of the matching parameter type arrays.

isSupertype

public static boolean isSupertype(Class clazz1,
                  Class clazz2)

Check if a class is a supertype of, or the same as another class. Maps basic types to wrapped types, and respects the basic type hierarchy.

Parameters:

clazz1 - The assumed supertype.

clazz2 - The assumed subtype.

Returns:

True, if clazz1 is a supertype of, or the same as clazz2.

convertWrappedValue

public static Object convertWrappedValue(Object value,
                         Class clazz)

Convert a value to the correct wrapped type. Assumes that the conversion is possible.

Parameters:

value - The value.

clazz - The target clazz.

Returns:

The converted value.

See Also:

isSupertype(Class, Class)

getIterator

public static <T> Iterator<T> getIterator(Object collection)

Get an iterator for an arbitrary collection object. Supports iterators, enumerations, java.util.Collections, java.util.Maps, arrays. Null is converted to empty iterator.

Parameters:

collection - The collection object.

Returns:

An iterator over the collection.

Throws:

IllegalArgumentException - when argument is not one of (Iterator, Enumeration, Collection, Map, Array).

isIterable

public static boolean isIterable(Object obj)

Test if object is some kind of collection.

Parameters:

obj - The object.

Returns:

True if is iterable.

isIterableClass

public static boolean isIterableClass(Class clazz)

Test if class is some kind of collection.

Parameters:

clazz - The class.

Returns:

True if is iterable.

getArray

public static Object getArray(Object collection)

Get an array for an arbitrary collection object. Supports iterators, enumerations, java.util.Collections, java.util.Maps, arrays. Null is converted to empty array.

Parameters:

collection - The collection object.

Returns:

An array over the collection.

Throws:

IllegalArgumentException - when argument is not one of (Iterator, Enumeration, Collection, Map, Array).

instanceOf

public static boolean instanceOf(Object o,
                 Class c)

Is an object instanceof a class or its superclasses.

Parameters:

o - The object.

c - The class.

Returns:

True, when o is instance of class c.

getSuperInterfaces

public static Class[] getSuperInterfaces(Class[] interfaces)

Get the super interfaces.

Parameters:

interfaces - The interfaces

Returns:

All super interfaces.

getDefaultValue

public static Object getDefaultValue(Class clazz)

Get default value for basic types.

getMethodName

public static String getMethodName()

Get the current method name from the caller.

Returns:

The method name.

scanForClasses

public static Class<?>[] scanForClasses(ClassLoader classloader,
                        IFilter filefilter,
                        IFilter classfilter)

Scan for classes that fulfill certain criteria as specified by the file and classfilters.

scanForClasses

public static Class<?>[] scanForClasses(URL[] urls,
                        ClassLoader classloader,
                        IFilter filefilter,
                        IFilter classfilter)

Scan for classes that fulfill certain criteria as specified by the file and classfilters.

scanForFiles

public static String[] scanForFiles(URL[] urls,
                    IFilter filter)

Scan for files in a given list of urls.

scanDir

public static void scanDir(URL[] urls,
           File file,
           IFilter filter,
           List<String> results,
           List<String> donedirs)

Scan directories.

isAndroid

public static boolean isAndroid()

Test if running on android.

getAndroidVersion

public static int getAndroidVersion()

Get Android API version. Possible values: http://developer.android.com/reference/android/os/Build.VERSION_CODES.htm

Returns:

Android API version or -1, if not running on Android

hasXmlSupport

public static boolean hasXmlSupport()

Checks wether the Platform has the necessary classes to provide XML encoding and decoding support.

Returns:

true, if platform supports xml