de.aristaflow.adept2.base.communication.invocation

Interface InvocationDelegate

public interface InvocationDelegate

The invocation delegate which is called by the InvocationHandler for processing API calls remotely. The interface is intended to use InvocationMessages, which explains the similarity to InvocationMessage.InvocationMessage(String, long, long, URI, boolean, Stack, Object[], String).

Method Summary

Modifier and Type	Method and Description
java.lang.Object	invoke(long invocationId, java.net.URI remoteIdentifier, java.lang.Class<?> remoteIface, boolean callback, GlobalInvocationResolver gir, java.util.Stack<java.lang.reflect.Method> methodStack, java.lang.Object[] parameters) Invokes the specified method remotely on the ADEPT2 component identified by the given remoteObjectIdentifier.

Method Detail

invoke

java.lang.Object invoke(long invocationId,
                        java.net.URI remoteIdentifier,
                        java.lang.Class<?> remoteIface,
                        boolean callback,
                        GlobalInvocationResolver gir,
                        java.util.Stack<java.lang.reflect.Method> methodStack,
                        java.lang.Object[] parameters)
                 throws java.lang.Throwable

Invokes the specified method remotely on the ADEPT2 component identified by the given remoteObjectIdentifier.

The requested method may belong to a subcomponent of the ADEPT2 component identified by the given remoteObjectIdentifier. So the access path to the required subcomponent must also be specified. The access path is stored as a stack of Method objects, representing the methods with no parameters that must be called in sequence to access the required subcomponent.

Parameters:

invocationId - The ID of the method invocation, unique with respect to this JVM process. If an invocation is repeated, e. g. due to a communication timeout, the very same ID will have to be used to allow detection of duplicate invocations by the remote site.

remoteIdentifier - The URI identifying the remote service to call.

remoteIface - The interface of the remote service to call.

callback - Whether the call is a callback, that is, it is caused by a stub that has been created for a parameter of another remote service call.

gir - The object handling the global registry invocation to invalidate the global registry in case of problems. null if this invocation is based on local URIs not using the global registry.

methodStack - The method stack containing the access path to the subcomponent of the service the requested method is located and the requested method itself.

parameters - The parameters the requested method should be called with.

Returns:

The return value.

Throws:

java.lang.Throwable - Thrown by the implementation of the method.