SQLWarning (Java SE 10 & JDK 10 )
- java.lang.Object
-
- java.lang.Throwable
-
- java.lang.Exception
-
- java.sql.SQLException
-
- java.sql.SQLWarning
-
- All Implemented Interfaces:
Serializable,Iterable<Throwable>
- Direct Known Subclasses:
DataTruncation
public class SQLWarning extends SQLException
An exception that provides information on database access warnings. Warnings are silently chained to the object whose method caused it to be reported.
Warnings may be retrieved from
Connection,Statement, andResultSetobjects. 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.- Since:
- 1.1
- See Also:
Connection.getWarnings(),Statement.getWarnings(),ResultSet.getWarnings(), Serialized Form
-
-
Constructor Summary
Constructors Constructor Description SQLWarning()Constructs a
SQLWarningobject.SQLWarning(String reason)Constructs a
SQLWarningobject with a givenreason.SQLWarning(String reason, String SQLState)Constructs a
SQLWarningobject with a givenreasonandSQLState.SQLWarning(String reason, String SQLState, int vendorCode)Constructs a
SQLWarningobject with a givenreason,SQLStateandvendorCode.SQLWarning(String reason, String SQLState, int vendorCode, Throwable cause)Constructs a
SQLWarningobject with a givenreason,SQLState,vendorCodeandcause.SQLWarning(String reason, String SQLState, Throwable cause)Constructs a
SQLWarningobject with a givenreason,SQLStateandcause.SQLWarning(String reason, Throwable cause)Constructs a
SQLWarningobject with a givenreasonandcause.SQLWarning(Throwable cause)Constructs a
SQLWarningobject with a givencause.
-
Method Summary
All Methods Instance Methods Concrete Methods Modifier and Type Method Description SQLWarninggetNextWarning()Retrieves the warning chained to this
SQLWarningobject bysetNextWarning.voidsetNextWarning(SQLWarning w)Adds a
SQLWarningobject to the end of the chain.-
Methods declared in interface java.lang.Iterable
forEach, spliterator
-
Methods declared in class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
-
Methods declared in class java.sql.SQLException
getErrorCode, getNextException, getSQLState, iterator, setNextException
-
Methods declared in class java.lang.Throwable
addSuppressed, fillInStackTrace, getCause, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString
-
-
-
-
Constructor Detail
-
SQLWarning
public SQLWarning(String reason, String SQLState, int vendorCode)
Constructs a
SQLWarningobject with a givenreason,SQLStateandvendorCode. Thecauseis not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable)method.- Parameters:
reason- a description of the warningSQLState- an XOPEN or SQL:2003 code identifying the warningvendorCode- a database vendor-specific warning code
-
SQLWarning
public SQLWarning(String reason, String SQLState)
Constructs a
SQLWarningobject with a givenreasonandSQLState. Thecauseis not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable)method. The vendor code is initialized to 0.- Parameters:
reason- a description of the warningSQLState- an XOPEN or SQL:2003 code identifying the warning
-
SQLWarning
public SQLWarning(String reason)
Constructs a
SQLWarningobject with a givenreason. TheSQLStateis initialized tonulland the vendor code is initialized to 0. Thecauseis not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable)method.- Parameters:
reason- a description of the warning
-
SQLWarning
public SQLWarning()
Constructs a
SQLWarningobject. Thereason,SQLStateare initialized tonulland the vendor code is initialized to 0. Thecauseis not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable)method.
-
SQLWarning
public SQLWarning(Throwable cause)
Constructs a
SQLWarningobject with a givencause. TheSQLStateis initialized tonulland the vendor code is initialized to 0. Thereasonis initialized tonullifcause==nullor tocause.toString()ifcause!=null.- Parameters:
cause- the underlying reason for thisSQLWarning(which is saved for later retrieval by thegetCause()method); may be null indicating the cause is non-existent or unknown.
-
SQLWarning
public SQLWarning(String reason, Throwable cause)
Constructs a
SQLWarningobject with a givenreasonandcause. TheSQLStateis initialized tonulland the vendor code is initialized to 0.- Parameters:
reason- a description of the warningcause- the underlying reason for thisSQLWarning(which is saved for later retrieval by thegetCause()method); may be null indicating the cause is non-existent or unknown.
-
SQLWarning
public SQLWarning(String reason, String SQLState, Throwable cause)
Constructs a
SQLWarningobject with a givenreason,SQLStateandcause. The vendor code is initialized to 0.- Parameters:
reason- a description of the warningSQLState- an XOPEN or SQL:2003 code identifying the warningcause- the underlying reason for thisSQLWarning(which is saved for later retrieval by thegetCause()method); may be null indicating the cause is non-existent or unknown.
-
SQLWarning
public SQLWarning(String reason, String SQLState, int vendorCode, Throwable cause)
Constructs a
SQLWarningobject with a givenreason,SQLState,vendorCodeandcause.- Parameters:
reason- a description of the warningSQLState- an XOPEN or SQL:2003 code identifying the warningvendorCode- a database vendor-specific warning codecause- the underlying reason for thisSQLWarning(which is saved for later retrieval by thegetCause()method); may be null indicating the cause is non-existent or unknown.
-
-
Method Detail
-
getNextWarning
public SQLWarning getNextWarning()
Retrieves the warning chained to this
SQLWarningobject bysetNextWarning.- Returns:
- the next
SQLExceptionin the chain;nullif none - See Also:
setNextWarning(java.sql.SQLWarning)
-
setNextWarning
public void setNextWarning(SQLWarning w)
Adds a
SQLWarningobject to the end of the chain.- Parameters:
w- the new end of theSQLExceptionchain- See Also:
getNextWarning()
-
-
Report a bug or suggest an enhancement
For further API reference and developer documentation see the Java SE Documentation, which contains more detailed, developer-targeted descriptions with conceptual overviews, definitions of terms, workarounds, and working code examples.
Java is a trademark or registered trademark of Oracle and/or its affiliates in the US and other countries.
Copyright © 1993, 2018, Oracle and/or its affiliates, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
All rights reserved. Use is subject to license terms and the documentation redistribution policy.