com.artima.place
Interface DynamicLinkMap

All Superinterfaces:
LinkMap

public interface DynamicLinkMap
extends LinkMap

Represents a dynamic map of links to resources on the network. The map is dynamic because it may asynchronously change while the client using it. For example, a Place service may provide a client with links to the Jini services registered in a particular lookup service that match a particular template. As matching services arrive and depart the lookup service, links to those services will be dynamically added and removed from the Place's LinkMap.

A LinkMap implementation class can optionally implement ModifiableLinkMap and/or DynamicLinkMap. A class that implements both ModifiableLinkMap and DynamicLinkMap will notify LinkMapListeners of all changes to the LinkMap, including changes resulting from the client invoking methods declared in ModifiableLinkMap.


Method Summary
 void addLinkMapListener(LinkMapListener listener)
          Adds the specified LinkMapListener to receive LinkMapEvents from this object.
 void removeLinkMapListener(LinkMapListener listener)
          Removes the specified LinkMapListener so that it no longer receives LinkMapEvents from this object.
 
Methods inherited from interface com.artima.place.LinkMap
containsAllKeys, containsAllLinkItems, containsKey, containsKey, containsLinkItem, get, get, isEmpty, keyIterator, keySetSize, linkItemIterator, size
 

Method Detail

addLinkMapListener

public void addLinkMapListener(LinkMapListener listener)
Adds the specified LinkMapListener to receive LinkMapEvents from this object.
Parameters:
listener - the LinkMapListener to add
Throws:
NullPointerException - if passed listener is null

removeLinkMapListener

public void removeLinkMapListener(LinkMapListener listener)
Removes the specified LinkMapListener so that it no longer receives LinkMapEvents from this object.
Parameters:
listener - the LinkMapListener to remove
Throws:
NullPointerException - if passed listener is null