com.amazon.carbonado.capability

Interface RemoteProcedure<R,D>

Type Parameters:

R - reply object type

D - request data object type

All Superinterfaces:

java.io.Serializable

public interface RemoteProcedure<R,D>
extends java.io.Serializable

Defines a remote procedure which can be executed by RemoteProcedureCapability. Any data within the procedure instance is serialized to the remote host, and possibly the class definition too. Execution might have security restrictions applied.

The RemoteProcedure instance is Serializable, and so any serializable parameters can be passed with it. Storables and extra data can be sent through the RemoteProcedure.Request object. Any data returned by procedure implementation must be sent through the RemoteProcedure.Reply object.

Author:

Brian S O'Neill

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static interface	RemoteProcedure.Call<R,D> Client-side call into a remote procedure.
static interface	RemoteProcedure.Reply<R> Reply from remote procedure implementation.
static interface	RemoteProcedure.Request<R,D> Request into a remote procedure, as seen by procedure implementation.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	handleRequest(Repository repo, RemoteProcedure.Request<R,D> request) Request handler for remote procedure implementation.

Method Detail

handleRequest

boolean handleRequest(Repository repo,
                    RemoteProcedure.Request<R,D> request)
                      throws RepositoryException

Request handler for remote procedure implementation.

Parameters:

repo - repository as seen by host that procedure is running from

request - non-null request object

Returns:

false if request is still active when this method returns; request must eventually be explicitly finished

Throws:

RepositoryException