net.minecraftforge.fml.common

Class ObfuscationReflectionHelper

java.lang.Object

net.minecraftforge.fml.common.ObfuscationReflectionHelper

public class ObfuscationReflectionHelper
extends java.lang.Object

Some reflection helper code. This may not work properly in Java 9 with its new, more restrictive, reflection management. As such, if issues are encountered, please report them and we can see what we can do to expand the compatibility. In other cases, AccessTransformers may be used. All field names should be passed in as SRG names, and this will automatically resolve if MCP mappings are detected.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ObfuscationReflectionHelper.UnableToAccessFieldException
static class	ObfuscationReflectionHelper.UnableToFindFieldException
static class	ObfuscationReflectionHelper.UnableToFindMethodException
static class	ObfuscationReflectionHelper.UnknownConstructorException

Constructor Summary

Constructors

Constructor and Description
ObfuscationReflectionHelper()

Method Summary

Modifier and Type	Method and Description
static <T> java.lang.reflect.Constructor<T>	findConstructor(java.lang.Class<T> klass, java.lang.Class<?>... parameterTypes) Finds a constructor in the specified class that has matching parameter types.
static java.lang.reflect.Method	findMethod(java.lang.Class<?> clazz, java.lang.String methodName, java.lang.Class<?>... parameterTypes) Finds a method with the specified name and parameters in the given class and makes it accessible.
static <T,E> T	getPrivateValue(java.lang.Class<? super E> classToAccess, E instance, int fieldIndex)
static <T,E> T	getPrivateValue(java.lang.Class<? super E> classToAccess, E instance, java.lang.String fieldName)
static java.lang.String	remapName(cpw.mods.modlauncher.api.INameMappingService.Domain domain, java.lang.String name)
static <T,E> void	setPrivateValue(java.lang.Class<? super T> classToAccess, T instance, E value, int fieldIndex)
static <T,E> void	setPrivateValue(java.lang.Class<? super T> classToAccess, T instance, E value, java.lang.String fieldName)

Methods inherited from class java.lang.Object

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

Constructor Detail

ObfuscationReflectionHelper

public ObfuscationReflectionHelper()

Method Detail

remapName

public static java.lang.String remapName(cpw.mods.modlauncher.api.INameMappingService.Domain domain,
                                         java.lang.String name)

getPrivateValue

public static <T,E> T getPrivateValue(java.lang.Class<? super E> classToAccess,
                                      E instance,
                                      int fieldIndex)

getPrivateValue

public static <T,E> T getPrivateValue(java.lang.Class<? super E> classToAccess,
                                      E instance,
                                      java.lang.String fieldName)

setPrivateValue

public static <T,E> void setPrivateValue(java.lang.Class<? super T> classToAccess,
                                         T instance,
                                         E value,
                                         int fieldIndex)

setPrivateValue

public static <T,E> void setPrivateValue(java.lang.Class<? super T> classToAccess,
                                         T instance,
                                         E value,
                                         java.lang.String fieldName)

findMethod

@Nonnull
public static java.lang.reflect.Method findMethod(@Nonnull
                                                           java.lang.Class<?> clazz,
                                                           @Nonnull
                                                           java.lang.String methodName,
                                                           java.lang.Class<?>... parameterTypes)

Finds a method with the specified name and parameters in the given class and makes it accessible. Note: For performance, store the returned value and avoid calling this repeatedly.

Throws an exception if the method is not found.

Parameters:

clazz - The class to find the method on.

methodName - The SRG (obfuscated) name of the method to find(e.g. "func_12820_D").

parameterTypes - The parameter types of the method to find.

Returns:

The method with the specified name and parameters in the given class.

findConstructor

@Nonnull
public static <T> java.lang.reflect.Constructor<T> findConstructor(@Nonnull
                                                                            java.lang.Class<T> klass,
                                                                            @Nonnull
                                                                            java.lang.Class<?>... parameterTypes)

Finds a constructor in the specified class that has matching parameter types.

Type Parameters:

T - The type

Parameters:

klass - The class to find the constructor in

parameterTypes - The parameter types of the constructor.

Returns:

The constructor

Throws:

java.lang.NullPointerException - if klass is null

java.lang.NullPointerException - if parameterTypes is null

ObfuscationReflectionHelper.UnknownConstructorException - if the constructor could not be found