Exceptions

The Blueworx Voice Response Java API uses a fairly standard exception model. Some exceptions are expected, like WVRRequestCancelledException or WVRHungUpException, but most are thrown when the application encounters an error condition. The exceptions are arranged into a hierarchy. The hierarchy groups related exceptions together and allows you to catch a whole group of exceptions in one go by catching the exception that is the base class for the group. For instance all exceptions relating to the Call class are either direct or indirect sub classes of WVRCallException. The base classes are as follows:

These base class exceptions are never actually thrown themselves, they are only used for catching groups of exceptions. You can also catch individual exceptions. The most likely exception you would want to catch in this way would probably be WVRHungUpException. For example:

  try {
    // Execute some code
    .
    .
    .
  }
  catch (WVRHungUpException ex) {
    // Catches an individual exception - in this case the caller has hung up
  }
  catch (WVRCallException ex) {
    // Catches all exceptions that inherit from WVRCallException that have
    // not already been caught (in other words, not WVRHungUpException) -
    // the application has encountered an error condition
  }
  catch (WVRException ex) {
    // Catches all WVR exceptions not already caught - the application has
    // encountered a further error
  }

For more information and details of individual exceptions, see the JavaDoc supplied with this documentation.