Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels) Summary: [Ctors](https://developer.android.com/reference/java/sql/SQLWarning#pubctors) \| [Methods](https://developer.android.com/reference/java/sql/SQLWarning#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/java/sql/SQLWarning#inhmethods)

# SQLWarning


`
public


class
SQLWarning
`


`


`

`


`

`


`

`

extends https://developer.android.com/reference/java/sql/SQLException


`

`


`

|---|---|---|---|---|
| [java.lang.Object](https://developer.android.com/reference/java/lang/Object) |||||
| ↳ | [java.lang.Throwable](https://developer.android.com/reference/java/lang/Throwable) ||||
|   | ↳ | [java.lang.Exception](https://developer.android.com/reference/java/lang/Exception) |||
|   |   | ↳ | [java.sql.SQLException](https://developer.android.com/reference/java/sql/SQLException) ||
|   |   |   | ↳ | java.sql.SQLWarning |

|---|
| Known direct subclasses [DataTruncation](https://developer.android.com/reference/java/sql/DataTruncation) |---|---| | [DataTruncation](https://developer.android.com/reference/java/sql/DataTruncation) | An exception thrown as a `DataTruncation` exception (on writes) or reported as a `DataTruncation` warning (on reads) when a data values is unexpectedly truncated for reasons other than its having execeeded `MaxFieldSize`. | |

<br />

*** ** * ** ***

<br />

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`,
and `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 also:**

- `https://developer.android.com/reference/java/sql/Connection#getWarnings()`
- `https://developer.android.com/reference/java/sql/Statement#getWarnings()`
- `https://developer.android.com/reference/java/sql/ResultSet#getWarnings()`

## Summary

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/java/sql/SQLWarning#SQLWarning()() ` Constructs a `SQLWarning` object. |
| ` https://developer.android.com/reference/java/sql/SQLWarning#SQLWarning(java.lang.String)(https://developer.android.com/reference/java/lang/String reason) ` Constructs a `SQLWarning` object with a given `reason`. |
| ` https://developer.android.com/reference/java/sql/SQLWarning#SQLWarning(java.lang.String,%20java.lang.String)(https://developer.android.com/reference/java/lang/String reason, https://developer.android.com/reference/java/lang/String SQLState) ` Constructs a `SQLWarning` object with a given `reason` and `SQLState`. |
| ` https://developer.android.com/reference/java/sql/SQLWarning#SQLWarning(java.lang.String,%20java.lang.String,%20int)(https://developer.android.com/reference/java/lang/String reason, https://developer.android.com/reference/java/lang/String SQLState, int vendorCode) ` Constructs a `SQLWarning` object with a given `reason`, `SQLState` and `vendorCode`. |
| ` https://developer.android.com/reference/java/sql/SQLWarning#SQLWarning(java.lang.String,%20java.lang.String,%20int,%20java.lang.Throwable)(https://developer.android.com/reference/java/lang/String reason, https://developer.android.com/reference/java/lang/String SQLState, int vendorCode, https://developer.android.com/reference/java/lang/Throwable cause) ` Constructs a`SQLWarning` object with a given `reason`, `SQLState`, `vendorCode` and `cause`. |
| ` https://developer.android.com/reference/java/sql/SQLWarning#SQLWarning(java.lang.String,%20java.lang.String,%20java.lang.Throwable)(https://developer.android.com/reference/java/lang/String reason, https://developer.android.com/reference/java/lang/String SQLState, https://developer.android.com/reference/java/lang/Throwable cause) ` Constructs a `SQLWarning` object with a given `reason`, `SQLState` and `cause`. |
| ` https://developer.android.com/reference/java/sql/SQLWarning#SQLWarning(java.lang.String,%20java.lang.Throwable)(https://developer.android.com/reference/java/lang/String reason, https://developer.android.com/reference/java/lang/Throwable cause) ` Constructs a `SQLWarning` object with a given `reason` and `cause`. |
| ` https://developer.android.com/reference/java/sql/SQLWarning#SQLWarning(java.lang.Throwable)(https://developer.android.com/reference/java/lang/Throwable cause) ` Constructs a `SQLWarning` object with a given `cause`. |

| ### Public methods ||
|---|---|
| ` https://developer.android.com/reference/java/sql/SQLWarning` | ` https://developer.android.com/reference/java/sql/SQLWarning#getNextWarning()() ` Retrieves the warning chained to this `SQLWarning` object by `setNextWarning`. |
| ` void` | ` https://developer.android.com/reference/java/sql/SQLWarning#setNextWarning(java.sql.SQLWarning)(https://developer.android.com/reference/java/sql/SQLWarning w) ` Adds a `SQLWarning` object to the end of the chain. |

| ### Inherited methods |
|---|---|
| From class ` https://developer.android.com/reference/java/sql/SQLException ` |---|---| | ` int` | ` https://developer.android.com/reference/java/sql/SQLException#getErrorCode()() ` Retrieves the vendor-specific exception code for this `SQLException` object. | | ` https://developer.android.com/reference/java/sql/SQLException` | ` https://developer.android.com/reference/java/sql/SQLException#getNextException()() ` Retrieves the exception chained to this `SQLException` object by setNextException(SQLException ex). | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/sql/SQLException#getSQLState()() ` Retrieves the SQLState for this `SQLException` object. | | ` https://developer.android.com/reference/java/util/Iterator<https://developer.android.com/reference/java/lang/Throwable>` | ` https://developer.android.com/reference/java/sql/SQLException#iterator()() ` Returns an iterator over the chained SQLExceptions. | | ` void` | ` https://developer.android.com/reference/java/sql/SQLException#setNextException(java.sql.SQLException)(https://developer.android.com/reference/java/sql/SQLException ex) ` Adds an `SQLException` object to the end of the chain. | ||
| From class ` https://developer.android.com/reference/java/lang/Throwable ` |---|---| | ` final void` | ` https://developer.android.com/reference/java/lang/Throwable#addSuppressed(java.lang.Throwable)(https://developer.android.com/reference/java/lang/Throwable exception) ` Appends the specified exception to the exceptions that were suppressed in order to deliver this exception. | | ` https://developer.android.com/reference/java/lang/Throwable` | ` https://developer.android.com/reference/java/lang/Throwable#fillInStackTrace()() ` Fills in the execution stack trace. | | ` https://developer.android.com/reference/java/lang/Throwable` | ` https://developer.android.com/reference/java/lang/Throwable#getCause()() ` Returns the cause of this throwable or `null` if the cause is nonexistent or unknown. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Throwable#getLocalizedMessage()() ` Creates a localized description of this throwable. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Throwable#getMessage()() ` Returns the detail message string of this throwable. | | ` https://developer.android.com/reference/java/lang/StackTraceElement` | ` https://developer.android.com/reference/java/lang/Throwable#getStackTrace()() ` Provides programmatic access to the stack trace information printed by `https://developer.android.com/reference/java/lang/Throwable#printStackTrace()`. | | ` final https://developer.android.com/reference/java/lang/Throwable` | ` https://developer.android.com/reference/java/lang/Throwable#getSuppressed()() ` Returns an array containing all of the exceptions that were suppressed, typically by the `try`-with-resources statement, in order to deliver this exception. | | ` https://developer.android.com/reference/java/lang/Throwable` | ` https://developer.android.com/reference/java/lang/Throwable#initCause(java.lang.Throwable)(https://developer.android.com/reference/java/lang/Throwable cause) ` Initializes the *cause* of this throwable to the specified value. | | ` void` | ` https://developer.android.com/reference/java/lang/Throwable#printStackTrace()() ` Prints this throwable and its backtrace to the standard error stream. | | ` void` | ` https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintWriter)(https://developer.android.com/reference/java/io/PrintWriter s) ` Prints this throwable and its backtrace to the specified print writer. | | ` void` | ` https://developer.android.com/reference/java/lang/Throwable#printStackTrace(java.io.PrintStream)(https://developer.android.com/reference/java/io/PrintStream s) ` Prints this throwable and its backtrace to the specified print stream. | | ` void` | ` https://developer.android.com/reference/java/lang/Throwable#setStackTrace(java.lang.StackTraceElement[])(https://developer.android.com/reference/java/lang/StackTraceElement stackTrace) ` Sets the stack trace elements that will be returned by `https://developer.android.com/reference/java/lang/Throwable#getStackTrace()` and printed by `https://developer.android.com/reference/java/lang/Throwable#printStackTrace()` and related methods. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Throwable#toString()() ` Returns a short description of this throwable. | ||
| From class ` https://developer.android.com/reference/java/lang/Object ` |---|---| | ` https://developer.android.com/reference/java/lang/Object` | ` https://developer.android.com/reference/java/lang/Object#clone()() ` Creates and returns a copy of this object. | | ` boolean` | ` https://developer.android.com/reference/java/lang/Object#equals(java.lang.Object)(https://developer.android.com/reference/java/lang/Object obj) ` Indicates whether some other object is "equal to" this one. | | ` void` | ` https://developer.android.com/reference/java/lang/Object#finalize()() ` Called by the garbage collector on an object when garbage collection determines that there are no more references to the object. | | ` final https://developer.android.com/reference/java/lang/Class<?>` | ` https://developer.android.com/reference/java/lang/Object#getClass()() ` Returns the runtime class of this `Object`. | | ` int` | ` https://developer.android.com/reference/java/lang/Object#hashCode()() ` Returns a hash code value for the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notify()() ` Wakes up a single thread that is waiting on this object's monitor. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#notifyAll()() ` Wakes up all threads that are waiting on this object's monitor. | | ` https://developer.android.com/reference/java/lang/String` | ` https://developer.android.com/reference/java/lang/Object#toString()() ` Returns a string representation of the object. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long,%20int)(long timeoutMillis, int nanos) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait(long)(long timeoutMillis) ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*, or until a certain amount of real time has elapsed. | | ` final void` | ` https://developer.android.com/reference/java/lang/Object#wait()() ` Causes the current thread to wait until it is awakened, typically by being *notified* or *interrupted*. | ||
| From interface ` https://developer.android.com/reference/java/lang/Iterable ` |---|---| | ` default void` | ` https://developer.android.com/reference/java/lang/Iterable#forEach(java.util.function.Consumer<?%20super%20T>)(https://developer.android.com/reference/java/util/function/Consumer<? super T> action) ` Performs the given action for each element of the `Iterable` until all elements have been processed or the action throws an exception. | | ` abstract https://developer.android.com/reference/java/util/Iterator<https://developer.android.com/reference/java/lang/Throwable>` | ` https://developer.android.com/reference/java/lang/Iterable#iterator()() ` Returns an iterator over elements of type `T`. | | ` default https://developer.android.com/reference/java/util/Spliterator<https://developer.android.com/reference/java/lang/Throwable>` | ` https://developer.android.com/reference/java/lang/Iterable#spliterator()() ` Creates a `https://developer.android.com/reference/java/util/Spliterator` over the elements described by this `Iterable`. | ||

## Public constructors

### SQLWarning

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public SQLWarning ()
```

Constructs a `SQLWarning` object.
The `reason`, `SQLState` are initialized
to `null` and the vendor code is initialized to 0.

The `cause` is not initialized, and may subsequently be
initialized by a call to the
`https://developer.android.com/reference/java/lang/Throwable#initCause(java.lang.Throwable)` method.

<br />

<br />

### SQLWarning

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public SQLWarning (String reason)
```

Constructs a `SQLWarning` object
with a given `reason`. The `SQLState`
is initialized to `null` and the vender code is initialized
to 0.

The `cause` is not initialized, and may subsequently be
initialized by a call to the
`https://developer.android.com/reference/java/lang/Throwable#initCause(java.lang.Throwable)` method.

<br />

<br />

| Parameters ||
|---|---|
| `reason` | `String`: a description of the warning <br /> |

### SQLWarning

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public SQLWarning (String reason, 
                String SQLState)
```

Constructs a `SQLWarning` object
with a given `reason` and `SQLState`.

The `cause` is not initialized, and may subsequently be
initialized by a call to the
`https://developer.android.com/reference/java/lang/Throwable#initCause(java.lang.Throwable)` method. The vendor code
is initialized to 0.

<br />

<br />

| Parameters ||
|---|---|
| `reason` | `String`: a description of the warning <br /> |
| `SQLState` | `String`: an XOPEN or SQL:2003 code identifying the warning <br /> |

### SQLWarning

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public SQLWarning (String reason, 
                String SQLState, 
                int vendorCode)
```

Constructs a `SQLWarning` object
with a given `reason`, `SQLState` and
`vendorCode`.

The `cause` is not initialized, and may subsequently be
initialized by a call to the
`https://developer.android.com/reference/java/lang/Throwable#initCause(java.lang.Throwable)` method.

<br />

<br />

| Parameters ||
|---|---|
| `reason` | `String`: a description of the warning <br /> |
| `SQLState` | `String`: an XOPEN or SQL:2003 code identifying the warning <br /> |
| `vendorCode` | `int`: a database vendor-specific warning code <br /> |

### SQLWarning

Added in [API level 9](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public SQLWarning (String reason, 
                String SQLState, 
                int vendorCode, 
                Throwable cause)
```

Constructs a`SQLWarning` object
with a given
`reason`, `SQLState`, `vendorCode`
and `cause`.

<br />

<br />

| Parameters ||
|---|---|
| `reason` | `String`: a description of the warning <br /> |
| `SQLState` | `String`: an XOPEN or SQL:2003 code identifying the warning <br /> |
| `vendorCode` | `int`: a database vendor-specific warning code <br /> |
| `cause` | `Throwable`: the underlying reason for this `SQLWarning` (which is saved for later retrieval by the `getCause()` method); may be null indicating the cause is non-existent or unknown. <br /> |

### SQLWarning

Added in [API level 9](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public SQLWarning (String reason, 
                String SQLState, 
                Throwable cause)
```

Constructs a `SQLWarning` object
with a given
`reason`, `SQLState` and `cause`.
The vendor code is initialized to 0.

<br />

<br />

| Parameters ||
|---|---|
| `reason` | `String`: a description of the warning <br /> |
| `SQLState` | `String`: an XOPEN or SQL:2003 code identifying the warning <br /> |
| `cause` | `Throwable`: the underlying reason for this `SQLWarning` (which is saved for later retrieval by the `getCause()` method); may be null indicating the cause is non-existent or unknown. <br /> |

### SQLWarning

Added in [API level 9](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public SQLWarning (String reason, 
                Throwable cause)
```

Constructs a `SQLWarning` object
with a given
`reason` and `cause`.
The `SQLState` is initialized to `null`
and the vendor code is initialized to 0.

<br />

<br />

| Parameters ||
|---|---|
| `reason` | `String`: a description of the warning <br /> |
| `cause` | `Throwable`: the underlying reason for this `SQLWarning` (which is saved for later retrieval by the `getCause()` method); may be null indicating the cause is non-existent or unknown. <br /> |

### SQLWarning

Added in [API level 9](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public SQLWarning (Throwable cause)
```

Constructs a `SQLWarning` object
with a given `cause`.
The `SQLState` is initialized
to `null` and the vendor code is initialized to 0.
The `reason` is initialized to `null` if
`cause==null` or to `cause.toString()` if
`cause!=null`.

<br />

<br />

| Parameters ||
|---|---|
| `cause` | `Throwable`: the underlying reason for this `SQLWarning` (which is saved for later retrieval by the `getCause()` method); may be null indicating the cause is non-existent or unknown. <br /> |

## Public methods

### getNextWarning

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public SQLWarning getNextWarning ()
```

Retrieves the warning chained to this `SQLWarning` object by
`setNextWarning`.

<br />

| Returns ||
|---|---|
| `https://developer.android.com/reference/java/sql/SQLWarning` | the next `SQLException` in the chain; `null` if none <br /> |

**See also:**

- `https://developer.android.com/reference/java/sql/SQLWarning#setNextWarning(java.sql.SQLWarning)`

### setNextWarning

Added in [API level 1](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)

```
public void setNextWarning (SQLWarning w)
```

Adds a `SQLWarning` object to the end of the chain.

<br />

| Parameters ||
|---|---|
| `w` | `SQLWarning`: the new end of the `SQLException` chain <br /> |

**See also:**

- `https://developer.android.com/reference/java/sql/SQLWarning#getNextWarning()`