Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [S Extensions 7](https://developer.android.com/sdkExtensions) Summary: [Constants](https://developer.android.com/reference/android/net/http/NetworkException#constants) \| [Ctors](https://developer.android.com/reference/android/net/http/NetworkException#pubctors) \| [Methods](https://developer.android.com/reference/android/net/http/NetworkException#pubmethods) \| [Inherited Methods](https://developer.android.com/reference/android/net/http/NetworkException#inhmethods)

# NetworkException

*** ** * ** ***

` public abstract class NetworkException `   
` ` ` ` ` ` ` ` ` extends https://developer.android.com/reference/android/net/http/HttpException ` ` `

|---|---|---|---|---|---|
| [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.io.IOException](https://developer.android.com/reference/java/io/IOException) |||
|   |   |   | ↳ | [android.net.http.HttpException](https://developer.android.com/reference/android/net/http/HttpException) ||
|   |   |   |   | ↳ | android.net.http.NetworkException |

Known direct subclasses [QuicException](https://developer.android.com/reference/android/net/http/QuicException) [QuicException](https://developer.android.com/reference/android/net/http/QuicException) Subclass of `https://developer.android.com/reference/android/net/http/NetworkException` which contains a detailed [QUIC](https://www.chromium.org/quic) error code from [QuicErrorCode](https://cs.chromium.org/search/?q=symbol:%5CbQuicErrorCode%5Cb).   

*** ** * ** ***

Exception passed to `https://developer.android.com/reference/android/net/http/UrlRequest.Callback#onFailed(android.net.http.UrlRequest,%20android.net.http.UrlResponseInfo,%20android.net.http.HttpException)` when the HTTP stack fails to process a network request. In this case `https://developer.android.com/reference/android/net/http/NetworkException#getErrorCode()` can be used to get more information about the specific type of failure.

## Summary

| ### Constants ||
|---|---|
| `int` | `https://developer.android.com/reference/android/net/http/NetworkException#ERROR_ADDRESS_UNREACHABLE` Error code indicating the IP address being contacted is unreachable, meaning there is no route to the specified host or network. |
| `int` | `https://developer.android.com/reference/android/net/http/NetworkException#ERROR_CONNECTION_CLOSED` Error code indicating the connection was closed unexpectedly. |
| `int` | `https://developer.android.com/reference/android/net/http/NetworkException#ERROR_CONNECTION_REFUSED` Error code indicating the connection attempt was refused. |
| `int` | `https://developer.android.com/reference/android/net/http/NetworkException#ERROR_CONNECTION_RESET` Error code indicating the connection was unexpectedly reset. |
| `int` | `https://developer.android.com/reference/android/net/http/NetworkException#ERROR_CONNECTION_TIMED_OUT` Error code indicating the connection attempt timed out. |
| `int` | `https://developer.android.com/reference/android/net/http/NetworkException#ERROR_HOSTNAME_NOT_RESOLVED` Error code indicating the host being sent the request could not be resolved to an IP address. |
| `int` | `https://developer.android.com/reference/android/net/http/NetworkException#ERROR_INTERNET_DISCONNECTED` Error code indicating the device was not connected to any network. |
| `int` | `https://developer.android.com/reference/android/net/http/NetworkException#ERROR_NETWORK_CHANGED` Error code indicating that as the request was processed the network configuration changed. |
| `int` | `https://developer.android.com/reference/android/net/http/NetworkException#ERROR_OTHER` Error code indicating another type of error was encountered. |
| `int` | `https://developer.android.com/reference/android/net/http/NetworkException#ERROR_QUIC_PROTOCOL_FAILED` Error code indicating an error related to the [QUIC](https://www.chromium.org/quic) protocol. |
| `int` | `https://developer.android.com/reference/android/net/http/NetworkException#ERROR_TIMED_OUT` Error code indicating a timeout expired. |

| ### Public constructors ||
|---|---|
| ` https://developer.android.com/reference/android/net/http/NetworkException#NetworkException(java.lang.String,%20java.lang.Throwable)(https://developer.android.com/reference/java/lang/String message, https://developer.android.com/reference/java/lang/Throwable cause) ` Constructs an exception that is caused by a network error. |

| ### Public methods ||
|---|---|
| ` abstract int` | ` https://developer.android.com/reference/android/net/http/NetworkException#getErrorCode()() ` Returns error code, one of `https://developer.android.com/reference/android/net/http/NetworkException#ERROR_HOSTNAME_NOT_RESOLVED`. |
| ` abstract boolean` | ` https://developer.android.com/reference/android/net/http/NetworkException#isImmediatelyRetryable()() ` Returns `true` if retrying this request right away might succeed, `false` otherwise. |

### Inherited methods

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*.

## Constants

### ERROR_ADDRESS_UNREACHABLE

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [S Extensions 7](https://developer.android.com/sdkExtensions)

```
public static final int ERROR_ADDRESS_UNREACHABLE
```

Error code indicating the IP address being contacted is unreachable, meaning there is no route to the specified host or network.

<br />

Constant Value: 9 (0x00000009)

### ERROR_CONNECTION_CLOSED

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [S Extensions 7](https://developer.android.com/sdkExtensions)

```
public static final int ERROR_CONNECTION_CLOSED
```

Error code indicating the connection was closed unexpectedly.

<br />

Constant Value: 5 (0x00000005)

### ERROR_CONNECTION_REFUSED

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [S Extensions 7](https://developer.android.com/sdkExtensions)

```
public static final int ERROR_CONNECTION_REFUSED
```

Error code indicating the connection attempt was refused.

<br />

Constant Value: 7 (0x00000007)

### ERROR_CONNECTION_RESET

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [S Extensions 7](https://developer.android.com/sdkExtensions)

```
public static final int ERROR_CONNECTION_RESET
```

Error code indicating the connection was unexpectedly reset.

<br />

Constant Value: 8 (0x00000008)

### ERROR_CONNECTION_TIMED_OUT

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [S Extensions 7](https://developer.android.com/sdkExtensions)

```
public static final int ERROR_CONNECTION_TIMED_OUT
```

Error code indicating the connection attempt timed out.

<br />

Constant Value: 6 (0x00000006)

### ERROR_HOSTNAME_NOT_RESOLVED

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [S Extensions 7](https://developer.android.com/sdkExtensions)

```
public static final int ERROR_HOSTNAME_NOT_RESOLVED
```

Error code indicating the host being sent the request could not be resolved to an IP address.

<br />

Constant Value: 1 (0x00000001)

### ERROR_INTERNET_DISCONNECTED

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [S Extensions 7](https://developer.android.com/sdkExtensions)

```
public static final int ERROR_INTERNET_DISCONNECTED
```

Error code indicating the device was not connected to any network.

<br />

Constant Value: 2 (0x00000002)

### ERROR_NETWORK_CHANGED

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [S Extensions 7](https://developer.android.com/sdkExtensions)

```
public static final int ERROR_NETWORK_CHANGED
```

Error code indicating that as the request was processed the network configuration changed. When `https://developer.android.com/reference/android/net/http/NetworkException#getErrorCode()` returns this code, this exception may be cast to `https://developer.android.com/reference/android/net/http/QuicException` for more information if [QUIC](https://www.chromium.org/quic) protocol is used.

<br />

Constant Value: 3 (0x00000003)

### ERROR_OTHER

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [S Extensions 7](https://developer.android.com/sdkExtensions)

```
public static final int ERROR_OTHER
```

Error code indicating another type of error was encountered.

<br />

Constant Value: 11 (0x0000000b)

### ERROR_QUIC_PROTOCOL_FAILED

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [S Extensions 7](https://developer.android.com/sdkExtensions)

```
public static final int ERROR_QUIC_PROTOCOL_FAILED
```

Error code indicating an error related to the [QUIC](https://www.chromium.org/quic) protocol. When `https://developer.android.com/reference/android/net/http/NetworkException#getErrorCode()` returns this code, this exception can be cast to `https://developer.android.com/reference/android/net/http/QuicException` for more information.

<br />

Constant Value: 10 (0x0000000a)

### ERROR_TIMED_OUT

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [S Extensions 7](https://developer.android.com/sdkExtensions)

```
public static final int ERROR_TIMED_OUT
```

Error code indicating a timeout expired. Timeouts expiring while attempting to connect will be reported as the more specific `https://developer.android.com/reference/android/net/http/NetworkException#ERROR_CONNECTION_TIMED_OUT`.

<br />

Constant Value: 4 (0x00000004)

## Public constructors

### NetworkException

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [S Extensions 7](https://developer.android.com/sdkExtensions)

```
public NetworkException (String message, 
                Throwable cause)
```

Constructs an exception that is caused by a network error.

<br />

| Parameters ||
|---|---|
| `message` | `String`: explanation of failure. This value may be `null`. <br /> |
| `cause` | `Throwable`: the cause (which is saved for later retrieval by the `https://developer.android.com/reference/java/lang/Throwable#getCause()` method). A null value is permitted, and indicates that the cause is nonexistent or unknown. <br /> |

## Public methods

### getErrorCode

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [S Extensions 7](https://developer.android.com/sdkExtensions)

```
public abstract int getErrorCode ()
```

Returns error code, one of `https://developer.android.com/reference/android/net/http/NetworkException#ERROR_HOSTNAME_NOT_RESOLVED`.

<br />

| Returns ||
|---|---|
| `int` | error code, one of `https://developer.android.com/reference/android/net/http/NetworkException#ERROR_HOSTNAME_NOT_RESOLVED`. <br /> |

### isImmediatelyRetryable

Added in [API level 34](https://developer.android.com/guide/topics/manifest/uses-sdk-element#ApiLevels)  
Also in [S Extensions 7](https://developer.android.com/sdkExtensions)

```
public abstract boolean isImmediatelyRetryable ()
```

Returns `true` if retrying this request right away might succeed, `false` otherwise. For example returns `true` when `https://developer.android.com/reference/android/net/http/NetworkException#getErrorCode()` returns `https://developer.android.com/reference/android/net/http/NetworkException#ERROR_NETWORK_CHANGED` because trying the request might succeed using the new network configuration, but `false` when `getErrorCode()` returns `https://developer.android.com/reference/android/net/http/NetworkException#ERROR_INTERNET_DISCONNECTED` because retrying the request right away will encounter the same failure (instead retrying should be delayed until device regains network connectivity).

<br />

| Returns ||
|---|---|
| `boolean` | `true` if retrying this request right away might succeed, `false` otherwise. <br /> |