org.objectweb.jeremie.apis.binding
Interface JRMIOptRef
- All Superinterfaces:
- java.io.Externalizable, JRMIRef, Reference, java.rmi.server.RemoteRef, java.io.Serializable
- All Known Implementing Classes:
- RefImpl
- public interface JRMIOptRef
- extends JRMIRef
A JRMIOptRef optimizes a Jeremie reference
with the
addition of methods for type-specific marshalling of data
for remote method invocations, as opposed to the use of generic
reflection-based marshalling.
Fields inherited from interface java.rmi.server.RemoteRef |
packagePrefix, serialVersionUID |
Methods inherited from interface java.rmi.server.RemoteRef |
done, getRefClass, invoke, invoke, newCall, remoteEquals, remoteHashCode, remoteToString |
Methods inherited from interface java.io.Externalizable |
readExternal, writeExternal |
request
public Marshaller request()
throws java.rmi.MarshalException
- Obtains a marshaller for marshalling remote method invocation data.
- Returns:
- a marshaller for marshalling invocation data;
- Throws:
java.rmi.MarshalException
- if something goes wrong.
prepareInvocation
public ReplyInterface prepareInvocation(Marshaller marshaller)
throws java.rmi.MarshalException
- Prepares the marshaller prior to marshalling invocation data. This
preparation is protocol-specific and typically consists of adding headers
to the marshaller. In line with Java remote method invocations, a reply
is expected after the remote invocation is executed; the result of this
method is thus an interface for listening for the reply.
- Parameters:
marshaller
- a marshaller to be used for the invocation data;
- Returns:
- a reply interface for listening for the reply;
- Throws:
java.rmi.MarshalException
- if something goes wrong.
invoke
public void invoke(Marshaller marshaller)
throws java.rmi.MarshalException
- Sends the marshaller with the invocation data down the protocol stack.
- Parameters:
marshaller
- a marshaller with the invocation data;
- Throws:
java.rmi.MarshalException
- if something goes wrong.