com.amazon.carbonado.capability

Interface RemoteProcedureCapability

All Superinterfaces:

Capability

public interface RemoteProcedureCapability
extends Capability

Capability which allows arbitrary code to run on a remote host and access its repository. The remote procedure might have security restrictions applied to it.

Examples:

 RemoteProcedureCapability cap = ...
 Cursor<MyRecord> c1 = cap.beginCall(new CustomQuery<MyRecord>(params)).fetchReply();
 ...

 Cursor<InputRecord> c2 = ...
 cap.beginCall(new Importer<InputRecord>()).sendAll(c2).finish();
 

Author:

Brian S O'Neill

See Also:

RemoteProcedure

Method Summary

Methods

Modifier and Type	Method and Description
<R,D> RemoteProcedure.Call<R,D>	beginCall(RemoteProcedure<R,D> proc) Begins a call to execute the given procedure on a remote host.

Method Detail

beginCall

<R,D> RemoteProcedure.Call<R,D> beginCall(RemoteProcedure<R,D> proc)
                                    throws RepositoryException

Begins a call to execute the given procedure on a remote host. Execution commences when the Call object is instructed to do so.

Type Parameters:

R - reply object type

D - request data object type

Parameters:

proc - procedure to execute

Returns:

object for defining the call and receiving a reply

Throws:

RepositoryException