GemFire 6.6.4

com.gemstone.gemfire.cache
Class RegionDistributionException

java.lang.Object
  extended by java.lang.Throwable
      extended by java.lang.Exception
          extended by java.lang.RuntimeException
              extended by com.gemstone.gemfire.GemFireException
                  extended by com.gemstone.gemfire.cache.CacheRuntimeException
                      extended by com.gemstone.gemfire.cache.RoleException
                          extended by com.gemstone.gemfire.cache.RegionRoleException
                              extended by 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

GemFire 6.6.4

Copyright © 1997-2012 VMware, Inc. All rights reserved.