Oracle® Coherence Java API Reference
v3.5

E14977-01

com.tangosol.net.cache
Class ContinuousQueryCache.ServiceListener

java.lang.Object
  extended by com.tangosol.net.cache.ContinuousQueryCache.ServiceListener
All Implemented Interfaces:
MemberListener, java.util.EventListener
Enclosing class:
ContinuousQueryCache

protected class ContinuousQueryCache.ServiceListener
extends java.lang.Object
implements MemberListener

MemberListener for the underlying cache's service.

The primary goal of that listener is invalidation of the ContinousQueryCache in case of the corresponding CacheService [automatic] restart.


Constructor Summary
protected ContinuousQueryCache.ServiceListener()
           
 
Method Summary
 void memberJoined(MemberEvent evt)
          Invoked when a Member has joined the service.
 void memberLeaving(MemberEvent evt)
          Invoked when a Member is leaving the service.
 void memberLeft(MemberEvent evt)
          Invoked when a Member has left the service.
 java.lang.String toString()
          Produce a human-readable description of this object.
 

Constructor Detail

ContinuousQueryCache.ServiceListener

protected ContinuousQueryCache.ServiceListener()
Method Detail

memberJoined

public void memberJoined(MemberEvent evt)
Invoked when a Member has joined the service.

Note: this event could be called during the service restart on the local node (evt.isLocal()) in which case the listener's code should not attempt to use any clustered cache or service functionality.

The most critical situation arises when a number of threads are waiting for a local service restart, being blocked by a Service object synchronization monitor. Since the Joined event should be fired only once, it is called on an event dispatcher thread while holding a synchronization monitor. An attempt to use other clustered service functionality during this local event notification may result in a deadlock.

Specified by:
memberJoined in interface MemberListener
Parameters:
evt - the MemberEvent.MEMBER_JOINED event

memberLeaving

public void memberLeaving(MemberEvent evt)
Invoked when a Member is leaving the service.

Specified by:
memberLeaving in interface MemberListener
Parameters:
evt - the MemberEvent.MEMBER_LEAVING event

memberLeft

public void memberLeft(MemberEvent evt)
Invoked when a Member has left the service.

Note: this event could be called during the service restart on the local node (evt.isLocal()) in which case the listener's code should not attempt to use any clustered cache or service functionality.

Specified by:
memberLeft in interface MemberListener
Parameters:
evt - the MemberEvent.MEMBER_LEFT event

toString

public java.lang.String toString()
Produce a human-readable description of this object.

Returns:
a String describing this object

Oracle® Coherence Java API Reference
v3.5

E14977-01

Copyright © 2000, 2009, Oracle. All rights reserved.