SQLWarning.java

/*
 * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation. Oracle designates this
 * particular file as subject to the "Classpath" exception as provided
 * by Oracle in the LICENSE file that accompanied this code.
 *
 * This code 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 General Public License
 * version 2 for more details (a copy is included in the LICENSE file that
 * accompanied this code).
 *
 * You should have received a copy of the GNU General Public License version
 * 2 along with this work; if not, write to the Free Software Foundation,
 * Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA.
 *
 * Please contact Oracle, 500 Oracle Parkway, Redwood Shores, CA 94065 USA
 * or visit www.oracle.com if you need additional information or have any
 * questions.
 */

packagejava.sql;

/**
 * <P>An exception that provides information on database access
 * warnings. Warnings are silently chained to the object whose method
 * caused it to be reported.
 * <P>
 * Warnings may be retrieved from {@code Connection}, {@code Statement},
 * and {@code ResultSet} objects. Trying to retrieve a warning on a
 * connection after it has been closed will cause an exception to be thrown.
 * Similarly, trying to retrieve a warning on a statement after it has been
 * closed or on a result set after it has been closed will cause
 * an exception to be thrown. Note that closing a statement also
 * closes a result set that it might have produced.
 *
 * @see Connection#getWarnings
 * @see Statement#getWarnings
 * @see ResultSet#getWarnings
 * @since 1.1
 */
publicclassSQLWarningextendsSQLException {

/**
 * Constructs a {@code SQLWarning} object
 * with a given {@code reason}, {@code SQLState} and
 * {@code vendorCode}.
 *
 * The {@code cause} is not initialized, and may subsequently be
 * initialized by a call to the
 * {@link Throwable#initCause(java.lang.Throwable)} method.
 *
 * @param reason a description of the warning
 * @param SQLState an XOPEN or SQL:2003 code identifying the warning
 * @param vendorCode a database vendor-specific warning code
 */
publicSQLWarning(Stringreason, StringSQLState, intvendorCode) {
super(reason, SQLState, vendorCode);
DriverManager.println("SQLWarning: reason(" + reason +
") SQLState(" + SQLState +
") vendor code(" + vendorCode + ")");
 }


/**
 * Constructs a {@code SQLWarning} object
 * with a given {@code reason} and {@code SQLState}.
 *
 * The {@code cause} is not initialized, and may subsequently be
 * initialized by a call to the
 * {@link Throwable#initCause(java.lang.Throwable)} method. The vendor code
 * is initialized to 0.
 *
 * @param reason a description of the warning
 * @param SQLState an XOPEN or SQL:2003 code identifying the warning
 */
publicSQLWarning(Stringreason, StringSQLState) {
super(reason, SQLState);
DriverManager.println("SQLWarning: reason(" + reason +
") SQLState(" + SQLState + ")");
 }

/**
 * Constructs a {@code SQLWarning} object
 * with a given {@code reason}. The {@code SQLState}
 * is initialized to {@code null} and the vendor code is initialized
 * to 0.
 *
 * The {@code cause} is not initialized, and may subsequently be
 * initialized by a call to the
 * {@link Throwable#initCause(java.lang.Throwable)} method.
 *
 * @param reason a description of the warning
 */
publicSQLWarning(Stringreason) {
super(reason);
DriverManager.println("SQLWarning: reason(" + reason + ")");
 }

/**
 * Constructs a {@code SQLWarning} object.
 * The {@code reason}, {@code SQLState} are initialized
 * to {@code null} and the vendor code is initialized to 0.
 *
 * The {@code cause} is not initialized, and may subsequently be
 * initialized by a call to the
 * {@link Throwable#initCause(java.lang.Throwable)} method.
 *
 */
publicSQLWarning() {
super();
DriverManager.println("SQLWarning: ");
 }

/**
 * Constructs a {@code SQLWarning} object
 * with a given {@code cause}.
 * The {@code SQLState} is initialized
 * to {@code null} and the vendor code is initialized to 0.
 * The {@code reason} is initialized to {@code null} if
 * {@code cause==null} or to {@code cause.toString()} if
 * {@code cause!=null}.
 *
 * @param cause the underlying reason for this {@code SQLWarning} (which is saved for later retrieval by the {@code getCause()} method); may be null indicating
 * the cause is non-existent or unknown.
 */
publicSQLWarning(Throwablecause) {
super(cause);
DriverManager.println("SQLWarning");
 }

/**
 * Constructs a {@code SQLWarning} object
 * with a given
 * {@code reason} and {@code cause}.
 * The {@code SQLState} is initialized to {@code null}
 * and the vendor code is initialized to 0.
 *
 * @param reason a description of the warning
 * @param cause the underlying reason for this {@code SQLWarning}
 * (which is saved for later retrieval by the {@code getCause()} method);
 * may be null indicating the cause is non-existent or unknown.
 */
publicSQLWarning(Stringreason, Throwablecause) {
super(reason,cause);
DriverManager.println("SQLWarning : reason("+ reason + ")");
 }

/**
 * Constructs a {@code SQLWarning} object
 * with a given
 * {@code reason}, {@code SQLState} and {@code cause}.
 * The vendor code is initialized to 0.
 *
 * @param reason a description of the warning
 * @param SQLState an XOPEN or SQL:2003 code identifying the warning
 * @param cause the underlying reason for this {@code SQLWarning} (which is saved for later retrieval by the {@code getCause()} method); may be null indicating
 * the cause is non-existent or unknown.
 */
publicSQLWarning(Stringreason, StringSQLState, Throwablecause) {
super(reason,SQLState,cause);
DriverManager.println("SQLWarning: reason(" + reason +
") SQLState(" + SQLState + ")");
 }

/**
 * Constructs a{@code SQLWarning} object
 * with a given
 * {@code reason}, {@code SQLState}, {@code vendorCode}
 * and {@code cause}.
 *
 * @param reason a description of the warning
 * @param SQLState an XOPEN or SQL:2003 code identifying the warning
 * @param vendorCode a database vendor-specific warning code
 * @param cause the underlying reason for this {@code SQLWarning} (which is saved for later retrieval by the {@code getCause()} method); may be null indicating
 * the cause is non-existent or unknown.
 */
publicSQLWarning(Stringreason, StringSQLState, intvendorCode, Throwablecause) {
super(reason,SQLState,vendorCode,cause);
DriverManager.println("SQLWarning: reason(" + reason +
") SQLState(" + SQLState +
") vendor code(" + vendorCode + ")");

 }
/**
 * Retrieves the warning chained to this {@code SQLWarning} object by
 * {@code setNextWarning}.
 *
 * @return the next {@code SQLException} in the chain; {@code null} if none
 * @see #setNextWarning
 */
publicSQLWarninggetNextWarning() {
try {
return ((SQLWarning)getNextException());
 } catch (ClassCastExceptionex) {
// The chained value isn't a SQLWarning.
// This is a programming error by whoever added it to
// the SQLWarning chain. We throw a Java "Error".
thrownewError("SQLWarning chain holds value that is not a SQLWarning");
 }
 }

/**
 * Adds a {@code SQLWarning} object to the end of the chain.
 *
 * @param w the new end of the {@code SQLException} chain
 * @see #getNextWarning
 */
publicvoidsetNextWarning(SQLWarningw) {
setNextException(w);
 }

privatestaticfinallongserialVersionUID = 3917336774604784856L;
}