6.10 Mapping for Run-Time Exceptions

The Ice run time throws run-time exceptions for a number of pre-defined error conditions. All run-time exceptions directly or indirectly derive from Ice::LocalException (which, in turn, derives from Ice::Exception). Ice::LocalException has the usual member functions (ice_name, ice_clone, ice_throw, and (inherited from Ice::Exception), ice_print, ice_file, and ice_line).

An inheritance diagram for user and run-time exceptions appears in Figure 4.4 on page 112. By catching exceptions at the appropriate point in the hierarchy, you can handle exceptions according to the category of error they indicate:

• Ice::Exception

This is the root of the complete inheritance tree. Catching Ice::Exception catches both user and run-time exceptions.

• Ice::UserException

This is the root exception for all user exceptions. Catching Ice::UserException catches all user exceptions (but not run-time exceptions).

• Ice::LocalException

This is the root exception for all run-time exceptions. Catching Ice::LocalException catches all run-time exceptions (but not user exceptions).

• Ice::TimeoutException

This is the base exception for both operation-invocation and connection-establishment timeouts.

• Ice::ConnectTimeoutException

This exception is raised when the initial attempt to establish a connection to a server times out.

For example, a ConnectTimeoutException can be handled as ConnectTimeoutException, TimeoutException, LocalException, or Exception.

You will probably have little need to catch run-time exceptions as their most-derived type and instead catch them by as LocalException; the fine-grained error handling offered by the remainder of the hierarchy is of interest mainly in the implementation of the Ice run time. An exception to this rule are FacetNotExistException (see Chapter 30) and ObjectNotExistException (see Chapter 31), which you may want to catch explicitly.