org.jboss.remoting.transport.rmi
Class RMIClientInvoker

java.lang.Object
  org.jboss.remoting.AbstractInvoker
      org.jboss.remoting.RemoteClientInvoker
          org.jboss.remoting.transport.rmi.RMIClientInvoker

All Implemented Interfaces:

ClientInvoker, Invoker

public class RMIClientInvoker

extends RemoteClientInvoker

RMIClientInvoker

Version:

$Revision: 1.4 $

Author:

Jeff Haynie, Tom Elrod

Field Summary

Fields inherited from class org.jboss.remoting.RemoteClientInvoker

connected

Fields inherited from class org.jboss.remoting.AbstractInvoker

classbyteloader, localServerLocator, locator, log, logExtra

Constructor Summary

RMIClientInvoker(InvokerLocator locator)

Method Summary

RMIServerInvokerInf	getServerStub() return the RMI server stub
protected void	handleConnect() subclasses must implement this method to provide a hook to connect to the remote server, if this applies to the specific transport.
protected void	handleDisconnect() subclasses must implement this method to provide a hook to disconnect from the remote server, if this applies to the specific transport.
void	setServerStub(RMIServerInvokerInf server) get the server stub
protected byte[]	transport(String sessionId, byte[] buffer) called to transport the marshalled invocation to the remote destination, and receive back the marshalled invocation bytes back.

Methods inherited from class org.jboss.remoting.RemoteClientInvoker

connect, disconnect, finalize, invoke, isConnected, postProcess, preProcess

Methods inherited from class org.jboss.remoting.AbstractInvoker

addClass, getClassBytes, getClientLocator, getLocator, loadClass, read, setClassLoader, setClientLocator, unmarshal

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.jboss.remoting.transport.ClientInvoker

getClientLocator, setClientLocator

Methods inherited from interface org.jboss.remoting.Invoker

getLocator

Constructor Detail

RMIClientInvoker

public RMIClientInvoker(InvokerLocator locator)

Method Detail

setServerStub

public void setServerStub(RMIServerInvokerInf server)

get the server stub

Parameters:

server -

getServerStub

public RMIServerInvokerInf getServerStub()

return the RMI server stub

Returns:

handleConnect

protected void handleConnect()
                      throws ConnectionFailedException

subclasses must implement this method to provide a hook to connect to the remote server, if this applies to the specific transport. However, in some transport implementations, this may not make must difference since the connection is not persistent among invocations, such as SOAP. In these cases, the method should silently return without any processing.

Specified by:

handleConnect in class RemoteClientInvoker

Throws:

ConnectionFailedException

handleDisconnect

protected void handleDisconnect()

subclasses must implement this method to provide a hook to disconnect from the remote server, if this applies to the specific transport. However, in some transport implementations, this may not make must difference since the connection is not persistent among invocations, such as SOAP. In these cases, the method should silently return without any processing.

Specified by:

handleDisconnect in class RemoteClientInvoker

transport

protected byte[] transport(String sessionId,
                           byte[] buffer)
                    throws IOException,
                           ConnectionFailedException

Description copied from class: RemoteClientInvoker

called to transport the marshalled invocation to the remote destination, and receive back the marshalled invocation bytes back. this method allows the subclass to provide the specific mechanism, protocol, etc. for delivering and returning remote invocations in a transport-specific way.

Specified by:

transport in class RemoteClientInvoker

Parameters:

sessionId - session id to pass along

buffer - buffer of the serialized method invocation to send to the server

Returns:

result of the method invocation as serialized bytes

Throws:

IOException - fatal exception should only be raised in the case the transport write fails (but is still a valid connection)

ConnectionFailedException - this exception is raised in the case the remote side is no longer available