Package de.themoep.utils

Class ReflectionUtils

java.lang.Object

de.themoep.utils.ReflectionUtils

public class ReflectionUtils
extends Object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ReflectionUtils.WrongTypeException

Constructor Summary

Constructors

Constructor	Description
ReflectionUtils(org.bukkit.plugin.java.JavaPlugin plugin)

Method Summary

Modifier and Type	Method	Description
Class<?>	getClass(String className)	Get a registered obfuscated class
Field	getField(String name)	Get a registered obfuscated field
static Method	getMethod(Class<?> c, String name, Class<?> returnType, Class<?>... args)	Get a method
Method	getMethod(String name)	Get a registered obfuscated method
Object	invoke(String name, Object object, Object... args)	Invoke a method registered with the ReflectionUtils
Class<?>	registerClass(String path)	Register a new class with the ReflectionUtils, the part after the last dot will be used as the name!
Class<?>	registerClass(String path, String className)	Register a new class with the ReflectionUtils
Field	registerField(String className, String name, Class<?> fieldType)	Register a new field with the ReflectionUtils
Method	registerMethod(String className, String methodName, Class<?> returnType, Class<?>... parameters)	Register a new method with the ReflectionUtils
Field	registerObfuscatedField(String className, String fieldName, Class<?> fieldType)	Register a new field that is obfuscated and the name may change so we use the first we find with that type
Field	registerObfuscatedField(String className, String fieldName, String obf, Class<?> fieldType)	Register a new field that is obfuscated and the name may change
Method	registerObfuscatedMethod(String className, String methodName, Class<?> returnType, Class<?>... parameters)	Register a new method which may be obfuscated so we use the first we find that matches the arguments
Method	registerObfuscatedMethod(String className, String methodName, String obf, Class<?> returnType, Class<?>... parameters)	Register a new method which may be obfuscated

Methods inherited from class java.lang.Object

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

Constructor Details

ReflectionUtils

public ReflectionUtils(org.bukkit.plugin.java.JavaPlugin plugin)

Method Details

getClass

public Class<?> getClass(String className)
                  throws ClassNotFoundException

Get a registered obfuscated class

Parameters:

className - The name of the class

Returns:

The class by that name

Throws:

ClassNotFoundException - Thrown when the class was not registered

getMethod

public Method getMethod(String name)
                 throws NoSuchMethodException

Get a registered obfuscated method

Parameters:

name - The name of the method

Returns:

The method by that name

Throws:

NoSuchMethodException - Thrown when the method was not registered

getField

public Field getField(String name)
               throws NoSuchFieldException

Get a registered obfuscated field

Parameters:

name - The name of the field

Returns:

The field by that name

Throws:

NoSuchFieldException - Thrown when the field was not registered

invoke

public Object invoke(String name,
 Object object,
 Object... args)
              throws NoSuchMethodException,
InvocationTargetException,
IllegalAccessException

Invoke a method registered with the ReflectionUtils

Parameters:

name - The name of the method registered. Eg. Class.method

object - The object to invoke the method on

args - Optional arguments

Returns:

The return of the method, null if it is void

Throws:

NoSuchMethodException - Thrown when the field isn't found

InvocationTargetException - Thrown when you aren't allowed to invoke that method

IllegalAccessException - Thrown when you aren't allowed to access that method

registerClass

public Class<?> registerClass(String path)
                       throws ClassNotFoundException

Register a new class with the ReflectionUtils, the part after the last dot will be used as the name!

Parameters:

path - The path to the class including the name

Returns:

The registered class

Throws:

ClassNotFoundException - Thrown when the class isn't found

registerClass

public Class<?> registerClass(String path,
 String className)
                       throws ClassNotFoundException

Register a new class with the ReflectionUtils

Parameters:

path - The path to the class including the name

className - The name of the class you want to use in in the getClass() method

Returns:

The registered class

Throws:

ClassNotFoundException - Thrown when the class isn't found

registerMethod

public Method registerMethod(String className,
 String methodName,
 Class<?> returnType,
 Class<?>... parameters)
                      throws ClassNotFoundException,
NoSuchMethodException,
ReflectionUtils.WrongTypeException

Register a new method with the ReflectionUtils

Parameters:

className - The name of the class as registered before

methodName - The name of the method

returnType - The return type of this method

parameters - Optional parameters of the method

Returns:

The registered method

Throws:

ClassNotFoundException - Thrown when the class isn't found

NoSuchMethodException - Thrown when the field isn't found

ReflectionUtils.WrongTypeException - Thrown when the method doesn't return that type

registerObfuscatedMethod

public Method registerObfuscatedMethod(String className,
 String methodName,
 Class<?> returnType,
 Class<?>... parameters)
                                throws ClassNotFoundException,
NoSuchMethodException

Register a new method which may be obfuscated so we use the first we find that matches the arguments

Parameters:

className - The name of the class as registered before

methodName - The name of the method

returnType - The return type of this method

parameters - Optional parameters of the method

Returns:

The registered method

Throws:

ClassNotFoundException - Thrown when the class isn't found

NoSuchMethodException - Thrown when the method isn't found

registerObfuscatedMethod

public Method registerObfuscatedMethod(String className,
 String methodName,
 String obf,
 Class<?> returnType,
 Class<?>... parameters)
                                throws ClassNotFoundException,
NoSuchMethodException

Register a new method which may be obfuscated

Parameters:

className - The name of the class as registered before

methodName - The name of the method

obf - If we have multiple methods that match, which one should we use?

returnType - The return type of this method

parameters - Optional parameters of the method

Returns:

The registered method

Throws:

ClassNotFoundException - Thrown when the class isn't found

NoSuchMethodException - Thrown when the method isn't found

registerField

public Field registerField(String className,
 String name,
 Class<?> fieldType)
                    throws ClassNotFoundException,
NoSuchFieldException,
ReflectionUtils.WrongTypeException

Register a new field with the ReflectionUtils

Parameters:

className - The name of the class as registered before

name - The name of the field

fieldType - The type of the field

Returns:

The registered field

Throws:

ClassNotFoundException - Thrown when the class isn't found

NoSuchFieldException - Thrown when the field isn't found

ReflectionUtils.WrongTypeException - Thrown when the field doesn't have that type

registerObfuscatedField

public Field registerObfuscatedField(String className,
 String fieldName,
 Class<?> fieldType)
                              throws ClassNotFoundException,
NoSuchFieldException

Register a new field that is obfuscated and the name may change so we use the first we find with that type

Parameters:

className - The name of the class as registered before

fieldName - The name of the field

fieldType - The type of the field

Returns:

The registered field

Throws:

ClassNotFoundException - Thrown when the class isn't found

NoSuchFieldException - Thrown when the field wasn't found

registerObfuscatedField

public Field registerObfuscatedField(String className,
 String fieldName,
 String obf,
 Class<?> fieldType)
                              throws ClassNotFoundException,
NoSuchFieldException

Register a new field that is obfuscated and the name may change

Parameters:

className - The name of the class as registered before

fieldName - The name of the field

obf - If we have multiple fields that match, which one should we use?

fieldType - The type of the field

Returns:

The registered field

Throws:

ClassNotFoundException - Thrown when the class isn't found

NoSuchFieldException - Thrown when the field wasn't found

getMethod

public static Method getMethod(Class<?> c,
 String name,
 Class<?> returnType,
 Class<?>... args)
                        throws NoSuchMethodException,
ReflectionUtils.WrongTypeException

Get a method

Parameters:

c - The class

name - The method name

returnType - The return type

args - The method arguments

Returns:

The method

Throws:

NoSuchMethodException - Thrown when there is no such method

ReflectionUtils.WrongTypeException - Thrown when the method doesn't return that type