NetworkException

public abstract class NetworkException extends CronetException

Subclass langsung yang diketahui
QuicException

Subclass NetworkException yang berisi kode error QUIC terperinci dari QuicErrorCode.


Pengecualian diteruskan ke UrlRequest.Callback.onFailed() saat Cronet gagal memproses permintaan jaringan. Dalam hal ini, getErrorCode dan getCronetInternalErrorCode dapat digunakan untuk mendapatkan informasi lebih lanjut tentang jenis kegagalan tertentu. Jika getErrorCode menampilkan ERROR_QUIC_PROTOCOL_FAILED, pengecualian ini dapat di-casting ke QuicException yang dapat memberikan detail lebih lanjut.

Ringkasan

Konstanta

static final int

Kode error yang menunjukkan bahwa alamat IP yang dihubungi tidak dapat dijangkau, yang berarti tidak ada rute ke host atau jaringan yang ditentukan.

static final int

Kode error yang menunjukkan bahwa koneksi ditutup secara tidak terduga.

static final int

Kode error yang menunjukkan bahwa upaya koneksi ditolak.

static final int

Kode error yang menunjukkan bahwa koneksi direset secara tidak terduga.

static final int

Kode error yang menunjukkan upaya koneksi telah habis waktunya.

static final int

Kode error yang menunjukkan bahwa host yang dikirimi permintaan tidak dapat di-resolve ke alamat IP.

static final int

Kode error yang menunjukkan bahwa perangkat tidak terhubung ke jaringan mana pun.

static final int

Kode error yang menunjukkan bahwa saat permintaan diproses, konfigurasi jaringan berubah.

static final int

Kode error yang menunjukkan bahwa jenis error lain telah terjadi.

static final int

Kode error yang menunjukkan error terkait protokol QUIC.

static final int

Kode error yang menunjukkan bahwa waktu tunggu telah berakhir.

Konstruktor yang dilindungi

NetworkException(String message, Throwable cause)

Membuat pengecualian yang disebabkan oleh error jaringan.

Metode publik

abstract int

Menampilkan kode error internal Cronet.

abstract int

Menampilkan kode error, salah satunya ERROR_*.

abstract boolean

Menampilkan true jika mencoba lagi permintaan ini segera mungkin berhasil, false jika tidak.

Metode turunan

Dari java.lang.Throwable
synchronized final void
synchronized Throwable
synchronized Throwable
String
String
StackTraceElement[]
synchronized final Throwable[]
synchronized Throwable
void
void
setStackTrace(StackTraceElement[] p)
String

Konstanta

ERROR_ADDRESS_UNREACHABLE

public static final int ERROR_ADDRESS_UNREACHABLE = 9

Kode error yang menunjukkan bahwa alamat IP yang dihubungi tidak dapat dijangkau, yang berarti tidak ada rute ke host atau jaringan yang ditentukan.

ERROR_CONNECTION_CLOSED

public static final int ERROR_CONNECTION_CLOSED = 5

Kode error yang menunjukkan bahwa koneksi ditutup secara tidak terduga.

ERROR_CONNECTION_REFUSED

public static final int ERROR_CONNECTION_REFUSED = 7

Kode error yang menunjukkan bahwa upaya koneksi ditolak.

ERROR_CONNECTION_RESET

public static final int ERROR_CONNECTION_RESET = 8

Kode error yang menunjukkan bahwa koneksi direset secara tidak terduga.

ERROR_CONNECTION_TIMED_OUT

public static final int ERROR_CONNECTION_TIMED_OUT = 6

Kode error yang menunjukkan upaya koneksi telah habis waktunya.

ERROR_HOSTNAME_NOT_RESOLVED

public static final int ERROR_HOSTNAME_NOT_RESOLVED = 1

Kode error yang menunjukkan bahwa host yang dikirimi permintaan tidak dapat di-resolve ke alamat IP.

ERROR_INTERNET_DISCONNECTED

public static final int ERROR_INTERNET_DISCONNECTED = 2

Kode error yang menunjukkan bahwa perangkat tidak terhubung ke jaringan mana pun.

ERROR_NETWORK_CHANGED

public static final int ERROR_NETWORK_CHANGED = 3

Kode error yang menunjukkan bahwa saat permintaan diproses, konfigurasi jaringan berubah. Saat getErrorCode menampilkan kode ini, pengecualian ini dapat ditransmisikan ke QuicException untuk mengetahui informasi selengkapnya jika protokol QUIC digunakan.

ERROR_OTHER

public static final int ERROR_OTHER = 11

Kode error yang menunjukkan bahwa jenis error lain telah terjadi. getCronetInternalErrorCode dapat dilihat untuk mengetahui penyebab yang lebih spesifik.

ERROR_QUIC_PROTOCOL_FAILED

public static final int ERROR_QUIC_PROTOCOL_FAILED = 10

Kode error yang menunjukkan error terkait protokol QUIC. Jika getErrorCode menampilkan kode ini, pengecualian ini dapat di-casting ke QuicException untuk mengetahui informasi selengkapnya.

ERROR_TIMED_OUT

public static final int ERROR_TIMED_OUT = 4

Kode error yang menunjukkan bahwa waktu tunggu telah berakhir. Waktu tunggu yang habis saat mencoba terhubung akan dilaporkan sebagai ERROR_CONNECTION_TIMED_OUT yang lebih spesifik.

Konstruktor yang dilindungi

NetworkException

protected NetworkException(String message, Throwable cause)

Membuat pengecualian yang disebabkan oleh error jaringan.

Parameter
String message

penjelasan kegagalan.

Throwable cause

penyebab (yang disimpan untuk pengambilan nanti dengan metode getCause()). Nilai null diizinkan, dan menunjukkan bahwa penyebabnya tidak ada atau tidak diketahui.

Metode publik

getCronetInternalErrorCode

public abstract int getCronetInternalErrorCode()

Menampilkan kode error internal Cronet. Hal ini dapat memberikan diagnosis error yang lebih spesifik daripada getErrorCode, tetapi nilai konstanta tidak diekspos ke Java dan dapat berubah seiring waktu. Lihat di sini untuk mengetahui daftar nilai terbaru.

Hasil
int

Kode error internal Cronet.

getErrorCode

public abstract int getErrorCode()

Menampilkan kode error, salah satunya ERROR_*.

Hasil
int

kode error, salah satunya adalah ERROR_*.

immediatelyRetryable

public abstract boolean immediatelyRetryable()

Menampilkan true jika mencoba lagi permintaan ini segera mungkin berhasil, false jika tidak. Misalnya, menampilkan true saat getErrorCode menampilkan ERROR_NETWORK_CHANGED karena mencoba permintaan mungkin berhasil menggunakan konfigurasi jaringan baru, tetapi menampilkan false saat getErrorCode() menampilkan ERROR_INTERNET_DISCONNECTED karena mencoba lagi permintaan secara langsung akan mengalami kegagalan yang sama (sebaliknya, mencoba lagi harus ditunda hingga perangkat mendapatkan kembali konektivitas jaringan).

Hasil
boolean

true jika mencoba lagi permintaan ini segera mungkin berhasil, false jika tidak.