eu.aschuetz.nativeutils.api

Interface NativeField<T,F>

Type Parameters:

T - Type where the field is declared in

F - Type of the field.

public interface NativeField<T,F>

This interface is a wrapper for all field access methods from the jni interface. It is not a good idea to expose the jfieldID directly to any java application because calling the wrong jni method directly will crash the entire jvm without any real way of finding out why. The impl of this interface is always a reference to a specific field and does any necesarry checks before calling the J́NI methods to prevent a JVM crash. Expect to get: IllegalStateException when calling the wrong method (for the wrong field type). ClassCastException when calling with wrong objects. NullPointerException when trying to get a non static field with null instance.

Method Summary

Modifier and Type	Method and Description
F	get(T instance) This method automatically calls the correct get method but does autoboxing.
boolean	GetBooleanField(T instance)
byte	GetByteField(T instance)
char	GetCharField(T instance)
Class<T>	getDeclaringClass() Returns the class the field is in.
double	GetDoubleField(T instance)
float	GetFloatField(T instance)
int	GetIntField(T instance)
long	GetLongField(T instance)
String	getName() field name
F	GetObjectField(T instance) Does NOT do autoboxing.
short	GetShortField(T instance)
boolean	GetStaticBooleanField()
byte	GetStaticByteField()
char	GetStaticCharField()
double	GetStaticDoubleField()
float	GetStaticFloatField()
int	GetStaticIntField()
long	GetStaticLongField()
F	GetStaticObjectField() Does NOT do autoboxing.
short	GetStaticShortField()
Class<F>	getType() Returns the type of the class the field is in.
boolean	isPrimitive() is the field primitive?
boolean	isStatic() is the field static?
void	set(T instance, F value) This method automatically calls the correct set method but does autoboxing.
void	SetBooleanField(T instance, boolean value)
void	SetByteField(T instance, byte value)
void	SetCharField(T instance, char value)
void	SetDoubleField(T instance, double value)
void	SetFloatField(T instance, float value)
void	SetIntField(T instance, int value)
void	SetLongField(T instance, long value)
void	SetObjectField(T instance, F value) Does NOT do autoboxing.
void	SetShortField(T instance, short value)
void	SetStaticBooleanField(boolean value)
void	SetStaticByteField(byte value)
void	SetStaticCharField(char value)
void	SetStaticDoubleField(double value)
void	SetStaticFloatField(float value)
void	SetStaticIntField(int value)
void	SetStaticLongField(long value)
void	SetStaticObjectField(T value) Does NOT do autoboxing.
void	SetStaticShortField(short value)

Method Detail

getDeclaringClass

Class<T> getDeclaringClass()

Returns the class the field is in.

getType

Class<F> getType()

Returns the type of the class the field is in.

isStatic

boolean isStatic()

is the field static?

isPrimitive

boolean isPrimitive()

is the field primitive?

getName

String getName()

field name

get

F get(T instance)

This method automatically calls the correct get method but does autoboxing. For static fields instance parameter is completely ignored. This method does autoboxing of primitives

set

void set(T instance,
         F value)

This method automatically calls the correct set method but does autoboxing. For static fields instance parameter is completely ignored. This method does autoboxing

Throws:

NullPointerException - if the field a primitive and value is null

GetObjectField

F GetObjectField(T instance)

Does NOT do autoboxing. Will fail with IllegalStateException if for example called with to get "int".

GetStaticObjectField

F GetStaticObjectField()

Does NOT do autoboxing. Will fail with IllegalStateException if for example called with to get "int".

GetIntField

int GetIntField(T instance)

GetStaticIntField

int GetStaticIntField()

GetLongField

long GetLongField(T instance)

GetStaticLongField

long GetStaticLongField()

GetDoubleField

double GetDoubleField(T instance)

GetStaticDoubleField

double GetStaticDoubleField()

GetFloatField

float GetFloatField(T instance)

GetStaticFloatField

float GetStaticFloatField()

GetShortField

short GetShortField(T instance)

GetStaticShortField

short GetStaticShortField()

GetCharField

char GetCharField(T instance)

GetStaticCharField

char GetStaticCharField()

GetByteField

byte GetByteField(T instance)

GetStaticByteField

byte GetStaticByteField()

GetBooleanField

boolean GetBooleanField(T instance)

GetStaticBooleanField

boolean GetStaticBooleanField()

SetObjectField

void SetObjectField(T instance,
                    F value)

Does NOT do autoboxing. Will fail with IllegalStateException if for example called with Integer to set "int".

SetStaticObjectField

void SetStaticObjectField(T value)

Does NOT do autoboxing. Will fail with IllegalStateException if for example called with Integer to set "int".

SetIntField

void SetIntField(T instance,
                 int value)

SetStaticIntField

void SetStaticIntField(int value)

SetLongField

void SetLongField(T instance,
                  long value)

SetStaticLongField

void SetStaticLongField(long value)

SetDoubleField

void SetDoubleField(T instance,
                    double value)

SetStaticDoubleField

void SetStaticDoubleField(double value)

SetFloatField

void SetFloatField(T instance,
                   float value)

SetStaticFloatField

void SetStaticFloatField(float value)

SetShortField

void SetShortField(T instance,
                   short value)

SetStaticShortField

void SetStaticShortField(short value)

SetCharField

void SetCharField(T instance,
                  char value)

SetStaticCharField

void SetStaticCharField(char value)

SetByteField

void SetByteField(T instance,
                  byte value)

SetStaticByteField

void SetStaticByteField(byte value)

SetBooleanField

void SetBooleanField(T instance,
                     boolean value)

SetStaticBooleanField

void SetStaticBooleanField(boolean value)