001 /*
002 * Copyright 2005-2006 Sun Microsystems, Inc. All Rights Reserved.
003 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
004 *
005 * This code is free software; you can redistribute it and/or modify it
006 * under the terms of the GNU General Public License version 2 only, as
007 * published by the Free Software Foundation. Sun designates this
008 * particular file as subject to the "Classpath" exception as provided
009 * by Sun in the LICENSE file that accompanied this code.
010 *
011 * This code is distributed in the hope that it will be useful, but WITHOUT
012 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
013 * FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
014 * version 2 for more details (a copy is included in the LICENSE file that
015 * accompanied this code).
016 *
017 * You should have received a copy of the GNU General Public License version
018 * 2 along with this work; if not, write to the Free Software Foundation,
019 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
020 *
021 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
022 * CA 95054 USA or visit www.sun.com if you need additional information or
023 * have any questions.
024 */
025
026 package java.sql;
027
028 /**
029 * The subclass of {@link SQLException} thrown when the SQLState class value is '<i>40</i>'. This indicates that the
030 * current statement was automatically rolled back by the database becuase of deadlock or other
031 * transaction serialization failures.
032 *
033 * @since 1.6
034 */
035 public class SQLTransactionRollbackException extends
036 SQLTransientException {
037 /**
038 * Constructs a <code>SQLTransactionRollbackException</code> object.
039 * The <code>reason</code>, <code>SQLState</code> are initialized
040 * to <code>null</code> and the vendor code is initialized to 0.
041 *
042 * The <code>cause</code> is not initialized, and may subsequently be
043 * initialized by a call to the
044 * {@link Throwable#initCause(java.lang.Throwable)} method.
045 * <p>
046 * @since 1.6
047 */
048 public SQLTransactionRollbackException() {
049 super ();
050 }
051
052 /**
053 * Constructs a <code>SQLTransactionRollbackException</code> object
054 * with a given <code>reason</code>. The <code>SQLState</code>
055 * is initialized to <code>null</code> and the vender code is initialized
056 * to 0.
057 *
058 * The <code>cause</code> is not initialized, and may subsequently be
059 * initialized by a call to the
060 * {@link Throwable#initCause(java.lang.Throwable)} method.
061 * <p>
062 * @param reason a description of the exception
063 * @since 1.6
064 */
065 public SQLTransactionRollbackException(String reason) {
066 super (reason);
067 }
068
069 /**
070 * Constructs a <code>SQLTransactionRollbackException</code> object
071 * with a given <code>reason</code> and <code>SQLState</code>.
072 *
073 * The <code>cause</code> is not initialized, and may subsequently be
074 * initialized by a call to the
075 * {@link Throwable#initCause(java.lang.Throwable)} method. The vendor code
076 * is initialized to 0.
077 * <p>
078 * @param reason a description of the exception
079 * @param SQLState an XOPEN or SQL:2003 code identifying the exception
080 * @since 1.6
081 */
082 public SQLTransactionRollbackException(String reason,
083 String SQLState) {
084 super (reason, SQLState);
085 }
086
087 /**
088 * Constructs a <code>SQLTransactionRollbackException</code> object
089 * with a given <code>reason</code>, <code>SQLState</code> and
090 * <code>vendorCode</code>.
091 *
092 * The <code>cause</code> is not initialized, and may subsequently be
093 * initialized by a call to the
094 * {@link Throwable#initCause(java.lang.Throwable)} method.
095 * <p>
096 * @param reason a description of the exception
097 * @param SQLState an XOPEN or SQL:2003 code identifying the exception
098 * @param vendorCode a database vendor specific exception code
099 * @since 1.6
100 */
101 public SQLTransactionRollbackException(String reason,
102 String SQLState, int vendorCode) {
103 super (reason, SQLState, vendorCode);
104 }
105
106 /**
107 * Constructs a <code>SQLTransactionRollbackException</code> object
108 * with a given <code>cause</code>.
109 * The <code>SQLState</code> is initialized
110 * to <code>null</code> and the vendor code is initialized to 0.
111 * The <code>reason</code> is initialized to <code>null</code> if
112 * <code>cause==null</code> or to <code>cause.toString()</code> if
113 * <code>cause!=null</code>.
114 * <p>
115 * @param cause the underlying reason for this <code>SQLException</code> (which is saved for later retrieval by the <code>getCause()</code> method); may be null indicating
116 * the cause is non-existent or unknown.
117 * @since 1.6
118 */
119 public SQLTransactionRollbackException(Throwable cause) {
120 super (cause);
121 }
122
123 /**
124 * Constructs a <code>SQLTransactionRollbackException</code> object
125 * with a given
126 * <code>reason</code> and <code>cause</code>.
127 * The <code>SQLState</code> is initialized to <code>null</code>
128 * and the vendor code is initialized to 0.
129 * <p>
130 * @param reason a description of the exception.
131 * @param cause the underlying reason for this <code>SQLException</code> (which is saved for later retrieval by the <code>getCause()</code> method); may be null indicating
132 * the cause is non-existent or unknown.
133 * @since 1.6
134 */
135 public SQLTransactionRollbackException(String reason,
136 Throwable cause) {
137 super (reason, cause);
138 }
139
140 /**
141 * Constructs a <code>SQLTransactionRollbackException</code> object
142 * with a given
143 * <code>reason</code>, <code>SQLState</code> and <code>cause</code>.
144 * The vendor code is initialized to 0.
145 * <p>
146 * @param reason a description of the exception.
147 * @param SQLState an XOPEN or SQL:2003 code identifying the exception
148 * @param cause the underlying reason for this <code>SQLException</code> (which is saved for later retrieval by the <code>getCause()</code> method); may be null indicating
149 * the cause is non-existent or unknown.
150 * @since 1.6
151 */
152 public SQLTransactionRollbackException(String reason,
153 String SQLState, Throwable cause) {
154 super (reason, SQLState, cause);
155 }
156
157 /**
158 * Constructs a <code>SQLTransactionRollbackException</code> object
159 * with a given
160 * <code>reason</code>, <code>SQLState</code>, <code>vendorCode</code>
161 * and <code>cause</code>.
162 * <p>
163 * @param reason a description of the exception
164 * @param SQLState an XOPEN or SQL:2003 code identifying the exception
165 * @param vendorCode a database vendor-specific exception code
166 * @param cause the underlying reason for this <code>SQLException</code> (which is saved for later retrieval by the <code>getCause()</code> method); may be null indicating
167 * the cause is non-existent or unknown.
168 * @since 1.6
169 */
170 public SQLTransactionRollbackException(String reason,
171 String SQLState, int vendorCode, Throwable cause) {
172 super (reason, SQLState, vendorCode, cause);
173 }
174
175 private static final long serialVersionUID = 5246680841170837229L;
176 }
|