Java Enterprise in a Nutshell, Second Edition

Name

SystemException

Synopsis

This is the base class for all standard CORBA exceptions. A SystemException can be thrown by any CORBA remote method call, and many CORBA API methods throw SystemExceptions as well. The SystemException class provides an integer minor code that can be optionally used by subclasses to indicate a more precise reason for the exception. The class also provides a CompletionStatus that is used to indicate to the caller whether the method they invoked was completed or not when the exception was encountered.

Subclasses of SystemException represent the many errors that can occur while a remote method request is be processed by the client’s ORB, transferred to the server ORB, executed on the server object, and its response is transferred back to the client. A SystemException can originate on the client or on the server, before, after or during the actual execution of the method on the remote object.

Since SystemException extends the java.lang.RuntimeException, these exceptions don’t need to be declared in method signatures. But all remote methods declared in IDL interfaces that are then mapped to Java, can throw any of the subclasses of SystemException during remote method calls.

                  
public abstract class SystemException extends RuntimeException {
// Protected Constructors
   protected SystemException(String reason, int minor, 
        CompletionStatus completed);  
// Public Methods ...