B
Exceptions and Errors

This appendix contains information on the exceptions and errors that can be raised by the classes that extend the ORDMultiMedia superclass.

B.1 Exception

The Exception class (and its subclasses, including SQLException) indicates conditions of which the application will make the user aware.

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 FileNotFoundException

The FileNotFoundException class signals that a file could not be found.

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

B.3 IOException

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

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

B.4 NullPointerException

The NullPointerException class signals that an application has attempted to use null in a case where an object is required. These cases include:

• Calling an instance method of a null object

• Accessing or modifying a field in a null object

• Taking a length of null as if it were an array

• Accessing or modifying the slots of null as if it were an array

• Throwing null as if it were a Throwable value

Applications should throw instances of this class to indicate other invalid uses of the null object.

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

B.5 OutOfMemoryError

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 SecurityException

The SecurityException is thrown by an instance of the SecurityManager class to indicate a security violation.

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

B.7 SQLException

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);
     
     //Construct a SQLException with venderCode value of 0
     public SQLException(String reason, String SQLState);
     
     //Construct a SQLException with vendorCode value of 0 and a null SQLState
     public SQLException(String reason);
     
     //Construct a SQLException with vendorCode of 0, a null SQLState. and a 
     //null reason
     public SQLException();
     
     //The following four methods are public instance methods
      
     //Get the vendor-specific exception code
     public int getErrorCode();
     
     //Get the exception connected to this one
     public SQLException getNextException();
     
     //Get the SQL state
     public String getSQLState();
     
     //Add a SQLException to the end
     public synchronized void setNextException(SQLException ex);
}

---