com.gemstone.gemfire.cache

Class RegionDistributionException

java.lang.Object

java.lang.Throwable

java.lang.Exception

java.lang.RuntimeException

com.gemstone.gemfire.GemFireException

com.gemstone.gemfire.cache.CacheRuntimeException

com.gemstone.gemfire.cache.RoleException

com.gemstone.gemfire.cache.RegionRoleException

com.gemstone.gemfire.cache.RegionDistributionException

All Implemented Interfaces:

Serializable

public class RegionDistributionException
extends RegionRoleException

Indicates that an attempt to send a distributed cache event to one or more required roles may have failed. Failure may be caused by departure of one or more required roles while sending the message to them. If the region scope is DISTRIBUTED_NO_ACK or GLOBAL then failure may be caused by one or more required roles not acknowledging receipt of the message.

Since:

5.0

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
RegionDistributionException(String s, String regionFullPath, Set failedRoles) Constructs a RegionDistributionException with a message.
RegionDistributionException(String s, String regionFullPath, Set failedRoles, Throwable ex) Constructs a RegionDistributionException with a message and a cause.

Method Summary

Methods

Modifier and Type	Method and Description
Set	getFailedRoles() Returns the required roles that caused this exception.

Methods inherited from class com.gemstone.gemfire.cache.RegionRoleException

getRegionFullPath

Methods inherited from class com.gemstone.gemfire.cache.CacheRuntimeException

toString

Methods inherited from class com.gemstone.gemfire.GemFireException

getRootCause

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

RegionDistributionException

public RegionDistributionException(String s,
                           String regionFullPath,
                           Set failedRoles)

Constructs a RegionDistributionException with a message.

Parameters:

s - the String message

regionFullPath - full path of region for which access was attempted

failedRoles - the required roles that caused this exception

RegionDistributionException

public RegionDistributionException(String s,
                           String regionFullPath,
                           Set failedRoles,
                           Throwable ex)

Constructs a RegionDistributionException with a message and a cause.

Parameters:

s - the String message

regionFullPath - full path of region for which access was attempted

failedRoles - the required roles that caused this exception

ex - the Throwable cause

Method Detail

getFailedRoles

public Set getFailedRoles()

Returns the required roles that caused this exception. One or more roles failed to receive a cache distribution message or acknowledge receipt of that message.

Returns:

the required roles that caused this exception