com.gemstone.gemfire.cache
Interface RegionMembershipListener

All Superinterfaces:

CacheCallback, CacheListener

All Known Implementing Classes:

RegionMembershipListenerAdapter, RegionRoleListenerAdapter

public interface RegionMembershipListener
extends CacheListener

A listener that can be implemented to handle region membership events.

Instead of implementing this interface it is recommended that you extend the RegionMembershipListenerAdapter class.

Since:

5.0

See Also:

AttributesFactory.addCacheListener(com.gemstone.gemfire.cache.CacheListener), AttributesFactory.initCacheListeners(com.gemstone.gemfire.cache.CacheListener[]), RegionAttributes.getCacheListeners(), AttributesMutator.addCacheListener(com.gemstone.gemfire.cache.CacheListener), AttributesMutator.removeCacheListener(com.gemstone.gemfire.cache.CacheListener), AttributesMutator.initCacheListeners(com.gemstone.gemfire.cache.CacheListener[])

Method Summary

void	afterRemoteRegionCrash(RegionEvent event) Invoked when another member's distributed region is no longer available to this cache because the member has crashed or is no longer reachable on the network.
void	afterRemoteRegionCreate(RegionEvent event) Invoked when another member has created the distributed region this listener is on.
void	afterRemoteRegionDeparture(RegionEvent event) Invoked when another member's distributed region is no longer available to this cache.
void	initialMembers(Region region, DistributedMember[] initialMembers) Invoked when the listener is first initialized and is given the set of members that have the region created at that time.

Methods inherited from interface com.gemstone.gemfire.cache.CacheListener

afterCreate, afterDestroy, afterInvalidate, afterRegionClear, afterRegionCreate, afterRegionDestroy, afterRegionInvalidate, afterRegionLive, afterUpdate

Methods inherited from interface com.gemstone.gemfire.cache.CacheCallback

close

Method Detail

initialMembers

void initialMembers(Region region,
                    DistributedMember[] initialMembers)

Invoked when the listener is first initialized and is given the set of members that have the region created at that time. The listener is initialized when:

• the region is created with an already added listener
• a listener is added using the AttributesMutator.

Parameters:

region - the Region the listener is registered on

initialMembers - an array of the other members that have this region at the time this listener is added.

afterRemoteRegionCreate

void afterRemoteRegionCreate(RegionEvent event)

Invoked when another member has created the distributed region this listener is on.

Parameters:

event - the event from the member whose region was created.

afterRemoteRegionDeparture

void afterRemoteRegionDeparture(RegionEvent event)

Invoked when another member's distributed region is no longer available to this cache. Note that this can be triggered by one of the following methods:

• Region.localDestroyRegion()
• Region.close()
• Cache.close()

Parameters:

event - the event from the member whose region is no longer available.

afterRemoteRegionCrash

void afterRemoteRegionCrash(RegionEvent event)

Invoked when another member's distributed region is no longer available to this cache because the member has crashed or is no longer reachable on the network.

Parameters:

event - the event from the member whose region is no longer available.