org.cojen.dirmi.core

Interface Skeleton<R extends Remote>

All Superinterfaces:

Unreferenced

public interface Skeleton<R extends Remote>
extends Unreferenced

A Skeleton instance wraps a server-side Remote object, unmarshalls client requests, and invokes server-side methods. Any response is marshalled back to the client.

Author:

Brian S O'Neill

See Also:

SkeletonFactory

Field Summary

Fields

Modifier and Type	Field and Description
static int	READ_ANY_THREAD Caller should read another request, using any thread.
static int	READ_FINISHED Caller should not read any more requests.
static int	READ_SAME_THREAD Caller should read another request, in the current thread.

Method Summary

Modifier and Type	Method and Description
R	getRemoteServer() Returns the Remote object managed by this Skeleton.
int	invoke(Link sessionLink, int methodId, InvocationChannel channel, BatchedInvocationException batchedException) Invoke a remote method on the server.

Methods inherited from interface org.cojen.dirmi.Unreferenced

unreferenced

Field Detail

READ_FINISHED

static final int READ_FINISHED

Caller should not read any more requests.

See Also:

Constant Field Values

READ_ANY_THREAD

static final int READ_ANY_THREAD

Caller should read another request, using any thread.

See Also:

Constant Field Values

READ_SAME_THREAD

static final int READ_SAME_THREAD

Caller should read another request, in the current thread.

See Also:

Constant Field Values

Method Detail

getRemoteServer

R getRemoteServer()

Returns the Remote object managed by this Skeleton.

invoke

int invoke(Link sessionLink,
           int methodId,
           InvocationChannel channel,
           BatchedInvocationException batchedException)
    throws IOException,
           NoSuchMethodException,
           NoSuchObjectException,
           ClassNotFoundException,
           BatchedInvocationException

Invoke a remote method on the server. Any exception thrown from the invoked method is written to the channel, unless method is asynchronous or batched. Any other exception thrown from this method indicates a communication failure, and so the channel should be closed.

If this invocation is after a batched call which threw an exception, the batchedException parameter wraps it. If non-null, the input arguments must be discarded and the method not actually invoked. Next, if method is batched, the same exception is re-thrown. Otherwise, the exception is converted to a type compatible with the method's throwable exception types and handled like any other thrown exception. For synchronous methods, this means the exception is written to the channel.

Parameters:

sessionLink - link to session, used by SessionAware objects

methodId - method to invoke

channel - InvocationChannel for reading method arguments and for writing response.

batchedException - optional exception which was thrown earlier in a batch request

Returns:

READ_FINISHED, READ_ANY_THREAD or READ_SAME_THREAD

Throws:

IOException - if thrown from channel

NoSuchMethodException - if method is unknown

NoSuchObjectException - if remote parameter refers to an unknown object

ClassNotFoundException - if unmarshalling an object parameter refers to an unknown class

BatchedInvocationException - if method is batched and throws an exception