net.sf.ehcache.distribution
Interface CacheManagerPeerListener

All Superinterfaces:

CacheManagerEventListener

All Known Implementing Classes:

RMICacheManagerPeerListener

public interface CacheManagerPeerListener
extends CacheManagerEventListener

A listener for updates, which controls remote cache peers.

Version:

$Id: CacheManagerPeerListener.java 519 2007-07-27 07:11:45Z gregluck $

Author:

Greg Luck

Method Summary

void	attemptResolutionOfUniqueResourceConflict() If a conflict is detected in unique resource use, this method signals the listener to attempt automatic resolution of the resource conflict.
java.util.List	getBoundCachePeers() All of the caches which are listenting for remote changes.
java.lang.String	getUniqueResourceIdentifier() A listener will normally have a resource that only one instance can use at the same time, such as a port.

Methods inherited from interface net.sf.ehcache.event.CacheManagerEventListener

dispose, getStatus, init, notifyCacheAdded, notifyCacheRemoved

Method Detail

getBoundCachePeers

java.util.List getBoundCachePeers()

All of the caches which are listenting for remote changes.

Returns:

a list of CachePeer objects

getUniqueResourceIdentifier

java.lang.String getUniqueResourceIdentifier()

A listener will normally have a resource that only one instance can use at the same time, such as a port. This identifier is used to tell if it is unique and will not conflict with an existing instance using the resource.

Returns:

a String identifier for the resource

attemptResolutionOfUniqueResourceConflict

void attemptResolutionOfUniqueResourceConflict()
                                               throws java.lang.IllegalStateException,
                                                      CacheException

If a conflict is detected in unique resource use, this method signals the listener to attempt automatic resolution of the resource conflict.

Throws:

java.lang.IllegalStateException - if the statis of the listener is not Status.STATUS_UNINITIALISED

CacheException