Top Description Fields Constructors Methods
sun.rmi.transport

public Class StreamRemoteCall

extends Object
implements RemoteCall
Class Inheritance
All Implemented Interfaces
java.rmi.server.RemoteCall
Annotations
@SuppressWarnings:deprecation
Imports
java.io.DataInputStream, .DataOutputStream, .IOException, .ObjectInput, .ObjectInputFilter, .ObjectOutput, .StreamCorruptedException, java.rmi.RemoteException, .MarshalException, .UnmarshalException, java.rmi.server.ObjID, .RemoteCall, java.security.AccessController, .PrivilegedAction, sun.rmi.runtime.Log, sun.rmi.server.UnicastRef, sun.rmi.transport.tcp.TCPEndpoint

Deprecated

as a consequence of RemoteCall being deprecated. See corresponding docs for further information.

Stream-based implementation of the RemoteCall interface.
Author
Ann Wollrath

Field Summary

Modifier and TypeField and Description
private Connection
conn

private ObjectInputFilter
filter

private ConnectionInputStream
in

private ConnectionOutputStream
out

private boolean
resultStarted

private Exception
serverException

Constructor Summary

AccessConstructor and Description
public
StreamRemoteCall(Connection c)

public
StreamRemoteCall(Connection c, ObjID id, int op, long hash)

Method Summary

Modifier and TypeMethod and Description
public void
discardPendingRefs()

Discard any post-processing of refs the InputStream.

public void
done()

Implements java.rmi.server.RemoteCall.done.

Allow cleanup after the remote call has completed.
protected void
exceptionReceivedFromServer(Exception ex)

Routine that causes the stack traces of remote exceptions to be filled in with the current stack trace on the client.

public void
executeCall()

Implements java.rmi.server.RemoteCall.executeCall.

Do whatever it takes to execute the call.
public Connection
getConnection()

Return the connection associated with this call.

public ObjectInput
getInputStream()

Implements java.rmi.server.RemoteCall.getInputStream.

Get the InputStream the stub/skeleton should get results/arguments from.
public ObjectOutput
getOutputStream()

Implements java.rmi.server.RemoteCall.getOutputStream.

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

public ObjectOutput
getResultStream(boolean
If true, indicates normal return, else indicates exceptional return.
success)

Implements java.rmi.server.RemoteCall.getResultStream.

Returns an output stream (may put out header information relating to the success of the call).
public Exception
getServerException()

public void
releaseInputStream()

Implements java.rmi.server.RemoteCall.releaseInputStream.

Release the input stream, this would allow some transports to release the channel early.
public void
releaseOutputStream()

Implements java.rmi.server.RemoteCall.releaseOutputStream.

Release the outputStream Currently, will not complain if the output stream is released more than once.
public void
setObjectInputFilter(ObjectInputFilter filter)

Inherited from java.lang.Object:
cloneequalsfinalizegetClasshashCodenotifynotifyAlltoStringwaitwaitwait

Field Detail

connback to summary
private Connection conn
filterback to summary
private ObjectInputFilter filter
inback to summary
private ConnectionInputStream in
outback to summary
private ConnectionOutputStream out
resultStartedback to summary
private boolean resultStarted
serverExceptionback to summary
private Exception serverException

Constructor Detail

StreamRemoteCallback to summary
public StreamRemoteCall(Connection c)
StreamRemoteCallback to summary
public StreamRemoteCall(Connection c, ObjID id, int op, long hash) throws RemoteException

Method Detail

discardPendingRefsback to summary
public void discardPendingRefs()

Discard any post-processing of refs the InputStream.

doneback to summary
public void done() throws IOException

Implements java.rmi.server.RemoteCall.done.

Doc from java.rmi.server.RemoteCall.done.

Allow cleanup after the remote call has completed.

Exceptions
IOException:
if an I/O error occurs.
exceptionReceivedFromServerback to summary
protected void exceptionReceivedFromServer(Exception ex) throws Exception

Routine that causes the stack traces of remote exceptions to be filled in with the current stack trace on the client. Detail exceptions are filled in iteratively.

executeCallback to summary
public void executeCall() throws Exception

Implements java.rmi.server.RemoteCall.executeCall.

Do whatever it takes to execute the call.

Annotations
@SuppressWarnings:fallthrough
Exceptions
Exception:

Doc from java.rmi.server.RemoteCall.executeCall.

if a general exception occurs.

getConnectionback to summary
public Connection getConnection()

Return the connection associated with this call.

getInputStreamback to summary
public ObjectInput getInputStream() throws IOException

Implements java.rmi.server.RemoteCall.getInputStream.

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

Returns:ObjectInput

Doc from java.rmi.server.RemoteCall.getInputStream.

input stream for reading arguments/results

Annotations
@SuppressWarnings:removal
Exceptions
IOException:

Doc from java.rmi.server.RemoteCall.getInputStream.

if an I/O error occurs.

getOutputStreamback to summary
public ObjectOutput getOutputStream() throws IOException

Implements java.rmi.server.RemoteCall.getOutputStream.

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

Returns:ObjectOutput

Doc from java.rmi.server.RemoteCall.getOutputStream.

output stream for arguments/results

Exceptions
IOException:

Doc from java.rmi.server.RemoteCall.getOutputStream.

if an I/O error occurs.

getOutputStreamback to summary
private ObjectOutput getOutputStream(boolean resultStream) throws IOException
getResultStreamback to summary
public ObjectOutput getResultStream(boolean success) throws IOException

Implements java.rmi.server.RemoteCall.getResultStream.

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

Parameters
success:boolean

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

Returns:ObjectOutput

Doc from java.rmi.server.RemoteCall.getResultStream.

output stream for writing call result

Exceptions
IOException:
For any other problem with I/O.
StreamCorruptedException:
If result stream previously acquired
getServerExceptionback to summary
public Exception getServerException()
releaseInputStreamback to summary
public void releaseInputStream() throws IOException

Implements java.rmi.server.RemoteCall.releaseInputStream.

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

Exceptions
IOException:

Doc from java.rmi.server.RemoteCall.releaseInputStream.

if an I/O error occurs.

releaseOutputStreamback to summary
public void releaseOutputStream() throws IOException

Implements java.rmi.server.RemoteCall.releaseOutputStream.

Release the outputStream Currently, will not complain if the output stream is released more than once.

Exceptions
IOException:

Doc from java.rmi.server.RemoteCall.releaseOutputStream.

if an I/O error occurs.

setObjectInputFilterback to summary
public void setObjectInputFilter(ObjectInputFilter filter)