com.artima.place
Interface DynamicPlace

All Superinterfaces:

Place

All Known Subinterfaces:

ModifiablePlace

public interface DynamicPlace

extends Place

A dynamic map of Links to services 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 Place.

A DynamicPlace implementation class can optionally implement ModifiablePlace. A class that implements ModifiablePlace will notify PlaceChangeListeners of all changes to the Place, including changes resulting from the client invoking methods declared in ModifiablePlace.

Method Summary

void	addPlaceChangeListener(PlaceChangeListener listener) Adds the specified PlaceChangeListener to receive PlaceChangeEvents from this object.
void	removePlaceChangeListener(PlaceChangeListener listener) Removes the specified PlaceChangeListener so that it no longer receives PlaceChangeEvents from this object.

Methods inherited from interface com.artima.place.Place

containsAllKeys, containsAllLinkItems, containsKey, containsKey, containsLinkItem, get, get, isEmpty, keyIterator, keySetSize, linkItemIterator, size

Method Detail

addPlaceChangeListener

public void addPlaceChangeListener(PlaceChangeListener listener)

Adds the specified PlaceChangeListener to receive PlaceChangeEvents from this object.

Parameters:

listener - the PlaceChangeListener to add

Throws:

NullPointerException - if passed listener is null

removePlaceChangeListener

public void removePlaceChangeListener(PlaceChangeListener listener)

Removes the specified PlaceChangeListener so that it no longer receives PlaceChangeEvents from this object.

Parameters:

listener - the PlaceChangeListener to remove

Throws:

NullPointerException - if passed listener is null