eu.aschuetz.nativeutils.api

Interface NativeMethod<R,D>

Type Parameters:

R - return type

D - declaring type (instance type or declaring class if static)

public interface NativeMethod<R,D>

Interface for a java method referenced by native code. Note that any incompatible calls (for example calling a static void method with CallVoidMethod will lead to a IllegalArgumentException) If a method throws an exception then the thrown exception is propagated as is even tho none of the "Call" Methods declare any checked exceptions. This essentially hides checked exceptions from the caller. The caller has to ensure that checked exceptions are caught by catching "Exception" or "Throwable". The "invoke" will wrap any Throwable thrown into a InvocationTargetException just like Reflection does.

Method Summary

Modifier and Type	Method and Description
R	CallAnyMethod(D instance, Object... args) This method behaves like Method.invoke(Object, Object...) but hides the exception type from the caller.
boolean	CallBooleanMethod(D instance, Object... args) Call a non-static method that returns a boolean.
byte	CallByteMethod(D instance, Object... args) Call a non-static method that returns a byte.
char	CallCharMethod(D instance, Object... args) Call a non-static method that returns a char.
void	CallConstructor(D instance, Object... args) Special method to call a constructor of an already existing object.
double	CallDoubleMethod(D instance, Object... args) Call a non-static method that returns a double.
float	CallFloatMethod(D instance, Object... args) Call a non-static method that returns a float.
int	CallIntMethod(D instance, Object... args) Call a non-static method that returns a int.
long	CallLongMethod(D instance, Object... args) Call a non-static method that returns a long.
R	CallObjectMethod(D instance, Object... args) Call a non-static method that returns a Object.
short	CallShortMethod(D instance, Object... args) Call a non-static method that returns a short.
boolean	CallStaticBooleanMethod(Object... args) Call a static method that returns a boolean.
byte	CallStaticByteMethod(Object... args) Call a static method that returns a byte.
char	CallStaticCharMethod(Object... args) Call a static method that returns a char.
double	CallStaticDoubleMethod(Object... args) Call a static method that returns a double.
float	CallStaticFloatMethod(Object... args) Call a static method that returns a float.
int	CallStaticIntMethod(Object... args) Call a static method that returns a int.
long	CallStaticLongMethod(Object... args) Call a static method that returns a long.
R	CallStaticObjectMethod(Object... args) Call a static method that returns a object.
short	CallStaticShortMethod(Object... args) Call a static method that returns a short.
void	CallStaticVoidMethod(Object... args) Call a static void method.
void	CallVoidMethod(D instance, Object... args) Call a non-static void method
Class<D>	getDeclaringClass() returns the class/interface the method is declared in.
String	getName() Name of the method
Class[]	getParameterTypes() Method parameter.
Class<R>	getReturnType() gets the return type or "void.class" if the method is a void method.
R	invoke(D instance, Object... args) This method behaves like Method.invoke(Object, Object...)
boolean	isConstructor() returns true if the method refers to a constructor.
boolean	isPrimitiveMethod() returns true if the method returns a primitive type (byte, char, short, int, long, float, double)
boolean	isStatic() is the method static?
boolean	isVoidMethod() returns true if the method is a void method.

Method Detail

getName

String getName()

Name of the method

getParameterTypes

Class[] getParameterTypes()

Method parameter. The array is not a copy for performance reasons. Do not mutate the array or the JVM may crash upon the next call.

isStatic

boolean isStatic()

is the method static?

getDeclaringClass

Class<D> getDeclaringClass()

returns the class/interface the method is declared in.

getReturnType

Class<R> getReturnType()

gets the return type or "void.class" if the method is a void method. This never returns null.

isVoidMethod

boolean isVoidMethod()

returns true if the method is a void method.

isPrimitiveMethod

boolean isPrimitiveMethod()

returns true if the method returns a primitive type (byte, char, short, int, long, float, double)

isConstructor

boolean isConstructor()

returns true if the method refers to a constructor.

invoke

R invoke(D instance,
         Object... args)
  throws InvocationTargetException

This method behaves like Method.invoke(Object, Object...)

Throws:

InvocationTargetException

CallAnyMethod

R CallAnyMethod(D instance,
                Object... args)

This method behaves like Method.invoke(Object, Object...) but hides the exception type from the caller.

CallConstructor

void CallConstructor(D instance,
                     Object... args)

Special method to call a constructor of an already existing object. instance MUST NOT BE NULL, may be created by JVMNativeUtil.AllocObject(java.lang.Class<T>) or can be used to recall the constructor of an object.

CallObjectMethod

R CallObjectMethod(D instance,
                   Object... args)

Call a non-static method that returns a Object.

CallVoidMethod

void CallVoidMethod(D instance,
                    Object... args)

Call a non-static void method

CallLongMethod

long CallLongMethod(D instance,
                    Object... args)

Call a non-static method that returns a long.

CallIntMethod

int CallIntMethod(D instance,
                  Object... args)

Call a non-static method that returns a int.

CallShortMethod

short CallShortMethod(D instance,
                      Object... args)

Call a non-static method that returns a short.

CallByteMethod

byte CallByteMethod(D instance,
                    Object... args)

Call a non-static method that returns a byte.

CallCharMethod

char CallCharMethod(D instance,
                    Object... args)

Call a non-static method that returns a char.

CallBooleanMethod

boolean CallBooleanMethod(D instance,
                          Object... args)

Call a non-static method that returns a boolean.

CallFloatMethod

float CallFloatMethod(D instance,
                      Object... args)

Call a non-static method that returns a float.

CallDoubleMethod

double CallDoubleMethod(D instance,
                        Object... args)

Call a non-static method that returns a double.

CallStaticObjectMethod

R CallStaticObjectMethod(Object... args)

Call a static method that returns a object.

CallStaticVoidMethod

void CallStaticVoidMethod(Object... args)

Call a static void method.

CallStaticLongMethod

long CallStaticLongMethod(Object... args)

Call a static method that returns a long.

CallStaticIntMethod

int CallStaticIntMethod(Object... args)

Call a static method that returns a int.

CallStaticShortMethod

short CallStaticShortMethod(Object... args)

Call a static method that returns a short.

CallStaticByteMethod

byte CallStaticByteMethod(Object... args)

Call a static method that returns a byte.

CallStaticCharMethod

char CallStaticCharMethod(Object... args)

Call a static method that returns a char.

CallStaticBooleanMethod

boolean CallStaticBooleanMethod(Object... args)

Call a static method that returns a boolean.

CallStaticFloatMethod

float CallStaticFloatMethod(Object... args)

Call a static method that returns a float.

CallStaticDoubleMethod

double CallStaticDoubleMethod(Object... args)

Call a static method that returns a double.