me.tamkungz.nilloadersdk.helper

Class ReflectHelper

java.lang.Object

me.tamkungz.nilloadersdk.helper.ReflectHelper

public final class ReflectHelper
extends java.lang.Object

ReflectHelper — utility wrapper for common reflection operations. Reduces repeated use of getField/invoke patterns across mods.

Method Summary

Modifier and Type	Method and Description
static java.util.List<java.lang.Object>	collectFieldValuesByType(java.lang.Object target, java.lang.Class<?> assignableFrom, boolean skipStatic) Collects field values whose type is assignable to the given class.
static java.lang.reflect.Field	findField(java.lang.Class<?> type, java.lang.String name)
static java.lang.Object	findFieldByClassHint(java.lang.Object target, java.lang.String... hints) Finds a field value whose type matches any of the given class name hints.
static boolean	getBooleanField(java.lang.Object target, java.lang.String name)
static double	getDoubleField(java.lang.Object target, java.lang.String name)
static double	getDoubleFieldSafe(java.lang.Object target, java.lang.String name)
static java.lang.Object	getField(java.lang.Object target, java.lang.String name) Gets a field value from an object (searches superclass hierarchy).
static java.lang.Object	getFieldSafe(java.lang.Object target, java.lang.String name) Safe field access — returns null on error.
static float	getFloatField(java.lang.Object target, java.lang.String name)
static int	getIntField(java.lang.Object target, java.lang.String name)
static int	getIntFieldSafe(java.lang.Object target, java.lang.String name, int fallback)
static java.lang.Object	invoke(java.lang.Object target, java.lang.String name, java.lang.Object... args) Invokes a method on the target object using varargs.
static java.lang.Object	invokeSafe(java.lang.Object target, java.lang.String name, java.lang.Object... args) Safe method invocation — returns null on error.
static boolean	isInstanceOf(java.lang.Object obj, java.lang.String... classNames) Checks if the object is an instance of any given class names (including superclass hierarchy).
static void	setBooleanField(java.lang.Object target, java.lang.String name, boolean value)
static void	setField(java.lang.Object target, java.lang.String name, java.lang.Object value)
static void	setFieldMulti(java.lang.Object target, java.lang.Object value, java.lang.String... names) Attempts to set a field using multiple possible names.
static void	setIntField(java.lang.Object target, java.lang.String name, int value)
static void	setIntFieldMulti(java.lang.Object target, int value, java.lang.String... names)

Methods inherited from class java.lang.Object

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

Method Detail

getField

public static java.lang.Object getField(java.lang.Object target,
                                        java.lang.String name)
                                 throws java.lang.Exception

Gets a field value from an object (searches superclass hierarchy).

Throws:

java.lang.Exception

getIntField

public static int getIntField(java.lang.Object target,
                              java.lang.String name)
                       throws java.lang.Exception

Throws:

java.lang.Exception

getDoubleField

public static double getDoubleField(java.lang.Object target,
                                    java.lang.String name)
                             throws java.lang.Exception

Throws:

java.lang.Exception

getFloatField

public static float getFloatField(java.lang.Object target,
                                  java.lang.String name)
                           throws java.lang.Exception

Throws:

java.lang.Exception

getBooleanField

public static boolean getBooleanField(java.lang.Object target,
                                      java.lang.String name)
                               throws java.lang.Exception

Throws:

java.lang.Exception

getFieldSafe

public static java.lang.Object getFieldSafe(java.lang.Object target,
                                            java.lang.String name)

Safe field access — returns null on error.

getIntFieldSafe

public static int getIntFieldSafe(java.lang.Object target,
                                  java.lang.String name,
                                  int fallback)

getDoubleFieldSafe

public static double getDoubleFieldSafe(java.lang.Object target,
                                        java.lang.String name)

setField

public static void setField(java.lang.Object target,
                            java.lang.String name,
                            java.lang.Object value)
                     throws java.lang.Exception

Throws:

java.lang.Exception

setIntField

public static void setIntField(java.lang.Object target,
                               java.lang.String name,
                               int value)
                        throws java.lang.Exception

Throws:

java.lang.Exception

setBooleanField

public static void setBooleanField(java.lang.Object target,
                                   java.lang.String name,
                                   boolean value)
                            throws java.lang.Exception

Throws:

java.lang.Exception

setFieldMulti

public static void setFieldMulti(java.lang.Object target,
                                 java.lang.Object value,
                                 java.lang.String... names)

Attempts to set a field using multiple possible names. Useful for handling obfuscated field name variations.

setIntFieldMulti

public static void setIntFieldMulti(java.lang.Object target,
                                    int value,
                                    java.lang.String... names)

invoke

public static java.lang.Object invoke(java.lang.Object target,
                                      java.lang.String name,
                                      java.lang.Object... args)
                               throws java.lang.Exception

Invokes a method on the target object using varargs. Matches by method name and parameter count.

Throws:

java.lang.Exception

invokeSafe

public static java.lang.Object invokeSafe(java.lang.Object target,
                                          java.lang.String name,
                                          java.lang.Object... args)

Safe method invocation — returns null on error.

isInstanceOf

public static boolean isInstanceOf(java.lang.Object obj,
                                   java.lang.String... classNames)

Checks if the object is an instance of any given class names (including superclass hierarchy). Useful for obfuscated class names (e.g. "qx" = EntityPlayer).

findFieldByClassHint

public static java.lang.Object findFieldByClassHint(java.lang.Object target,
                                                    java.lang.String... hints)

Finds a field value whose type matches any of the given class name hints.

collectFieldValuesByType

public static java.util.List<java.lang.Object> collectFieldValuesByType(java.lang.Object target,
                                                                        java.lang.Class<?> assignableFrom,
                                                                        boolean skipStatic)

Collects field values whose type is assignable to the given class.

findField

public static java.lang.reflect.Field findField(java.lang.Class<?> type,
                                                java.lang.String name)
                                         throws java.lang.NoSuchFieldException

Throws:

java.lang.NoSuchFieldException