B
Exceptions and Errors

B.1 Exception Class

The Exception class (and its subclasses, including SQLException) indicates conditions of interest to the user.

public class java.lang.Exception extends java.lang.Throwable {
     //Constructs an Exception with no detailed message
     public Exception();
     
     //Constructs an Exception with a detailed message
     public Exception(String s);
}

B.2 IllegalArgumentException Class

The IllegalArgumentException class signals that a method has passed an invalid or inappropriate argument.

public class IllegalArgumentException extends RuntimeException{
     //Constructs an IllegalArgumentException with no detailed message
     public IllegalAgumentException( )
     //Constructs an IllegalArgumentExceptuon with the specified detailed 
     //message
     public IllegalArgumentException(String s)
}

B.3 IllegalStateException Class

The IllegalStateException class signals that a method has been invoked at an invalid or inappropriate time; the Java environment or application is not in an appropriate state for the requested operation.

public class IllegalStateException extends java.lang.RuntimeException {
     //Constructs an IllegalStateException with no detailed message
     public IllegalStateException();
     
     //Constructs an IllegalStateException with the specified detailed message
     public IllegalStateException(String s);
}

B.4 IOException Class

The IOException class signals that an I/O exception of some sort has occurred.

public class java.io.IOException extends java.lang.Exception {
     //Constructs an IOException with no detailed message
     public IOException();
     
     //Constructs an IOException with the specified detailed message
     public IOException(String s);
}

B.5 OutOfMemoryError Class

The OutOfMemoryError class signals that the Java Virtual Machine cannot allocate an object because it is both out of memory and unable to make more memory available through garbage collecting (that is, through deleting objects that are no longer being used).

public class java.lang.OutOfMemoryError extends java.lang.VirtualMachineError {
     //Constructs an OutOfMemoryError with no detailed message
     public OutOfMemoryError();
     
     //Constructs an OutOfMemoryError with a detailed message
     public OutOfMemoryError(string s);
}

B.6 OrdHttpResponseException Class

The oracle.ord.im.OrdHttpResponse class extends ServletException to report errors encountered during the retrieval and delivery of media data from a database to an HTTP client.

B.7 OrdHttpUploadException Class

The oracle.ord.im.OrdHttpUploadException class extends IOException to report errors encountered during the uploading of media data from an HTTP client to a database. Its primary purpose is to allow the localization of error message text.

B.8 ServletException Class

The ServletException class defines a general exception that a servlet can throw when it encounters difficulty.

public class ServletException extends java.lang.Exception{
     //Constructs a new ServletException
     public ServletException( )


     //Constructs a new ServletException with the specified message
     public ServletException(String message)


     //Constructs a new ServletException with the specified message and
     //the "root cause" exception that interfered with the normal operation
     //of the servlet
     public ServletException(String message, java.lang.Throwable rootCause)


     //Constructs a new ServletException with the "root cause" exception that
     //interfered with the normal operation of the servlet
     public ServletException(java.lang.Throwable rootCause)


     //Gets the exception that caused the ServletException
     public java.lang.Throwable getRootCause( )
}

B.9 SQLException Class

The SQLException class provides information on a database access error.

public class java.sql.SQLException extends java.lang.Exception {
     //The following four methods are public constructors:
     
     //Constructs a fully specified SQLException
     public SQLException(String reason, String SQLState, int vendorCode);
     
     //Constructs a SQLException with vendorCode value of 0
     public SQLException(String reason, String SQLState);
     
     //Constructs a SQLException with vendorCode value of 0 and a null SQLState
     public SQLException(String reason);
     
     //Constructs a SQLException with vendorCode of 0, a null SQLState. and a 
     //null reason
     public SQLException();
     
     //The following four methods are public instance methods:
      
     //Gets the vendor-specific exception code
     public int getErrorCode();
     
     //Gets the exception connected to this one
     public SQLException getNextException();
     
     //Gets the SQL state
     public String getSQLState();
     
     //Adds a SQLException to the end
     public synchronized void setNextException(SQLException ex);
}