diff options
| author | Aaron M. Renn <arenn@urbanophile.com> | 1999-01-12 04:03:00 +0000 |
|---|---|---|
| committer | Aaron M. Renn <arenn@urbanophile.com> | 1999-01-12 04:03:00 +0000 |
| commit | 941cf75497f9d0e2a981f22c7207c9cfa6e6c309 (patch) | |
| tree | 4698d7ed4fa158f48f100ecd26a2fb1c670557cb /java/sql/SQLException.java | |
| parent | 497c3ec2cc773ecd0d60b81be5077b5fa2098ce0 (diff) | |
| download | classpath-941cf75497f9d0e2a981f22c7207c9cfa6e6c309.tar.gz | |
Initial Checkin
Diffstat (limited to 'java/sql/SQLException.java')
| -rw-r--r-- | java/sql/SQLException.java | 193 |
1 files changed, 193 insertions, 0 deletions
diff --git a/java/sql/SQLException.java b/java/sql/SQLException.java new file mode 100644 index 000000000..d714d7d33 --- /dev/null +++ b/java/sql/SQLException.java @@ -0,0 +1,193 @@ +/************************************************************************* +/* SQLException.java -- General SQL exception +/* +/* Copyright (c) 1999 Free Software Foundation, Inc. +/* Written by Aaron M. Renn (arenn@urbanophile.com) +/* +/* This library is free software; you can redistribute it and/or modify +/* it under the terms of the GNU Library General Public License as published +/* by the Free Software Foundation, either version 2 of the License, or +/* (at your option) any later verion. +/* +/* This library is distributed in the hope that it will be useful, but +/* WITHOUT ANY WARRANTY; without even the implied warranty of +/* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +/* GNU Library General Public License for more details. +/* +/* You should have received a copy of the GNU Library General Public License +/* along with this library; if not, write to the Free Software Foundation +/* Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307 USA +/*************************************************************************/ + +package java.sql; + +/** + * This exception is thrown when a database error occurs. + * + * @author Aaron M. Renn (arenn@urbanophile.com) + */ +public class SQLException extends Exception implements java.io.Serializable +{ + +/*************************************************************************/ + +/* + * Instance Variables + */ + +/** + * This is the next exception in the chain + * @serialized + */ +private SQLException next; + +/** + * This is the state of the SQL statement at the time of the error. + * @serialized + */ +private String SQLState; + +/** + * The vendor error code for this error + * @serialized + */ +private int vendorCode; + +/*************************************************************************/ + +/* + * Constructors + */ + +/** + * This method initializes a new instance of <code>SQLException</code> + * that does not have a descriptive messages and SQL state, and which + * has a vendor error code of 0. + */ +public +SQLException() +{ + this(null, null, 0); +} + +/*************************************************************************/ + +/** + * This method initializes a new instance of <code>SQLException</code> + * with the specified descriptive error message. The SQL state of this + * instance will be <code>null</code> and the vendor error code will be 0. + * + * @param message A string describing the nature of the error. + */ +public +SQLException(String message) +{ + this(message, null, 0); +} + +/*************************************************************************/ + +/** + * This method initializes a new instance of <code>SQLException</code> + * with the specified descriptive error message and SQL state string. + * The vendor error code of this instance will be 0. + * + * @param message A string describing the nature of the error. + * @param SQLState A string containing the SQL state of the error. + */ +public +SQLException(String message, String SQLState) +{ + this(message, SQLState, 0); +} + +/*************************************************************************/ + +/** + * This method initializes a nwe instance of <code>SQLException</code> + * with the specified descriptive error message, SQL state string, and + * vendor code. + * + * @param message A string describing the nature of the error. + * @param SQLState A string containing the SQL state of the error. + * @param vendorCode The vendor error code associated with this error. + */ +public +SQLException(String message, String SQLState, int vendorCode) +{ + super(message); + + this.SQLState = SQLState; + this.vendorCode = vendorCode; +} + +/*************************************************************************/ + +/* + * Instance Methods + */ + +/** + * This method returns the SQLState information associated with this + * error. The value returned is a <code>String</code> which is formatted + * using the XOPEN SQL state conventions. + * + * @return The SQL state, which may be <code>null</code>. + */ +public String +getSQLState() +{ + return(SQLState); +} + +/*************************************************************************/ + +/** + * This method returns the vendor specific error code associated with + * this error. + * + * @return The vendor specific error code associated with this error. + */ +public int +getErrorCode() +{ + return(vendorCode); +} + +/*************************************************************************/ + +/** + * This method returns the exception that is chained to this object. + * + * @return The exception chained to this object, which may be + * <code>null</code>. + */ +public SQLException +getNextException() +{ + return(next); +} + +/*************************************************************************/ + +/** + * This method adds a new exception to the end of the chain of exceptions + * that are chained to this object. + * + * @param e The exception to add to the end of the chain. + */ +public void +setNextException(SQLException e) +{ + if (e == null) + return; + + SQLException list_entry = this; + while (list_entry.getNextException() != null) + list_entry = list_entry.getNextException(); + + list_entry.next = e; +} + +} // class SQLException + |
