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

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

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

fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, 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