Module java.sql
Package java.sql

Class SQLWarning

java.lang.Object
java.lang.Throwable
All Implemented Interfaces:
Serializable,Iterable<Throwable>
Direct Known Subclasses:
DataTruncation
public classSQLWarningextendsSQLException

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 fromConnection,Statement, andResultSet 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.

Since:
1.1
See Also:

  • Constructor Details

    • SQLWarning

      public SQLWarning(String reason,String SQLState, int vendorCode)
      Constructs aSQLWarning object with a givenreason,SQLState andvendorCode. Thecause is not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable) method.
      Parameters:
      reason - a description of the warning
      SQLState - an XOPEN or SQL:2003 code identifying the warning
      vendorCode - a database vendor-specific warning code

    • SQLWarning

      public SQLWarning(String reason,String SQLState)
      Constructs aSQLWarning object with a givenreason andSQLState. Thecause is 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 warning
      SQLState - an XOPEN or SQL:2003 code identifying the warning

    • SQLWarning

      public SQLWarning(String reason)
      Constructs aSQLWarning object with a givenreason. TheSQLState is initialized tonull and the vendor code is initialized to 0. Thecause is 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 aSQLWarning object. Thereason,SQLState are initialized tonull and the vendor code is initialized to 0. Thecause is not initialized, and may subsequently be initialized by a call to theThrowable.initCause(java.lang.Throwable) method.

    • SQLWarning

      public SQLWarning(Throwable cause)
      Constructs aSQLWarning object with a givencause. TheSQLState is initialized tonull and the vendor code is initialized to 0. Thereason is initialized tonull ifcause==null or 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 aSQLWarning object with a givenreason andcause. TheSQLState is initialized tonull and the vendor code is initialized to 0.
      Parameters:
      reason - a description of the warning
      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,String SQLState,Throwable cause)
      Constructs aSQLWarning object with a givenreason,SQLState andcause. The vendor code is initialized to 0.
      Parameters:
      reason - a description of the warning
      SQLState - an XOPEN or SQL:2003 code identifying the warning
      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,String SQLState, int vendorCode,Throwable cause)
      Constructs aSQLWarning object with a givenreason,SQLState,vendorCode andcause.
      Parameters:
      reason - a description of the warning
      SQLState - an XOPEN or SQL:2003 code identifying the warning
      vendorCode - a database vendor-specific warning code
      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.

  • Method Details

    • getNextWarning

      public SQLWarning getNextWarning()
      Retrieves the warning chained to thisSQLWarning object bysetNextWarning.
      Returns:
      the nextSQLException in the chain;null if none
      See Also:

    • setNextWarning

      public void setNextWarning(SQLWarning w)
      Adds aSQLWarning object to the end of the chain.
      Parameters:
      w - the new end of theSQLException chain
      See Also: