diff options
| author | Eric Blake <ebb9@byu.net> | 2002-02-24 04:25:15 +0000 |
|---|---|---|
| committer | Eric Blake <ebb9@byu.net> | 2002-02-24 04:25:15 +0000 |
| commit | a3f60f71365174676e1302f0b201f5772849ffd3 (patch) | |
| tree | 493dd1be8064241b1d269916046f7c1f1247b603 /java/sql/SQLException.java | |
| parent | 70f6e1ec80b4ffc5370564b2710ee194054da42f (diff) | |
| download | classpath-a3f60f71365174676e1302f0b201f5772849ffd3.tar.gz | |
2002-02-23 Eric Blake <ebb9@email.byu.edu>
* java/awt/AWTError.java: Update to 1.4.
* java/awt/AWTException.java: Ditto.
* java/awt/IllegalComponentStateException.java: Ditto.
* java/awt/datatransfer/MimeTypeParseException.java: Ditto.
* java/awt/datatransfer/UnsupportedFlavorException.java: Ditto.
* java/awt/geom/IllegalPathStateException.java: Ditto.
* java/awt/geom/NoninvertibleTransformException.java: Ditto.
* java/awt/print/PrinterAbortException.java: Ditto.
* java/awt/print/PrinterException.java: Ditto.
* java/awt/print/PrinterIOException.java: Ditto.
* java/beans/IntrospectionException.java: Ditto.
* java/beans/PropertyVetoException.java: Ditto.
* java/io/CharConversionException.java: Ditto.
* java/io/EOFException.java: Ditto.
* java/io/FileNotFoundException.java: Ditto.
* java/io/InterruptedIOException.java: Ditto.
* java/io/InvalidClassException.java: Ditto.
* java/io/InvalidObjectException.java: Ditto.
* java/io/IOException.java: Ditto.
* java/io/NotActiveException.java: Ditto.
* java/io/NotSerializableException.java: Ditto.
* java/io/ObjectStreamException.java: Ditto.
* java/io/OptionalDataException.java: Ditto.
* java/io/StreamCorruptedException.java: Ditto.
* java/io/SyncFailedException.java: Ditto.
* java/io/UnsupportedEncodingException.java: Ditto.
* java/io/UTFDataFormatException.java: Ditto.
* java/io/WriteAbortedException.java: Ditto.
* java/lang/AbstractMethodError.java: Ditto.
* java/lang/ArithmeticException.java: Ditto.
* java/lang/ArrayIndexOutOfBoundsException.java: Ditto.
* java/lang/ArrayStoreException.java: Ditto.
* java/lang/AssertionError.java: Ditto.
* java/lang/ClassCastException.java: Ditto.
* java/lang/ClassCircularityError.java: Ditto.
* java/lang/ClassFormatError.java: Ditto.
* java/lang/ClassNotFoundException.java: Ditto.
* java/lang/CloneNotSupportedException.java: Ditto.
* java/lang/Exception.java: Ditto.
* java/lang/ExceptionInInitializerError.java: Ditto.
* java/lang/IllegalAccessError.java: Ditto.
* java/lang/IllegalAccessException.java: Ditto.
* java/lang/IllegalArgumentException.java: Ditto.
* java/lang/IllegalMonitorStateException.java: Ditto.
* java/lang/IllegalStateException.java: Ditto.
* java/lang/IllegalThreadStateException.java: Ditto.
* java/lang/IncompatibleClassChangeError.java: Ditto.
* java/lang/IndexOutOfBoundsException.java: Ditto.
* java/lang/InstantiationError.java: Ditto.
* java/lang/InstantiationException.java: Ditto.
* java/lang/InternalError.java: Ditto.
* java/lang/InterruptedException.java: Ditto.
* java/lang/LinkageError.java: Ditto.
* java/lang/NegativeArraySizeException.java: Ditto.
* java/lang/NoClassDefFoundError.java: Ditto.
* java/lang/NoSuchFieldError.java: Ditto.
* java/lang/NoSuchFieldException.java: Ditto.
* java/lang/NoSuchMethodError.java: Ditto.
* java/lang/NoSuchMethodException.java: Ditto.
* java/lang/NullPointerException.java: Ditto.
* java/lang/NumberFormatException.java: Ditto.
* java/lang/OutOfMemoryError.java: Ditto.
* java/lang/RuntimeException.java: Ditto.
* java/lang/SecurityException.java: Ditto.
* java/lang/StackOverflowError.java: Ditto.
* java/lang/StringIndexOutOfBoundsException.java: Ditto.
* java/lang/ThreadDeath.java: Ditto.
* java/lang/UnknownError.java: Ditto.
* java/lang/UnsatisfiedLinkError.java: Ditto.
* java/lang/UnsupportedClassVersionError.java: Ditto.
* java/lang/UnsupportedOperationException.java: Ditto.
* java/lang/VerifyError.java: Ditto.
* java/lang/VirtualMachineError.java: Ditto.
* java/lang/Void.java: Ditto.
* java/lang/reflect/InvocationTargetException.java: Ditto.
* java/lang/reflect/UndeclaredThrowableException.java: Ditto.
* java/net/BindException.java: Ditto.
* java/net/ConnectException.java: Ditto.
* java/net/MalformedURLException.java: Ditto.
* java/net/NoRouteToHostException.java: Ditto.
* java/net/ProtocolException.java: Ditto.
* java/net/SocketException.java: Ditto.
* java/net/UnknownHostException.java: Ditto.
* java/net/UnknownServiceException.java: Ditto.
* java/rmi/AccessException.java: Ditto.
* java/rmi/AlreadyBoundException.java: Ditto.
* java/rmi/ConnectException.java: Ditto.
* java/rmi/ConnectIOException.java: Ditto.
* java/rmi/MarshalException.java: Ditto.
* java/rmi/NoSuchObjectException.java: Ditto.
* java/rmi/NotBoundException.java: Ditto.
* java/rmi/RemoteException.java: Ditto.
* java/rmi/RMISecurityException.java: Ditto.
* java/rmi/ServerException.java: Ditto.
* java/rmi/ServerRuntimeException.java: Ditto.
* java/rmi/StubNotFoundException.java: Ditto.
* java/rmi/UnexpectedException.java: Ditto.
* java/rmi/UnknownHostException.java: Ditto.
* java/rmi/UnmarshalException.java: Ditto.
* java/rmi/activation/ActivateFailedException.java: Ditto.
* java/rmi/activation/ActivationException.java: Ditto.
* java/rmi/activation/UnknownGroupException.java: Ditto.
* java/rmi/activation/UnknownObjectException.java: Ditto.
* java/rmi/server/ExportException.java: Ditto.
* java/rmi/server/ServerCloneException.java: Ditto.
* java/rmi/server/ServerNotActiveException.java: Ditto.
* java/rmi/server/SkeletonMismatchException.java: Ditto.
* java/rmi/server/SkeletonNotFoundException.java: Ditto.
* java/rmi/server/SocketSecurityException.java: Ditto.
* java/security/AccessControlException.java: Ditto.
* java/security/DigestException.java: Ditto.
* java/security/GeneralSecurityException.java: Ditto.
* java/security/InvalidAlgorithmParameterException.java: Ditto.
* java/security/InvalidKeyException.java: Ditto.
* java/security/InvalidParameterException.java: Ditto.
* java/security/KeyException.java: Ditto.
* java/security/KeyManagementException.java: Ditto.
* java/security/KeyStoreException.java: Ditto.
* java/security/NoSuchAlgorithmException.java: Ditto.
* java/security/NoSuchProviderException.java: Ditto.
* java/security/PrivilegedActionException.java: Ditto.
* java/security/ProviderException.java: Ditto.
* java/security/SignatureException.java: Ditto.
* java/security/UnrecoverableKeyException.java: Ditto.
* java/security/acl/AclNotFoundException.java: Ditto.
* java/security/acl/LastOwnerException.java: Ditto.
* java/security/acl/NotOwnerException.java: Ditto.
* java/security/cert/CertificateEncodingException.java: Ditto.
* java/security/cert/CertificateException.java: Ditto.
* java/security/cert/CertificateExpiredException.java: Ditto.
* java/security/cert/CertificateNotYetValidException.java: Ditto.
* java/security/cert/CertificateParsingException.java: Ditto.
* java/security/cert/CRLException.java: Ditto.
* java/security/spec/InvalidKeySpecException.java: Ditto.
* java/security/spec/InvalidParameterSpecException.java: Ditto.
* java/sql/BatchUpdateException.java: Ditto.
* java/sql/DataTruncation.java: Ditto.
* java/sql/SQLException.java: Ditto.
* java/sql/SQLWarning.java: Ditto.
* java/text/ParseException.java: Ditto.
* java/util/MissingResourceException.java: Ditto.
* java/util/jar/JarException.java: Ditto.
* java/util/prefs/BackingStoreException.java: Ditto.
* java/util/prefs/InvalidPreferencesFormatException.java: Ditto.
* java/util/zip/DataFormatException.java: Ditto.
* java/util/zip/ZipException.java: Ditto.
* java/awt/Makefile.am (EXTRA_DIST): Add FontFormatException.java
and HeadlessException.java.
* java/awt/FontFormatException.java: New file.
* java/awt/HeadlessException.java: New file.
* java/awt/color/Makefile.am (EXTRA_DIST): Add CMMException.java
and ProfileDataException.java.
* java/awt/color/CMMException.java: New file.
* java/awt/color/ProfileDataException.java: New file.
* java/awt/image/Makefile.am (EXTRA_DIST): Add
ImagingOpException.java and RasterFormatException.java.
* java/awt/image/ImagingOpException.java: New file.
* java/awt/image/RasterFormatException.java: New file.
* java/net/Makefile.am (EXTRA_DIST): Add
PortUnreachableException.java, SocketTimeoutException.java and
URISyntaxException.java.
* java/net/PortUnreachableException.java: New file.
* java/net/SocketTimeoutException.java: New file.
* java/net/URISyntaxException.java: New file.
* java/security/cert/Makefile.am (EXTRA_DIST): Add
CertPathBuilderException.java, CertPathValidatorException.java,
and CertStoreException.java.
* java/security/cert/CertPathBuilderException.java: New file.
* java/security/cert/CertPathValidatorException.java: New file.
* java/security/cert/CertStoreException.java: New file.
* vm/reference/java/lang/Throwable.java (toString): Use
getLocalizedMessage().
* ChangeLog: Fix spelling error.
Diffstat (limited to 'java/sql/SQLException.java')
| -rw-r--r-- | java/sql/SQLException.java | 314 |
1 files changed, 135 insertions, 179 deletions
diff --git a/java/sql/SQLException.java b/java/sql/SQLException.java index fce56650f..64e14503d 100644 --- a/java/sql/SQLException.java +++ b/java/sql/SQLException.java @@ -1,5 +1,5 @@ /* SQLException.java -- General SQL exception - Copyright (C) 1999, 2000 Free Software Foundation, Inc. + Copyright (C) 1999, 2000, 2002 Free Software Foundation, Inc. This file is part of GNU Classpath. @@ -7,7 +7,7 @@ GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. - + GNU Classpath 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 @@ -39,183 +39,139 @@ exception statement from your version. */ package java.sql; /** - * This exception is thrown when a database error occurs. - * - * @author Aaron M. Renn (arenn@urbanophile.com) - */ -public class SQLException extends Exception -{ - -/*************************************************************************/ - -/* - * Instance Variables + * This exception is thrown when a database error occurs. This exception + * keeps track of additional information:<br><ul> + * <li>The error message string (part of all Throwables)</li> + * <li>An "SQLstate" string, following either the XOPEN SQLstate or the SQL 99 + * conventions.</li> + * <li>A vendor-specific integer error code.</li> + * <li>A chain to the next exception.</li> + * <ul> + * + * @author Aaron M. Renn (arenn@urbanophile.com) + * @status updated to 1.4 */ - -/** - * 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; - -/*************************************************************************/ - -/** - * Static Variables - */ - -/** - * This is the serialization UID for this class - */ -private static final long serialVersionUID = 2135244094396331484L; - -/*************************************************************************/ - -/* - * 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) +public class SQLException extends Exception { - if (e == null) - return; - - SQLException list_entry = this; - while (list_entry.getNextException() != null) - list_entry = list_entry.getNextException(); - - list_entry.next = e; -} - + /** + * Compatible with JDK 1.1+. + */ + private static final long serialVersionUID = 2135244094396331484L; + + /** + * This is the next exception in the chain. + * + * @serial the next exception in the chain + */ + // Package visible for use by SQLWarning. + SQLException next; + + /** + * This is the state of the SQL statement at the time of the error. + * + * @serial the SQLstate + */ + private final String SQLState; + + /** + * The vendor error code for this error. + * + * @serial the vendor code + */ + private final int vendorCode; + + /** + * Create a new instance that does not have a descriptive messages or SQL + * state, and which has a vendor error code of 0. + */ + public SQLException() + { + this(null, null, 0); + } + + /** + * Create a new instance 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); + } + + /** + * Create a new instance 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); + } + + /** + * Create a new instance 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; + } + + /** + * Get the SQLState information associated with this error. This + * implementation formats the value using the XOPEN SQL state conventions. + * + * @return The SQL state, which may be <code>null</code> + */ + public String getSQLState() + { + return SQLState; + } + + /** + * Get the vendor specific error code associated with this error. + * + * @return the vendor specific error code associated with this error + */ + public int getErrorCode() + { + return vendorCode; + } + + /** + * Get any exception that is chained to this object. + * + * @return the exception chained to this object, or null + */ + public SQLException getNextException() + { + return next; + } + + /** + * Add 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 entry = this; + while (entry.next != null) + entry = entry.next; + entry.next = e; + } } // class SQLException - |
