Exceptions and System Failures

To handle all the exceptions and system failures thrown by vFabric GemFire your application needs to catch these classes:
  • GemFireCheckedException. This class is the abstract superclass of exceptions that are thrown and declared. Wherever possible, GemFire exceptions are checked exceptions. GemFireCheckedException is a GemFire version of java.lang.Exception.
  • GemFireException. This class is the abstract superclass of unchecked exceptions that are thrown to indicate conditions for which the developer should not normally need to check. You can look at the subclasses of GemFireException to see all the runtime exceptions in the GemFire system; see the class hierarchy in the online Java API documentation. GemFireException is a GemFire version of java.lang.RuntimeException. You can also look at the method details in the Region API javadocs for GemFire exceptions you may want to catch.
  • SystemFailure. In addition to exception management, GemFire provides a class to help you manage catastrophic failure in your distributed system, particularly in your application. The Javadocs for this class provide extensive guidance for managing failures in your system and your application. See SystemFailure in the com.gemstone.gemfire package.

To see the exceptions thrown by a specific method, refer to the method's online Java documentation.

A GemFire system member can also throw exceptions generated by third-party software such as JGroups or java.lang classes. For assistance in handling these exceptions, see the vendor documentation.