Package org.astonbitecode.j4rs.api.invocation

Class EagerJsonInvocationImpl<T>

java.lang.Object

org.astonbitecode.j4rs.api.invocation.EagerJsonInvocationImpl<T>

All Implemented Interfaces:

Instance<T>, JsonValue, ObjectValue

public class EagerJsonInvocationImpl<T>
extends Object
implements Instance<T>

Constructor Summary

Constructors

Constructor	Description
EagerJsonInvocationImpl(T instance, Class<T> clazz)

Method Summary

Modifier and Type	Method	Description
Instance	field(String methodName)	Retrieves the instance held under the Field fieldName
String	getJson()
T	getObject()
Class<?>	getObjectClass()
String	getObjectClassName()
void	initializeCallbackChannel(long channelAddress)	Initialize a callback channel for this Instance.
Instance	invoke(String methodName, InvocationArg... arg)	Invokes a method of the instance of the class that is set for this Instance
void	invokeAsyncToChannel(long channelAddress, 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... arg)	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 class java.lang.Object

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

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

getOrDeserializeJavaObject

Constructor Detail

EagerJsonInvocationImpl

public EagerJsonInvocationImpl(T instance,
                               Class<T> clazz)

Method Detail

invoke

public Instance invoke(String methodName,
                       InvocationArg... arg)

Description copied from interface: Instance

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

Specified by:

invoke in interface Instance<T>

Parameters:

methodName - The method name

arg - The arguments to use for invoking the method

Returns:

A Instance instance containing the result of the invocation

invokeStatic

public Instance invokeStatic(String methodName,
                             InvocationArg... arg)

Description copied from interface: Instance

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

Specified by:

invokeStatic in interface Instance<T>

Parameters:

methodName - The static method name

arg - The arguments to use for invoking the static method

Returns:

A Instance instance containing the result of the invocation

invokeAsyncToChannel

public void invokeAsyncToChannel(long channelAddress,
                                 String methodName,
                                 InvocationArg... args)

Description copied from interface: Instance

Invokes asynchronously a method of the instance of the class that is set for this Instance. The result of the invocation must be a Future. When the Future returned from the invocation completes, j4rs will invoke native Rust code to either send a success value or a failure.

Please note that it is best that this function returns a CompletableFuture, as this improves performance. j4rs handles simple Futures with polling using an internal ScheduledExecutorService with one thread and this has apparent performance issues. You may have a look at J4rsPolledFuture for more details.

Specified by:

invokeAsyncToChannel in interface Instance<T>

Parameters:

channelAddress - The address of the function pointer that will be used when the Future completes, in the native side, in order to actually perform the callback and complete a Future that is created in Rust and awaits for the Java Future to complete.

methodName - The method name

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

invokeToChannel

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

Description copied from interface: Instance

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.

Specified by:

invokeToChannel in interface Instance<T>

Parameters:

channelAddress - The memory address of the channel

methodName - The method name

args - The arguments

initializeCallbackChannel

public void initializeCallbackChannel(long channelAddress)

Description copied from interface: Instance

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.

Specified by:

initializeCallbackChannel in interface Instance<T>

Parameters:

channelAddress - The memory address of the channel

field

public Instance field(String methodName)

Description copied from interface: Instance

Retrieves the instance held under the Field fieldName

Specified by:

field in interface Instance<T>

Parameters:

methodName - The name of the field to retrieve

Returns:

A Instance instance containing the defined field.

getObject

public T getObject()

Specified by:

getObject in interface ObjectValue

getObjectClass

public Class<?> getObjectClass()

Specified by:

getObjectClass in interface ObjectValue

getObjectClassName

public String getObjectClassName()

Specified by:

getObjectClassName in interface ObjectValue

getJson

public String getJson()

Specified by:

getJson in interface JsonValue