fulmine.distribution
Interface IRemoteUpdateInvoker

All Superinterfaces:

IRpcPublicationListener

All Known Implementing Classes:

RemoteUpdateInvoker

public interface IRemoteUpdateInvoker
extends IRpcPublicationListener

Handles requests from the local context to update remote containers.

Implementations need to handle the situation where the local context has not yet received the 'RPC registry' from the remote context and should thus cache any update requests until the RPC for updating remote containers is available.

Author:

Ramon Servadei

See Also:

IRpcRegistry

Method Summary

IRpcResult

invoke(String remoteContextIdentity, StringField identity, IntegerField type, IntegerField domain, StringField fieldName, StringField valueAsString, IntegerField permissionApp, IntegerField permissionCode, StringField originatingRemoteContextIdentity) Invoke the 'update remote container' RPC in the named remote context.

Methods inherited from interface fulmine.rpc.IRpcPublicationListener

procedureAvailable, procedureUnavailable

Method Detail

invoke

IRpcResult invoke(String remoteContextIdentity,
                  StringField identity,
                  IntegerField type,
                  IntegerField domain,
                  StringField fieldName,
                  StringField valueAsString,
                  IntegerField permissionApp,
                  IntegerField permissionCode,
                  StringField originatingRemoteContextIdentity)

Invoke the 'update remote container' RPC in the named remote context. Whether this is called before or after the RPC registry for the remote context is received is of no consequence; the invocation will occur only when the RPC registry has been received.

Parameters:

remoteContextIdentity - the remote context to invoke the RPC in

identity - the container identity, used to locate the container

type - the container type, used to locate the container

domain - the container domain, used to locate the container

fieldName - the field in the container to update

valueAsString - the new value for the field, in string form

permissionApp - the application permission of the context issuing the change, see IPermissionProfile

permissionCode - the permission of the context issuing the change, see IPermissionProfile

originatingRemoteContextIdentity - the identity of the remote context issuing the command

Returns:

the result from the RPC

See Also:

#RPC_TIMEOUT_PROPERTY