nenok.net
Class Locator

java.lang.Object
  extended by nenok.net.Locator
All Implemented Interfaces:
Serializable
Direct Known Subclasses:
DefaultLocator, IdentityLocator

public abstract class Locator
extends Object
implements Serializable

The location of a (remote) Valuation object can unambiguously be determined by the identifier of the processor hosting the valuation and the identifier of the valuation's envelope. Locators are objects that carries these informations in order to localize valuation objects at a later time. Furthermore, they manage the following additional informations:

Version:
1.3
Author:
Marc Pouly
See Also:
Serialized Form

Constructor Summary
protected Locator(net.jini.id.Uuid pid)
          Constructor:
 
Method Summary
abstract  void delete()
          Deletes the valuation that is referenced by this locator.
abstract  Domain getDomain()
           
 net.jini.id.Uuid getPID()
           
abstract  String getType()
           
abstract  int getWeight()
           
abstract  Valuation retrieve()
           
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

Locator

protected Locator(net.jini.id.Uuid pid)
Constructor:

Parameters:
pid - The identifier of the processor hosting the valuation.
Method Detail

retrieve

public abstract Valuation retrieve()
                            throws RemoteException
Returns:
Retrieves the referenced valuation from the processor.
Throws:
RemoteException - Exception caused when trying to access processors.

delete

public abstract void delete()
                     throws RemoteException
Deletes the valuation that is referenced by this locator.

Throws:
RemoteException - Exception caused when trying to access processors.

getDomain

public abstract Domain getDomain()
Returns:
The domain of the referenced valuation.

getWeight

public abstract int getWeight()
Returns:
The weight of the referenced valuation.

getType

public abstract String getType()
Returns:
The type (class name) of the referenced valuation.

getPID

public net.jini.id.Uuid getPID()
Returns:
The indentifier of the processor that hosts the valuation.