Package nonapi.io.github.classgraph.reflection

Class NarcissusReflectionDriver

java.lang.Object

nonapi.io.github.classgraph.reflection.ReflectionDriver

nonapi.io.github.classgraph.reflection.NarcissusReflectionDriver

class NarcissusReflectionDriver
extends ReflectionDriver

Narcissus reflection driver (uses the Narcissus library, if it is available, which allows access to non-public fields and methods, circumventing encapsulation and visibility controls via JNI).

Nested Class Summary

Nested classes/interfaces inherited from class nonapi.io.github.classgraph.reflection.ReflectionDriver

ReflectionDriver.ClassMemberCache

Field Summary

Fields

Modifier and Type	Field	Description
private final Method	findClass
private final Method	getDeclaredConstructors
private final Method	getDeclaredFields
private final Method	getDeclaredMethods
private final Method	getField
private final Method	getStaticField
private final Method	invokeMethod
private final Method	invokeStaticMethod
private final Class<?>	narcissusClass
private final Method	setField
private final Method	setStaticField

Constructor Summary

Constructors

Constructor	Description
NarcissusReflectionDriver()

Method Summary

Modifier and Type	Method	Description
(package private) Class<?>	findClass(String className)	Find a class by name.
(package private) <T> Constructor<T>[]	getDeclaredConstructors(Class<T> cls)	Get declared constructors for class.
(package private) Field[]	getDeclaredFields(Class<?> cls)	Get declared fields for class.
(package private) Method[]	getDeclaredMethods(Class<?> cls)	Get declared methods for class.
(package private) Object	getField(Object object, Field field)	Get the value of a non-static field, boxing the value if necessary.
(package private) Object	getStaticField(Field field)	Get the value of a static field, boxing the value if necessary.
(package private) Object	invokeMethod(Object object, Method method, Object... args)	Invoke a non-static method, boxing the result if necessary.
(package private) Object	invokeStaticMethod(Method method, Object... args)	Invoke a static method, boxing the result if necessary.
boolean	isAccessible(Object instance, AccessibleObject obj)	Check whether a field or method is accessible.
boolean	makeAccessible(Object instance, AccessibleObject accessibleObject)	Make a field or method accessible.
(package private) void	setField(Object object, Field field, Object value)	Set the value of a non-static field, unboxing the value if necessary.
(package private) void	setStaticField(Field field, Object value)	Set the value of a static field, unboxing the value if necessary.

Methods inherited from class nonapi.io.github.classgraph.reflection.ReflectionDriver

findField, findInstanceField, findInstanceMethod, findMethod, findStaticField, findStaticMethod

Methods inherited from class java.lang.Object

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

Field Details

narcissusClass

private final Class<?> narcissusClass

getDeclaredMethods

private final Method getDeclaredMethods

findClass

private final Method findClass

getDeclaredConstructors

private final Method getDeclaredConstructors

getDeclaredFields

private final Method getDeclaredFields

getField

private final Method getField

setField

private final Method setField

getStaticField

private final Method getStaticField

setStaticField

private final Method setStaticField

invokeMethod

private final Method invokeMethod

invokeStaticMethod

private final Method invokeStaticMethod

Constructor Details

NarcissusReflectionDriver

NarcissusReflectionDriver()
                   throws Exception

Throws:

Exception

Method Details

isAccessible

public boolean isAccessible(Object instance,
 AccessibleObject obj)

Description copied from class: ReflectionDriver

Check whether a field or method is accessible.

N.B. this is overridden in Narcissus driver to just return true, since everything is accessible to JNI.

Overrides:

isAccessible in class ReflectionDriver

Parameters:

instance - the object instance, or null if static.

obj - the field or method.

Returns:

true if accessible.

makeAccessible

public boolean makeAccessible(Object instance,
 AccessibleObject accessibleObject)

Description copied from class: ReflectionDriver

Make a field or method accessible.

Specified by:

makeAccessible in class ReflectionDriver

Parameters:

instance - the object instance, or null if static.

accessibleObject - the field or method.

Returns:

true if successful.

findClass

Class<?> findClass(String className)
            throws Exception

Description copied from class: ReflectionDriver

Find a class by name.

Specified by:

findClass in class ReflectionDriver

Parameters:

className - the class name

Returns:

the class reference

Throws:

Exception

getDeclaredMethods

Method[] getDeclaredMethods(Class<?> cls)
                     throws Exception

Description copied from class: ReflectionDriver

Get declared methods for class.

Specified by:

getDeclaredMethods in class ReflectionDriver

Parameters:

cls - the class

Returns:

the declared methods

Throws:

Exception

getDeclaredConstructors

<T> Constructor<T>[] getDeclaredConstructors(Class<T> cls)
                                      throws Exception

Description copied from class: ReflectionDriver

Get declared constructors for class.

Specified by:

getDeclaredConstructors in class ReflectionDriver

Type Parameters:

T - the generic type

Parameters:

cls - the class

Returns:

the declared constructors

Throws:

Exception

getDeclaredFields

Field[] getDeclaredFields(Class<?> cls)
                   throws Exception

Description copied from class: ReflectionDriver

Get declared fields for class.

Specified by:

getDeclaredFields in class ReflectionDriver

Parameters:

cls - the class

Returns:

the declared fields

Throws:

Exception

getField

Object getField(Object object,
 Field field)
         throws Exception

Description copied from class: ReflectionDriver

Get the value of a non-static field, boxing the value if necessary.

Specified by:

getField in class ReflectionDriver

Parameters:

object - the object instance to get the field value from

field - the non-static field

Returns:

the value of the field

Throws:

Exception

setField

void setField(Object object,
 Field field,
 Object value)
       throws Exception

Description copied from class: ReflectionDriver

Set the value of a non-static field, unboxing the value if necessary.

Specified by:

setField in class ReflectionDriver

Parameters:

object - the object instance to get the field value from

field - the non-static field

value - the value to set

Throws:

Exception

getStaticField

Object getStaticField(Field field)
               throws Exception

Description copied from class: ReflectionDriver

Get the value of a static field, boxing the value if necessary.

Specified by:

getStaticField in class ReflectionDriver

Parameters:

field - the static field

Returns:

the static field

Throws:

Exception

setStaticField

void setStaticField(Field field,
 Object value)
             throws Exception

Description copied from class: ReflectionDriver

Set the value of a static field, unboxing the value if necessary.

Specified by:

setStaticField in class ReflectionDriver

Parameters:

field - the static field

value - the value to set

Throws:

Exception

invokeMethod

Object invokeMethod(Object object,
 Method method,
 Object... args)
             throws Exception

Description copied from class: ReflectionDriver

Invoke a non-static method, boxing the result if necessary.

Specified by:

invokeMethod in class ReflectionDriver

Parameters:

object - the object instance to invoke the method on

method - the non-static method

args - the method arguments (or new Object[0] if there are no args)

Returns:

the return value (possibly a boxed value)

Throws:

Exception

invokeStaticMethod

Object invokeStaticMethod(Method method,
 Object... args)
                   throws Exception

Description copied from class: ReflectionDriver

Invoke a static method, boxing the result if necessary.

Specified by:

invokeStaticMethod in class ReflectionDriver

Parameters:

method - the static method

args - the method arguments (or new Object[0] if there are no args)

Returns:

the return value (possibly a boxed value)

Throws:

Exception