net.lenni0451.reflect

Class Fields

java.lang.Object

net.lenni0451.reflect.Fields

public class Fields
extends java.lang.Object

This class contains some useful methods for working with fields.

Constructor Summary

Constructors

Constructor and Description
Fields()

Method Summary

Modifier and Type	Method and Description
static <T> void	copy(java.lang.Object instance, java.lang.Object target, java.lang.reflect.Field field) Copy the value of the field from one instance to another.
static void	copyBoolean(java.lang.Object instance, java.lang.Object target, java.lang.reflect.Field field) Copy the boolean value of the field from one instance to another.
static void	copyByte(java.lang.Object instance, java.lang.Object target, java.lang.reflect.Field field) Copy the byte value of the field from one instance to another.
static void	copyChar(java.lang.Object instance, java.lang.Object target, java.lang.reflect.Field field) Copy the char value of the field from one instance to another.
static void	copyDouble(java.lang.Object instance, java.lang.Object target, java.lang.reflect.Field field) Copy the double value of the field from one instance to another.
static void	copyFloat(java.lang.Object instance, java.lang.Object target, java.lang.reflect.Field field) Copy the float value of the field from one instance to another.
static void	copyInt(java.lang.Object instance, java.lang.Object target, java.lang.reflect.Field field) Copy the int value of the field from one instance to another.
static void	copyLong(java.lang.Object instance, java.lang.Object target, java.lang.reflect.Field field) Copy the long value of the field from one instance to another.
static void	copyObject(java.lang.Object instance, java.lang.Object target, java.lang.reflect.Field field) Copy the value of the field from one instance to another.
static void	copyShort(java.lang.Object instance, java.lang.Object target, java.lang.reflect.Field field) Copy the short value of the field from one instance to another.
static <T> T	get(java.lang.Object instance, java.lang.reflect.Field field) Get the value of a field.
static boolean	getBoolean(java.lang.Object instance, java.lang.reflect.Field field) Get the boolean value of a field.
static byte	getByte(java.lang.Object instance, java.lang.reflect.Field field) Get the byte value of a field.
static char	getChar(java.lang.Object instance, java.lang.reflect.Field field) Get the char value of a field.
static java.lang.reflect.Field	getDeclaredField(java.lang.Class<?> clazz, java.lang.String name) Get a declared field of a class by its name.
static java.lang.reflect.Field[]	getDeclaredFields(java.lang.Class<?> clazz) Get all declared fields of a class.
static double	getDouble(java.lang.Object instance, java.lang.reflect.Field field) Get the double value of a field.
static float	getFloat(java.lang.Object instance, java.lang.reflect.Field field) Get the float value of a field.
static int	getInt(java.lang.Object instance, java.lang.reflect.Field field) Get the int value of a field.
static long	getLong(java.lang.Object instance, java.lang.reflect.Field field) Get the long value of a field.
static <T> T	getObject(java.lang.Object instance, java.lang.reflect.Field field) Get the value of a field.
static short	getShort(java.lang.Object instance, java.lang.reflect.Field field) Get the short value of a field.
static java.lang.Object	instance(java.lang.Object instance, java.lang.reflect.Field field) Get the instance used for getting/setting the value of the field using unsafe.
static long	offset(java.lang.reflect.Field field) Get the offset of a field required for getting/setting the value of the field using unsafe.
static <T> void	set(java.lang.Object instance, java.lang.reflect.Field field, T value) Set the value of a field.
static void	setBoolean(java.lang.Object instance, java.lang.reflect.Field field, boolean value) Set the boolean value of a field.
static void	setByte(java.lang.Object instance, java.lang.reflect.Field field, byte value) Set the byte value of a field.
static void	setChar(java.lang.Object instance, java.lang.reflect.Field field, char value) Set the char value of a field.
static void	setDouble(java.lang.Object instance, java.lang.reflect.Field field, double value) Get the double value of a field.
static void	setFloat(java.lang.Object instance, java.lang.reflect.Field field, float value) Set the float value of a field.
static void	setInt(java.lang.Object instance, java.lang.reflect.Field field, int value) Set the int value of a field.
static void	setLong(java.lang.Object instance, java.lang.reflect.Field field, long value) Set the long value of a field.
static void	setObject(java.lang.Object instance, java.lang.reflect.Field field, java.lang.Object value) Set the value of a field.
static void	setShort(java.lang.Object instance, java.lang.reflect.Field field, short value) Set the short value of a field.

Methods inherited from class java.lang.Object

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

Constructor Detail

Fields

public Fields()

Method Detail

offset

public static long offset(java.lang.reflect.Field field)

Get the offset of a field required for getting/setting the value of the field using unsafe.
This method automatically chooses between static and virtual fields.

Parameters:

field - The field to get the offset of

Returns:

The offset of the field

instance

public static java.lang.Object instance(java.lang.Object instance,
                                        java.lang.reflect.Field field)

Get the instance used for getting/setting the value of the field using unsafe.
Only exists to make the below code smaller.

Parameters:

instance - The instance or null if the field is static

field - The field

Returns:

The instance if virtual, otherwise the declaring class of the field

getDeclaredFields

public static java.lang.reflect.Field[] getDeclaredFields(java.lang.Class<?> clazz)

Get all declared fields of a class.
The reflection filter of the class will be ignored.
An empty array will be returned if the method could not be invoked.

Parameters:

clazz - The class to get the fields from

Returns:

An array of all declared fields of the class

Throws:

MethodNotFoundException - If the Class internal getDeclaredFields0 method could not be found

getDeclaredField

@Nullable
public static java.lang.reflect.Field getDeclaredField(java.lang.Class<?> clazz,
                                                                  java.lang.String name)

Get a declared field of a class by its name.
The reflection filter of the class will be ignored.

Parameters:

clazz - The class to get the field of

name - The name of the field

Returns:

The field or null if it doesn't exist

getBoolean

public static boolean getBoolean(java.lang.Object instance,
                                 java.lang.reflect.Field field)

Get the boolean value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance or null if the field is static

field - The field to get the value of

Returns:

The value of the field

setBoolean

public static void setBoolean(java.lang.Object instance,
                              java.lang.reflect.Field field,
                              boolean value)

Set the boolean value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance or null if the field is static

field - The field to set the value of

value - The value to set

copyBoolean

public static void copyBoolean(java.lang.Object instance,
                               java.lang.Object target,
                               java.lang.reflect.Field field)

Copy the boolean value of the field from one instance to another.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance to copy the value from

target - The instance to copy the value to

field - The field to copy the value of

getByte

public static byte getByte(java.lang.Object instance,
                           java.lang.reflect.Field field)

Get the byte value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance or null if the field is static

field - The field to get the value of

Returns:

The value of the field

setByte

public static void setByte(java.lang.Object instance,
                           java.lang.reflect.Field field,
                           byte value)

Set the byte value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance or null if the field is static

field - The field to set the value of

value - The value to set

copyByte

public static void copyByte(java.lang.Object instance,
                            java.lang.Object target,
                            java.lang.reflect.Field field)

Copy the byte value of the field from one instance to another.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance to copy the value from

target - The instance to copy the value to

field - The field to copy the value of

getShort

public static short getShort(java.lang.Object instance,
                             java.lang.reflect.Field field)

Get the short value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance or null if the field is static

field - The field to get the value of

Returns:

The value of the field

setShort

public static void setShort(java.lang.Object instance,
                            java.lang.reflect.Field field,
                            short value)

Set the short value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance or null if the field is static

field - The field to set the value of

value - The value to set

copyShort

public static void copyShort(java.lang.Object instance,
                             java.lang.Object target,
                             java.lang.reflect.Field field)

Copy the short value of the field from one instance to another.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance to copy the value from

target - The instance to copy the value to

field - The field to copy the value of

getChar

public static char getChar(java.lang.Object instance,
                           java.lang.reflect.Field field)

Get the char value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance or null if the field is static

field - The field to get the value of

Returns:

The value of the field

setChar

public static void setChar(java.lang.Object instance,
                           java.lang.reflect.Field field,
                           char value)

Set the char value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance or null if the field is static

field - The field to set the value of

value - The value to set

copyChar

public static void copyChar(java.lang.Object instance,
                            java.lang.Object target,
                            java.lang.reflect.Field field)

Copy the char value of the field from one instance to another.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance to copy the value from

target - The instance to copy the value to

field - The field to copy the value of

getInt

public static int getInt(java.lang.Object instance,
                         java.lang.reflect.Field field)

Get the int value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance or null if the field is static

field - The field to get the value of

Returns:

The value of the field

setInt

public static void setInt(java.lang.Object instance,
                          java.lang.reflect.Field field,
                          int value)

Set the int value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance or null if the field is static

field - The field to set the value of

value - The value to set

copyInt

public static void copyInt(java.lang.Object instance,
                           java.lang.Object target,
                           java.lang.reflect.Field field)

Copy the int value of the field from one instance to another.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance to copy the value from

target - The instance to copy the value to

field - The field to copy the value of

getLong

public static long getLong(java.lang.Object instance,
                           java.lang.reflect.Field field)

Get the long value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance or null if the field is static

field - The field to get the value of

Returns:

The value of the field

setLong

public static void setLong(java.lang.Object instance,
                           java.lang.reflect.Field field,
                           long value)

Set the long value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance or null if the field is static

field - The field to set the value of

value - The value to set

copyLong

public static void copyLong(java.lang.Object instance,
                            java.lang.Object target,
                            java.lang.reflect.Field field)

Copy the long value of the field from one instance to another.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance to copy the value from

target - The instance to copy the value to

field - The field to copy the value of

getFloat

public static float getFloat(java.lang.Object instance,
                             java.lang.reflect.Field field)

Get the float value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance or null if the field is static

field - The field to get the value of

Returns:

The value of the field

setFloat

public static void setFloat(java.lang.Object instance,
                            java.lang.reflect.Field field,
                            float value)

Set the float value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance or null if the field is static

field - The field to set the value of

value - The value to set

copyFloat

public static void copyFloat(java.lang.Object instance,
                             java.lang.Object target,
                             java.lang.reflect.Field field)

Copy the float value of the field from one instance to another.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance to copy the value from

target - The instance to copy the value to

field - The field to copy the value of

getDouble

public static double getDouble(java.lang.Object instance,
                               java.lang.reflect.Field field)

Get the double value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance or null if the field is static

field - The field to get the value of

Returns:

The value of the field

setDouble

public static void setDouble(java.lang.Object instance,
                             java.lang.reflect.Field field,
                             double value)

Get the double value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance or null if the field is static

field - The field to get the value of

value - The value to set

copyDouble

public static void copyDouble(java.lang.Object instance,
                              java.lang.Object target,
                              java.lang.reflect.Field field)

Copy the double value of the field from one instance to another.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.

Parameters:

instance - The instance to copy the value from

target - The instance to copy the value to

field - The field to copy the value of

getObject

public static <T> T getObject(java.lang.Object instance,
                              java.lang.reflect.Field field)

Get the value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.
Do not use for primitive types!

Type Parameters:

T - The type of the field

Parameters:

instance - The instance or null if the field is static

field - The field to get the value of

Returns:

The value of the field

setObject

public static void setObject(java.lang.Object instance,
                             java.lang.reflect.Field field,
                             java.lang.Object value)

Set the value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.
Do not use for primitive types!

Parameters:

instance - The instance or null if the field is static

field - The field to set the value of

value - The value to set

copyObject

public static void copyObject(java.lang.Object instance,
                              java.lang.Object target,
                              java.lang.reflect.Field field)

Copy the value of the field from one instance to another.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.
Do not use for primitive types!

Parameters:

instance - The instance to copy the value from

target - The instance to copy the value to

field - The field to copy the value of

get

public static <T> T get(java.lang.Object instance,
                        java.lang.reflect.Field field)

Get the value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.
If the field is a primitive type, the corresponding wrapper class is returned.

Type Parameters:

T - The type of the field

Parameters:

instance - The instance or null if the field is static

field - The field to get the value of

Returns:

The value of the field

set

public static <T> void set(java.lang.Object instance,
                           java.lang.reflect.Field field,
                           T value)

Set the value of a field.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.
If the field is a primitive type, the corresponding wrapper class is expected.

Type Parameters:

T - The type of the field

Parameters:

instance - The instance or null if the field is static

field - The field to set the value of

value - The value to set

copy

public static <T> void copy(java.lang.Object instance,
                            java.lang.Object target,
                            java.lang.reflect.Field field)

Copy the value of the field from one instance to another.
This method automatically chooses between static and virtual fields.
The field does not have to be accessible.
If the field is a primitive type, the corresponding wrapper class is expected.

Type Parameters:

T - The type of the field

Parameters:

instance - The instance to copy the value from

target - The instance to copy the value to

field - The field to copy the value of