org.jboss.remoting.transport
Interface ClientInvoker

All Superinterfaces:

Invoker

All Known Implementing Classes:

LocalClientInvoker, RemoteClientInvoker

public interface ClientInvoker

extends Invoker

Interface to be used for calling on all the different invoker types (LocalClientInvoker and RemoteClientInvoker).

Author:

Tom Elrod

Method Summary

void	connect() connect to the remote invoker
void	disconnect() disconnect from the remote invokere
InvokerLocator	getClientLocator() Gets the client locator.
Marshaller	getMarshaller()
UnMarshaller	getUnMarshaller()
Object	invoke(InvocationRequest in) transport a request against a remote ServerInvoker
boolean	isConnected() subclasses must provide this method to return true if their remote connection is connected and false if disconnected.
void	setClientLocator(InvokerLocator locator) This should be set when want to override the default behavior of automatically getting s suitable locator.
void	setMarshaller(Marshaller marshaller)
void	setUnMarshaller(UnMarshaller unmarshaller)

Methods inherited from interface org.jboss.remoting.Invoker

getLocator

Method Detail

setClientLocator

public void setClientLocator(InvokerLocator locator)

This should be set when want to override the default behavior of automatically getting s suitable locator. This should be used want want to control what type of callbacks to receive (pull or push). Set to null to poll for callback messages. This can also be used to receive callbacks using another transport and subsystem, if desired.

Parameters:

locator -

getClientLocator

public InvokerLocator getClientLocator()

Gets the client locator. This locator will be used by the server side to make callbacks to the handler for this locator.

Returns:

invoke

public Object invoke(InvocationRequest in)
              throws Throwable

transport a request against a remote ServerInvoker

Parameters:

in -

Returns:

Throws:

Throwable

isConnected

public boolean isConnected()

subclasses must provide this method to return true if their remote connection is connected and false if disconnected. in some transports, such as SOAP, this method may always return true, since the remote connectivity is done on demand and not kept persistent like other transports (such as socket-based transport).

Returns:

boolean true if connected, false if not

connect

public void connect()
             throws ConnectionFailedException

connect to the remote invoker

Throws:

ConnectionFailedException

disconnect

public void disconnect()

disconnect from the remote invokere

setMarshaller

public void setMarshaller(Marshaller marshaller)

getMarshaller

public Marshaller getMarshaller()

setUnMarshaller

public void setUnMarshaller(UnMarshaller unmarshaller)

getUnMarshaller

public UnMarshaller getUnMarshaller()