org.ourgrid.common.gump
Class BindableMockGumpClientWrapper

java.lang.Object
  extended by java.rmi.server.RemoteObject
      extended by java.rmi.server.RemoteServer
          extended by java.rmi.server.UnicastRemoteObject
              extended by org.ourgrid.common.rmi.OurgridUnicastRemoteObject
                  extended by org.ourgrid.common.gump.BindableMockGumpClientWrapper
All Implemented Interfaces:
java.io.Serializable, java.rmi.Remote, GumpClient

public class BindableMockGumpClientWrapper
extends OurgridUnicastRemoteObject
implements GumpClient

Used in tests to allow that a mock GumpClient can be exported as a RMI object. This is done to allow that Naming#lookup returns a mock object (actually the wrapper) when invoked.

See Also:
Serialized Form

Field Summary
 
Fields inherited from class java.rmi.server.RemoteObject
ref
 
Constructor Summary
BindableMockGumpClientWrapper(GumpClient gumpClient)
          Default constructor
 
Method Summary
 ObjectID getObjectID()
          Returns the Identification object related to this GumpClient.
 void hereIsGum(GumResponseEntry gumResponseEntry)
           Delivers a grid machine (Gum) to this consumer.
 
Methods inherited from class java.rmi.server.UnicastRemoteObject
clone, exportObject, exportObject, exportObject, unexportObject
 
Methods inherited from class java.rmi.server.RemoteServer
getClientHost, getLog, setLog
 
Methods inherited from class java.rmi.server.RemoteObject
equals, getRef, hashCode, toString, toStub
 
Methods inherited from class java.lang.Object
finalize, getClass, notify, notifyAll, wait, wait, wait
 

Constructor Detail

BindableMockGumpClientWrapper

public BindableMockGumpClientWrapper(GumpClient gumpClient)
                              throws java.rmi.RemoteException
Default constructor

Parameters:
gumpClient - A mock GumpClient.
Throws:
java.rmi.RemoteException
Method Detail

hereIsGum

public void hereIsGum(GumResponseEntry gumResponseEntry)
               throws java.rmi.RemoteException
Description copied from interface: GumpClient

Delivers a grid machine (Gum) to this consumer. The grid machine satisfies the requirements of a specific request made by this consumer. The respective request is informed through a requestID which travels inside the parameter of type GumResponseEntry, which also contains a reference to the Gum, a gum specification (GumSpec) and a ID of the grid machine provider.

The grid machine availability has no guarantees. It may become unavailable due to failures or to the provider's will. For example, the provider may decide to schedule the grid machine to another consumer.

Also, it is expected that the consumer releases the Gum when it does not need it anymore. To do this the consumer must invoke the method Gump.finishRequestGums() .

Specified by:
hereIsGum in interface GumpClient
Parameters:
gumResponseEntry - an object containing the information about the delivery. It contains a reference to the Gum, a gum specification (GumSpec) and a ID of the grid machine provider.
Throws:
java.rmi.RemoteException - if some RMI error occurs during the method invocation.

getObjectID

public ObjectID getObjectID()
                     throws java.rmi.RemoteException
Description copied from interface: GumpClient
Returns the Identification object related to this GumpClient.

Specified by:
getObjectID in interface GumpClient
Returns:
the consumer identification.
Throws:
java.rmi.RemoteException - if some RMI error occurs during the method invocation.