org.sapia.ubik.rmi.server.invocation

Class ClientPostInvokeEvent

java.lang.Object

org.sapia.ubik.rmi.server.invocation.ClientPostInvokeEvent

All Implemented Interfaces:

Event

public class ClientPostInvokeEvent
extends Object
implements Event

This event is generated on the client-side, after a given method has been invoked.

Author:

Yanick Duchesne

Constructor Summary

Constructors

Constructor and Description
ClientPostInvokeEvent(InvokeCommand toInvoke, Object toReturn) Creates an instance of this class.

Method Summary

Methods

Modifier and Type	Method and Description
InvokeCommand	getCommand() Returns the command to invoke.
Object	getReturnObject() Returns the object that was returned by the remote method call.
void	setReturnObject(Object object) Sets this instance return object.

Methods inherited from class java.lang.Object

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

Constructor Detail

ClientPostInvokeEvent

public ClientPostInvokeEvent(InvokeCommand toInvoke,
                     Object toReturn)

Creates an instance of this class.

Parameters:

toInvoke - the InvokeCommand that was sent to the server to perform the method call.

toReturn - the object returned by the remote method (might be null (if the called method returned such); must be Throwable if the called method threw and exception).

Method Detail

getCommand

public InvokeCommand getCommand()

Returns the command to invoke.

Returns:

an InvokeCommand instance.

setReturnObject

public void setReturnObject(Object object)

Sets this instance return object. The passed in object must be an instance of the original one.

This method call is ignored if the original object reference is null, meaning that the method actually returned nothing, or has a return type of void.

Parameters:

object - the Object that consists of the return value of the method call.

getReturnObject

public Object getReturnObject()

Returns the object that was returned by the remote method call.

Important: the object that will be returned might be an instance of Throwable, provided the method threw an exception.

Returns:

an Object, or null if the invoked remote method returned nothing, or has a return type of void.