org.ourgrid.common.gump
Class BindableMockGumpWrapper

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.BindableMockGumpWrapper
All Implemented Interfaces:
java.io.Serializable, java.rmi.Remote, Gump

public class BindableMockGumpWrapper
extends OurgridUnicastRemoteObject
implements Gump

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
BindableMockGumpWrapper(Gump gump)
          Default constructor
 
Method Summary
 void disposeGum(long requestID, GumID gumID)
          Informs the provider that a given grid machine is not needed anymore.
 void finishRequestGums(long requestID)
          Informs the provider that it must stop providing grid machines for the consumer who made a given request.
 ObjectID getObjectID()
          Returns the identification object related to this GridMachineProvider.
 void pauseRequestGums(long requestID)
          Suspends a request for gums.
 void requestGums(RequestSpec requestSpec)
          Requests grid machines according to the specification contained in a RequestSpec.
 void resumeRequestGums(long requestID)
          Resumes a request for gums.
 void unwantedGum(long requestID, GumID gumID)
          Informs the provider that a given grid machine is not needed anymore.
 
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

BindableMockGumpWrapper

public BindableMockGumpWrapper(Gump gump)
                        throws java.rmi.RemoteException
Default constructor

Parameters:
gump - A mock to be wrapped.
Throws:
java.rmi.RemoteException
Method Detail

requestGums

public void requestGums(RequestSpec requestSpec)
                 throws java.rmi.RemoteException,
                        RequestAlreadyExistsException
Description copied from interface: Gump
Requests grid machines according to the specification contained in a RequestSpec. This event must be broadcasted to the entire Ourgrid community (that is, all know peers).

Specified by:
requestGums in interface Gump
Parameters:
requestSpec - specification of the request
Throws:
java.rmi.RemoteException - if some RMI error occurs during the method invocation.
RequestAlreadyExistsException - another request with the same ID already exists

finishRequestGums

public void finishRequestGums(long requestID)
                       throws java.rmi.RemoteException
Description copied from interface: Gump
Informs the provider that it must stop providing grid machines for the consumer who made a given request. This event must be broadcasted to the entire Ourgrid community (that is, all know peers).

Specified by:
finishRequestGums in interface Gump
Parameters:
requestID - the unique ID that represents the request that needs no more grid machines.
Throws:
java.rmi.RemoteException - if some RMI error occurs during the method invocation.

disposeGum

public void disposeGum(long requestID,
                       GumID gumID)
                throws java.rmi.RemoteException
Description copied from interface: Gump
Informs the provider that a given grid machine is not needed anymore. Thus, the grid machine can be rescheduled to other requests. The same machine may scheduled to the same consumer in the future, for the same request in case it needs machines again or for a completely new request. If it is required that the given request no longer receives the grid machine being disposed, the unwantedGum(long, org.ourgrid.common.id.GumID) call should be used.

This event must be forwarded to the gum owner, only.

Specified by:
disposeGum in interface Gump
Parameters:
requestID - the unique ID that represents the request that wants to dispose the grid machine.
gumID - identification of the grid machine
Throws:
java.rmi.RemoteException - if some RMI error occurs during the method invocation.
See Also:
Gump.unwantedGum(long, GumID)

pauseRequestGums

public void pauseRequestGums(long requestID)
                      throws java.rmi.RemoteException
Description copied from interface: Gump
Suspends a request for gums. This event must be broadcasted to the entire Ourgrid community (that is, all know peers).

Specified by:
pauseRequestGums in interface Gump
Parameters:
requestID - the identification of the request that will be suspended.
Throws:
java.rmi.RemoteException - if some RMI error occurs during the method invocation.

resumeRequestGums

public void resumeRequestGums(long requestID)
                       throws java.rmi.RemoteException
Description copied from interface: Gump
Resumes a request for gums. This event must be broadcasted to the entire Ourgrid community (that is, all know peers).

Specified by:
resumeRequestGums in interface Gump
Parameters:
requestID - the identification of the request that will be resumed.
Throws:
java.rmi.RemoteException - if some RMI error occurs during the method invocation.

unwantedGum

public void unwantedGum(long requestID,
                        GumID gumID)
                 throws java.rmi.RemoteException
Description copied from interface: Gump
Informs the provider that a given grid machine is not needed anymore. Thus, the grid machine can be rescheduled to other requests. Different from the disposeGum(long, org.ourgrid.common.id.GumID), when a Peer receives this call it will no longer deliver this machines to the same request.

This event must be forwarded to the gum owner, only.

Specified by:
unwantedGum in interface Gump
Parameters:
requestID - the unique ID that represents the request which no longer wants this grid machine.
gumID - identification of the grid machine
Throws:
java.rmi.RemoteException - if some RMI error occurs during the method invocation.
See Also:
Gump.disposeGum(long, GumID)

getObjectID

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

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