org.objectweb.jeremie.apis.binding
Interface JRMIOptRef

All Superinterfaces:

Externalizable, JRMIRef, Reference, RemoteRef, 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

Method Summary

void	invoke(Marshaller marshaller) Sends the marshaller with the invocation data down the protocol stack.
ReplyInterface	prepareInvocation(Marshaller marshaller) Prepares the marshaller prior to marshalling invocation data.
Marshaller	request() Obtains a marshaller for marshalling remote method invocation data.

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

Methods inherited from interface org.objectweb.jonathan.apis.binding.Reference

getIdentifiers, setIdentifiers

Method Detail

request

public Marshaller request()
                   throws MarshalException

Obtains a marshaller for marshalling remote method invocation data.

Returns:

a marshaller for marshalling invocation data;

Throws:

MarshalException - if something goes wrong.

prepareInvocation

public ReplyInterface prepareInvocation(Marshaller marshaller)
                                 throws 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:

MarshalException - if something goes wrong.

invoke

public void invoke(Marshaller marshaller)
            throws MarshalException

Sends the marshaller with the invocation data down the protocol stack.

Parameters:

marshaller - a marshaller with the invocation data;

Throws:

MarshalException - if something goes wrong.