Package 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(String, long, long, URI, boolean, Stack, Object[], String, java.util.Map).

Method Summary

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

Method Detail

invoke

Object invoke(long invocationId,
              URI remoteIdentifier,
              URI registeredIdentifier,
              Class<?> remoteIface,
              boolean callback,
              GlobalInvocationResolver gir,
              Stack<Method> methodStack,
              Object[] parameters)
       throws 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 (physical) URI identifying the remote service to call.

registeredIdentifier - The original (logical) URI identifying the remote service to call, in case a URI mapping was applied on the original URI.

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:

Throwable - Thrown by the implementation of the method.