org.astonbitecode.j4rs.api

Interface Instance<T>

All Superinterfaces:

JsonValue, ObjectValue

All Known Implementing Classes:

EagerJsonInvocationImpl, InvocationArg, JsonInvocationImpl

public interface Instance<T>
extends ObjectValue, JsonValue

Method Summary

Modifier and Type	Method and Description
static <T> Instance	cast(Instance from, String toClass) Casts a the object that is contained in a Instance to an object of class clazz.
static <T> Instance	cloneInstance(Instance from) Clones a Instance
Instance	field(String fieldName) Retrieves the instance held under the Field fieldName
void	initializeCallbackChannel(long channelAddress) Initialize a callback channel for this Instance.
Instance	invoke(String methodName, InvocationArg... args) Invokes a method of the instance of the class that is set for this Instance
void	invokeAsync(long functionPointerAddress, String methodName, InvocationArg... args) Invokes asynchronously a method of the instance of the class that is set for this Instance.
Instance	invokeStatic(String methodName, InvocationArg... args) Invokes a static method of the class that is set for this Instance
void	invokeToChannel(long channelAddress, String methodName, InvocationArg... args) Invokes a method of the instance of the class that is set for this Instance.

Methods inherited from interface org.astonbitecode.j4rs.api.JsonValue

getJson

Methods inherited from interface org.astonbitecode.j4rs.api.ObjectValue

getObject, getObjectClass

Method Detail

invoke

Instance invoke(String methodName,
                InvocationArg... args)

Invokes a method of the instance of the class that is set for this Instance

Parameters:

methodName - The method name

args - The arguments to use for invoking the method

Returns:

A Instance instance containing the result of the invocation

invokeStatic

Instance invokeStatic(String methodName,
                      InvocationArg... args)

Invokes a static method of the class that is set for this Instance

Parameters:

methodName - The static method name

args - The arguments to use for invoking the static method

Returns:

A Instance instance containing the result of the invocation

invokeAsync

void invokeAsync(long functionPointerAddress,
                 String methodName,
                 InvocationArg... args)

Invokes asynchronously a method of the instance of the class that is set for this Instance. The result of the invocation should be provided later using the performCallback method of a NativeCallbackSupport class. Any possible returned objects from the actual synchronous invocation of the defined method will be dropped.

Parameters:

functionPointerAddress - The address of the function pointer that will be used later in the native side in order to actually paerform the callback.

methodName - The method name

args - The arguments to use when invoking the callback method (the functionPointer)

invokeToChannel

void invokeToChannel(long channelAddress,
                     String methodName,
                     InvocationArg... args)

Invokes a method of the instance of the class that is set for this Instance. The result of the invocation should be provided later using the doCallback method of a NativeCallbackToRustChannelSupport class. Any possible returned objects from the actual synchronous invocation of the defined method will be dropped.

Parameters:

channelAddress - The memory address of the channel

methodName - The method name

args - The arguments

initializeCallbackChannel

void initializeCallbackChannel(long channelAddress)

Initialize a callback channel for this Instance. The channel can be used by Java to send values to Rust using the doCallback method of a NativeCallbackToRustChannelSupport class.

Parameters:

channelAddress - The memory address of the channel

field

Instance field(String fieldName)

Retrieves the instance held under the Field fieldName

Parameters:

fieldName - The name of the field to retrieve

Returns:

A Instance instance containing the defined field.

cast

static <T> Instance cast(Instance from,
                         String toClass)

Casts a the object that is contained in a Instance to an object of class clazz.

Type Parameters:

T - Generically defined return type

Parameters:

from - The Instance to cast.

toClass - The class that the provided Instance should be casted to

Returns:

A Instance instance containing the result of the cast.

cloneInstance

static <T> Instance cloneInstance(Instance from)

Clones a Instance

Type Parameters:

T - Generically defined return type

Parameters:

from - The object to clone.

Returns:

a Instance instance.