org.objectweb.jeremie.binding.api

Interface JRMIOptRef

All Superinterfaces:
JRMIRef, Reference, RemoteRef
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.

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.

Method Details

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;


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;


request

public Marshaller request()
            throws MarshalException
Obtains a marshaller for marshalling remote method invocation data.

Returns:
a marshaller for marshalling invocation data;