UrlRequest.Callback

abstract class UrlRequest.Callback

Subclass langsung yang diketahui
ImplicitFlowControlCallback

Implementasi UrlRequest.Callback yang menghilangkan kesulitan dalam mengelola siklus proses permintaan, dan secara otomatis melanjutkan untuk membaca seluruh respons.
Subclass tidak langsung yang diketahui
ByteArrayCronetCallback

Spesialisasi InMemoryTransformCronetCallback yang menampilkan byte isi secara verbatim tanpa interpretasi apa pun.
InMemoryTransformCronetCallback

Callback Cronet abstrak yang membaca seluruh isi ke memori dan secara opsional mendeserialisasi isi sebelum meneruskannya kembali ke penerbit permintaan HTTP.
JsonCronetCallback

Spesialisasi InMemoryTransformCronetCallback yang menafsirkan isi respons sebagai JSON.
StringCronetCallback

Spesialisasi InMemoryTransformCronetCallback yang menafsirkan isi respons sebagai string.

Pengguna Cronet memperluas class ini untuk menerima callback yang menunjukkan progres UrlRequest yang sedang diproses. Instance class ini diteruskan ke konstruktor UrlRequest.Builder saat membuat UrlRequest.

Catatan: Semua metode akan dipanggil di thread java.util.concurrent.Executor yang digunakan selama pembuatan UrlRequest.

Ringkasan

Konstruktor publik

Fungsi publik
Unit
onCanceled(request: UrlRequest!, info: UrlResponseInfo!)

Dipanggil jika permintaan dibatalkan melalui cancel.
abstract Unit
onFailed(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    error: CronetException!
)

Dipanggil jika permintaan gagal karena alasan apa pun setelah start.
abstract Unit
onReadCompleted(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    byteBuffer: ByteBuffer!
)

Dipanggil setiap kali isi respons telah dibaca.
abstract Unit
onRedirectReceived(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    newLocationUrl: String!
)

Dipanggil setiap kali pengalihan terjadi.
abstract Unit

Dipanggil saat kumpulan header terakhir, setelah semua pengalihan, diterima.
abstract Unit
onSucceeded(request: UrlRequest!, info: UrlResponseInfo!)

Dipanggil saat permintaan berhasil diselesaikan.

Konstruktor publik

Callback

Callback()

Fungsi publik

onCanceled

fun onCanceled(request: UrlRequest!, info: UrlResponseInfo!): Unit

Dipanggil jika permintaan dibatalkan melalui cancel. Setelah dipanggil, tidak ada metode Callback lain yang akan dipanggil. Implementasi default tidak melakukan tindakan apa pun.

Parameter
request: UrlRequest!

Permintaan yang dibatalkan.
info: UrlResponseInfo!

Informasi respons. Mungkin null jika tidak ada respons yang diterima.

onFailed

abstract fun onFailed(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    error: CronetException!
): Unit

Dipanggil jika permintaan gagal karena alasan apa pun setelah start. Setelah dipanggil, tidak ada metode Callback lain yang akan dipanggil. error memberikan informasi tentang kegagalan.

Parameter
request: UrlRequest!

Permintaan yang gagal.
info: UrlResponseInfo!

Informasi respons. Mungkin null jika tidak ada respons yang diterima.
error: CronetException!

informasi tentang error.

onReadCompleted

abstract fun onReadCompleted(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    byteBuffer: ByteBuffer!
): Unit

Dipanggil setiap kali isi respons telah dibaca. Hanya sebagian buffer yang dapat diisi, meskipun seluruh isi respons belum digunakan. Dengan pengecualian onCanceled(), tidak ada metode Callback lain yang akan dipanggil untuk permintaan, termasuk onSucceeded() dan onFailed(), hingga UrlRequest.read() dipanggil untuk mencoba melanjutkan membaca isi respons.

Parameter
request: UrlRequest!

Permintaan yang menerima data.
info: UrlResponseInfo!

Informasi respons.
byteBuffer: ByteBuffer!

Buffer yang diteruskan ke UrlRequest.read(), yang kini berisi data yang diterima. Posisi buffer diperbarui ke akhir data yang diterima. Batas buffer tidak diubah.
Menampilkan
java.lang.Exception

jika terjadi error saat memproses penyelesaian baca. onFailed akan dipanggil dengan pengecualian yang dilempar ditetapkan sebagai penyebab CallbackException.

onRedirectReceived

abstract fun onRedirectReceived(
    request: UrlRequest!,
    info: UrlResponseInfo!,
    newLocationUrl: String!
): Unit

Dipanggil setiap kali pengalihan terjadi. Ini hanya akan dipanggil di antara panggilan ke start dan onResponseStarted(). Isi respons pengalihan, jika ada, akan diabaikan. Pengalihan tidak akan diikuti hingga metode followRedirect URLRequest dipanggil, baik secara sinkron maupun asinkron.

Parameter
request: UrlRequest!

Meminta untuk dialihkan.
info: UrlResponseInfo!

Informasi respons.
newLocationUrl: String!

Lokasi tempat permintaan dialihkan.
Menampilkan
java.lang.Exception

jika terjadi error saat memproses pengalihan. onFailed akan dipanggil dengan pengecualian yang dilempar ditetapkan sebagai penyebab CallbackException.

onResponseStarted

abstract fun onResponseStarted(request: UrlRequest!, info: UrlResponseInfo!): Unit

Dipanggil saat kumpulan header terakhir, setelah semua pengalihan, diterima. Hanya akan dipanggil satu kali untuk setiap permintaan. Dengan pengecualian onCanceled(), tidak ada metode Callback lain yang akan dipanggil untuk permintaan, termasuk onSucceeded() dan onFailed(), hingga UrlRequest.read() dipanggil untuk mencoba mulai membaca isi respons.

Parameter
request: UrlRequest!

Permintaan yang dimulai untuk mendapatkan respons.
info: UrlResponseInfo!

Informasi respons.
Menampilkan
java.lang.Exception

jika terjadi error saat memproses awal respons. onFailed akan dipanggil dengan pengecualian yang dilempar ditetapkan sebagai penyebab CallbackException.

onSucceeded

abstract fun onSucceeded(request: UrlRequest!, info: UrlResponseInfo!): Unit

Dipanggil saat permintaan berhasil diselesaikan. Setelah dipanggil, tidak ada metode Callback lain yang akan dipanggil.

Parameter
request: UrlRequest!

Permintaan yang berhasil.
info: UrlResponseInfo!

Informasi respons.