top.wavelength.betterreflection

Class BetterReflectionClass<T>

java.lang.Object

top.wavelength.betterreflection.BetterReflectionClass<T>

Direct Known Subclasses:

EnumBetterReflectionClass

public class BetterReflectionClass<T>
extends Object

Field Summary

Fields

Modifier and Type	Field and Description
protected BetterReflectionClass<?>	betterReflectionSuperClass
protected String	canonicalName
protected Class<T>	clasz
protected Constructor<?>[]	constructors
protected Constructor<?>[]	declaredConstructors
protected Field[]	declaredFields
protected Method[]	declaredMethods
protected Field[]	fields
protected boolean	isEnum This variable represents whether the class is an enumeration.
protected JarFile	jar Null until getJar() is invoked, then a mirror of BetterReflectionUtils.getCurrentJar(BetterReflectionClass)
protected File	jarFile Null until getJarFile() is invoked, then a mirror of BetterReflectionUtils.getCurrentJarFile(BetterReflectionClass)
protected Method[]	methods
protected String	name
protected String	packageName
protected ProtectionDomain	protectionDomain
protected Boolean	runningFromJar Null until isRunningFromJar() is invoked, then a mirror of BetterReflectionUtils.isRunningFromJar(BetterReflectionClass)
protected String	simpleName
protected Class<?>	superClass
protected String	typeName

Constructor Summary

Constructors

Constructor and Description
BetterReflectionClass(BetterReflectionClass<T> clasz)
BetterReflectionClass(Class<T> clasz)
BetterReflectionClass(String className)

Method Summary

Modifier and Type	Method and Description
T	allocateUnsafeInstance() Allocates an unsafe instance of the class.
<U> Class<? extends U>	asSubclass(Class<U> clasz)
Object	cast(Object object)
void	dumpMethodHeaders() Write the all the method headers into stout
void	dumpMethodHeaders(boolean includeModifiers) Write the all the method headers into stout
void	dumpMethodHeaders(boolean includeModifiers, boolean includeReturnType) Write the all the method headers into stout
void	dumpMethodHeaders(boolean includeModifiers, boolean includeReturnType, boolean includeParameterNames) Write the all the method headers into stout
static BetterReflectionClass<?>	forName(String name)
static BetterReflectionClass<?>	forNameAsArray(String name)
Object	getArray(Object... content)
Class<T[]>	getArrayClass()
Class<?>	getArrayClassIf(boolean condition)
BetterReflectionClass<T[]>	getBetterReflectionArrayClass()
BetterReflectionClass<?>	getBetterReflectionSuperClass()
String	getCanonicalName()
Class<T>	getClasz()
Constructor<?>	getConstructor(Class<?>... parameterTypes)
Constructor<?>	getConstructor(Object... parameterTypes)
Constructor<?>[]	getConstructors()
Constructor<?>	getDeclaredConstructor(Class<?>... parameterTypes)
Constructor<?>	getDeclaredConstructor(Object... parameterTypes)
Constructor<?>[]	getDeclaredConstructors()
Field	getDeclaredField(String name)
Field[]	getDeclaredFields()
Object	getDeclaredFieldValue(Object instance, String fieldName)
Method	getDeclaredMethod(String name, Class<?>... parameterTypes)
Method	getDeclaredMethod(String name, Object... parameterTypes)
Method[]	getDeclaredMethods()
Field	getField(String name)
Field[]	getFields()
JarFile	getJar()
File	getJarFile()
Method	getMethod(String name, Class<?>... parameterTypes)
Method	getMethod(String name, Object... parameterTypes)
Method[]	getMethods()
String	getName()
String	getPackageName()
ProtectionDomain	getProtectionDomain()
String	getSimpleName()
Class<?>	getSuperclass()
String	getTypeName()
Object	invokeDeclaredMethod(Object instance, String methodName, Object... parameters)
Object	invokeMethod(Object instance, String methodName, Object... parameters)
void	invokeMethods(Map<String,Object[]> methods, Object instance)
boolean	isAssignableFrom(BetterReflectionClass<?> clasz)
boolean	isAssignableFrom(Class<?> clasz)
boolean	isEnum()
boolean	isEnumWrapped()
boolean	isInstance(Object object)
boolean	isRunningFromJar()
T	newInstance()

Methods inherited from class java.lang.Object

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

Field Detail

name

protected final String name

Since:

0.6

simpleName

protected final String simpleName

Since:

0.6

canonicalName

protected final String canonicalName

Since:

0.6

typeName

protected final String typeName

Since:

0.6

packageName

protected final String packageName

clasz

protected final Class<T> clasz

declaredFields

protected final Field[] declaredFields

fields

protected final Field[] fields

declaredConstructors

protected final Constructor<?>[] declaredConstructors

constructors

protected final Constructor<?>[] constructors

declaredMethods

protected final Method[] declaredMethods

methods

protected final Method[] methods

protectionDomain

protected final ProtectionDomain protectionDomain

Since:

0.7

superClass

protected final Class<?> superClass

Since:

0.6

betterReflectionSuperClass

protected BetterReflectionClass<?> betterReflectionSuperClass

Since:

0.7

isEnum

protected final boolean isEnum

This variable represents whether the class is an enumeration.

Since:

1.1

runningFromJar

protected Boolean runningFromJar

Null until isRunningFromJar() is invoked, then a mirror of BetterReflectionUtils.isRunningFromJar(BetterReflectionClass)

Since:

0.7

jar

protected JarFile jar

Null until getJar() is invoked, then a mirror of BetterReflectionUtils.getCurrentJar(BetterReflectionClass)

Since:

0.7

jarFile

protected File jarFile

Null until getJarFile() is invoked, then a mirror of BetterReflectionUtils.getCurrentJarFile(BetterReflectionClass)

Since:

0.7

Constructor Detail

BetterReflectionClass

public BetterReflectionClass(String className)
                      throws ClassNotFoundException

Throws:

ClassNotFoundException

BetterReflectionClass

public BetterReflectionClass(BetterReflectionClass<T> clasz)

Parameters:

clasz - the class to wrap

Since:

0.7

BetterReflectionClass

public BetterReflectionClass(Class<T> clasz)

Method Detail

forName

public static BetterReflectionClass<?> forName(String name)

Parameters:

name - the class' name

Returns:

a new instance of BetterReflectionClass(String), but if a ClassNotFoundException is thrown it will return null

Since:

0.4

forNameAsArray

public static BetterReflectionClass<?> forNameAsArray(String name)

Parameters:

name - the class' name

Returns:

a BetterReflectionClass wrapping the class' Array. Null if the class is not found.

Since:

0.7

getClasz

public Class<T> getClasz()

getName

public String getName()

Returns:

the class' name

Since:

0.4

getSimpleName

public String getSimpleName()

Returns:

the class' Simple Name (Class.getSimpleName())

Since:

0.4

getCanonicalName

public String getCanonicalName()

Returns:

the class' Canonical Name (Class.getCanonicalName())

Since:

0.4

getTypeName

public String getTypeName()

Returns:

the class' Type Name (Class.getTypeName())

Since:

0.4

getDeclaredField

public Field getDeclaredField(String name)

getDeclaredFields

public Field[] getDeclaredFields()

getField

public Field getField(String name)

getFields

public Field[] getFields()

getDeclaredConstructor

public Constructor<?> getDeclaredConstructor(Object... parameterTypes)

Parameters:

parameterTypes - this should be populated ONLY by BetterReflectionClass instances and Classes. Nothing else!

Returns:

a constructor from its parameter types

getDeclaredConstructor

public Constructor<?> getDeclaredConstructor(Class<?>... parameterTypes)

getDeclaredConstructors

public Constructor<?>[] getDeclaredConstructors()

getConstructor

public Constructor<?> getConstructor(Object... parameterTypes)

Parameters:

parameterTypes - this should be populated ONLY by BetterReflectionClass instances and Classes. Nothing else!

Returns:

a constructor from its parameter types

getConstructor

public Constructor<?> getConstructor(Class<?>... parameterTypes)

getConstructors

public Constructor<?>[] getConstructors()

getDeclaredMethod

public Method getDeclaredMethod(String name,
                                Object... parameterTypes)

Parameters:

name - The method's name

parameterTypes - this should be populated ONLY by BetterReflectionClass instances and Classes. Nothing else!

Returns:

a method from its name and parameter types

getDeclaredMethod

public Method getDeclaredMethod(String name,
                                Class<?>... parameterTypes)

getDeclaredMethods

public Method[] getDeclaredMethods()

getMethod

public Method getMethod(String name,
                        Object... parameterTypes)

Parameters:

name - The method's name

parameterTypes - this should be populated ONLY by BetterReflectionClass instances and Classes. Nothing else!

Returns:

a method from its name and parameter types

getMethod

public Method getMethod(String name,
                        Class<?>... parameterTypes)

getMethods

public Method[] getMethods()

getProtectionDomain

public ProtectionDomain getProtectionDomain()

newInstance

public T newInstance()
              throws InstantiationException,
                     IllegalAccessException

Throws:

InstantiationException

IllegalAccessException

cast

public Object cast(Object object)

invokeMethods

public void invokeMethods(Map<String,Object[]> methods,
                          Object instance)
                   throws IllegalAccessException,
                          IllegalArgumentException,
                          InvocationTargetException

Throws:

IllegalAccessException

IllegalArgumentException

InvocationTargetException

isInstance

public boolean isInstance(Object object)

asSubclass

public <U> Class<? extends U> asSubclass(Class<U> clasz)

getArrayClass

public Class<T[]> getArrayClass()

getBetterReflectionArrayClass

public BetterReflectionClass<T[]> getBetterReflectionArrayClass()

getArrayClassIf

public Class<?> getArrayClassIf(boolean condition)

Parameters:

condition - the condition to be met to return an array of the class

Returns:

an array of clasz if condition is true, clasz otherwise

getArray

public Object getArray(Object... content)

getDeclaredFieldValue

public Object getDeclaredFieldValue(Object instance,
                                    String fieldName)
                             throws IllegalAccessException

Throws:

IllegalAccessException

invokeMethod

public Object invokeMethod(Object instance,
                           String methodName,
                           Object... parameters)
                    throws InvocationTargetException,
                           IllegalAccessException

Throws:

InvocationTargetException

IllegalAccessException

invokeDeclaredMethod

public Object invokeDeclaredMethod(Object instance,
                                   String methodName,
                                   Object... parameters)
                            throws InvocationTargetException,
                                   IllegalAccessException

Throws:

InvocationTargetException

IllegalAccessException

getPackageName

public String getPackageName()

getSuperclass

public Class<?> getSuperclass()

Returns:

The class' Super Class (Class.getSuperclass())

Since:

0.6

getBetterReflectionSuperClass

public BetterReflectionClass<?> getBetterReflectionSuperClass()

Returns:

getSuperclass() as BetterReflectionClass

Since:

0.7

isRunningFromJar

public boolean isRunningFromJar()

Returns:

whether this class has been loaded from a jar file

Since:

0.7

getJar

public JarFile getJar()

Returns:

the jar this class has been loaded from

Since:

0.7

getJarFile

public File getJarFile()

Returns:

the jar file this class has been loaded from

Since:

0.7

isAssignableFrom

public boolean isAssignableFrom(Class<?> clasz)

isAssignableFrom

public boolean isAssignableFrom(BetterReflectionClass<?> clasz)

dumpMethodHeaders

public void dumpMethodHeaders()

Write the all the method headers into stout

Since:

0.7

dumpMethodHeaders

public void dumpMethodHeaders(boolean includeModifiers)

Write the all the method headers into stout

Parameters:

includeModifiers - whether the method's modifiers should be dumped

Since:

0.7

dumpMethodHeaders

public void dumpMethodHeaders(boolean includeModifiers,
                              boolean includeReturnType)

Write the all the method headers into stout

Parameters:

includeModifiers - whether the method's modifiers should be dumped

includeReturnType - whether the method's return type should be dumped

Since:

0.7

dumpMethodHeaders

public void dumpMethodHeaders(boolean includeModifiers,
                              boolean includeReturnType,
                              boolean includeParameterNames)

Write the all the method headers into stout

Parameters:

includeModifiers - whether the method's modifiers should be dumped

includeReturnType - whether the method's return type should be dumped

includeParameterNames - whether the method's parameter names should be dumped

Since:

0.7

allocateUnsafeInstance

public T allocateUnsafeInstance()
                         throws IllegalAccessException,
                                InstantiationException

Allocates an unsafe instance of the class.

Returns:

an instance of the class

Throws:

IllegalAccessException - if the class is not accessible

InstantiationException - if the class is abstract, an interface, an array class, a primitive type, or void;

isEnum

public boolean isEnum()

isEnumWrapped

public boolean isEnumWrapped()