org.sapia.ubik.rmi.server.invocation
Class InvocationDispatcher

java.lang.Object
  org.sapia.ubik.rmi.server.invocation.InvocationDispatcher

public class InvocationDispatcher
extends java.lang.Object

This class handles remote method invocations on the client-side.

Author:

Yanick Duchesne

Copyright:

Copyright © 2002-2003 Sapia Open Source Software. All Rights Reserved.

License:

Read the license.txt file of the jar or visit the license page at the Sapia OSS web site

Constructor Summary

InvocationDispatcher()
Constructor for InvocationDispatcher.

Method Summary

java.lang.Object	dispatchInvocation(VmId vmId, Connections pool, CallBackInvokeCommand cmd) Dispatches the given asynchronous invocation command using the passed in connection pool (which holds connections to a remote server).
java.lang.Object	dispatchInvocation(VmId vmId, Connections pool, InvokeCommand cmd) Dispatches the given invocation command using the passed in connection pool (which holds connections to a remote server).

Methods inherited from class java.lang.Object

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

Constructor Detail

InvocationDispatcher

public InvocationDispatcher()

Constructor for InvocationDispatcher.

Method Detail

dispatchInvocation

public java.lang.Object dispatchInvocation(VmId vmId,
                                           Connections pool,
                                           InvokeCommand cmd)
                                    throws java.io.IOException,
                                           java.lang.ClassNotFoundException,
                                           java.lang.Throwable

Dispatches the given invocation command using the passed in connection pool (which holds connections to a remote server).

Parameters:

vmId - the VmId of the stub that is performing the call.

pool - Connections to the server to call.

cmd - an InvokeCommand representing the remote method invocation to be performed.

Returns:

the return value of the invocation.

Throws:

java.io.IOException - if an IO problem occurs while performing this operation.

java.lang.ClassNotFoundException - if the class of the invocation's return value could not be found in the deserialization process.

java.lang.Throwable - if the invocation is colocated and an exception is throws by the colocated call.

dispatchInvocation

public java.lang.Object dispatchInvocation(VmId vmId,
                                           Connections pool,
                                           CallBackInvokeCommand cmd)
                                    throws java.io.IOException,
                                           java.lang.ClassNotFoundException,
                                           ResponseTimeOutException,
                                           java.lang.Throwable

Dispatches the given asynchronous invocation command using the passed in connection pool (which holds connections to a remote server).

Parameters:

vmId - the VmId of the stub that is performing the call.

pool - Connections to the server to call.

cmd - an InvokeCommand representing the remote method invocation to be performed.

Returns:

the return value of the invocation.

Throws:

java.io.IOException - if an IO problem occurs while performing this operation.

java.lang.ClassNotFoundException - if the class of the invocation's return value could not be found in the deserialization process.

ResponseTimeOutException - if no response is received before the time-out specified by the ubik.rmi.client.callback.timeout property.

java.lang.Throwable - if the invocation is colocated and an exception is throws by the colocated call.