Interface java.rmi.server.RemoteCall





All Packages Class Hierarchy This Package Previous Next Index


Interface java.rmi.server.RemoteCall


public 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.








done()
Allow cleanup after the remote call has completed.

executeCall()
Do whatever it takes to execute the call.

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

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

getResultStream(boolean)
Returns an output stream (may put out header information
relating to the success of the call).

releaseInputStream()
Release the input stream.

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






getOutputStream

public abstract 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 abstract 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 abstract 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 abstract 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 abstract 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.
Throws: StreamCorruptedException
If already been called.



executeCall

public abstract void executeCall() throws Exception


Do whatever it takes to execute the call.


Throws: Exception
if a general exception occurs.



done

public abstract void done() throws IOException


Allow cleanup after the remote call has completed.


Throws: IOException
if an I/O error occurs.




All Packages Class Hierarchy This Package Previous Next Index

Submit a bug or feature - Version 1.1.7 of Java Platform API Specification
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1995-1998 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.