    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.8 of Java Platform API Specification
Java is a trademark or registered trademark of Sun Microsystems, Inc. in the US and other countries.
Copyright 1995-1999 Sun Microsystems, Inc. 901 San Antonio Road,
Palo Alto, California, 94303, U.S.A. All Rights Reserved.