Overview

Package

Class

Use

Tree

Deprecated

Index

Help

Java Platform 1.2
Beta 4

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: INNER | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

Interface java.rmi.server.RemoteCall

public abstract interface RemoteCall

RemoteCall is an abstraction used solely by the implementation (stubs and skeletons of remote objects) to carry out a call to a remote object.

Method Summary

void	done() Allow cleanup after the remote call has completed.
void	executeCall() Do whatever it takes to execute the call.
ObjectInput	getInputStream() Get the InputStream that the stub/skeleton should get results/arguments from.
ObjectOutput	getOutputStream() Return the output stream the stub/skeleton should put arguments/results into.
ObjectOutput	getResultStream(boolean success) Returns an output stream (may put out header information relating to the success of the call).
void	releaseInputStream() Release the input stream.
void	releaseOutputStream() Release the output stream; in some transports this would release the stream.

Method Detail

getOutputStream

public ObjectOutput getOutputStream()
                             throws IOException

Return the output stream the stub/skeleton should put arguments/results into.

Throws:

IOException - if an I/O error occurs.

releaseOutputStream

public void releaseOutputStream()
                         throws IOException

Release the output stream; in some transports this would release the stream.

Throws:

IOException - if an I/O error occurs.

getInputStream

public ObjectInput getInputStream()
                           throws IOException

Get the InputStream that the stub/skeleton should get results/arguments from.

Throws:

IOException - if an I/O error occurs.

releaseInputStream

public void releaseInputStream()
                        throws IOException

Release the input stream. This would allow some transports to release the channel early.

Throws:

IOException - if an I/O error occurs.

getResultStream

public ObjectOutput getResultStream(boolean success)
                             throws IOException,
                                    StreamCorruptedException

Returns an output stream (may put out header information relating to the success of the call). Should only succeed once per remote call.

Parameters:

success - If true, indicates normal return, else indicates exceptional return.

Throws:

IOException - if an I/O error occurs.

StreamCorruptedException - If already been called.

executeCall

public void executeCall()
                 throws Exception

Do whatever it takes to execute the call.

Throws:

Exception - if a general exception occurs.

done

public void done()
          throws IOException

Allow cleanup after the remote call has completed.

Throws:

IOException - if an I/O error occurs.