Pelajari siklus proses permintaan yang dibuat menggunakan Cronet dan cara mengelolanya menggunakan metode callback yang disediakan oleh library.
Ringkasan siklus proses
Class UrlRequest mewakili permintaan jaringan yang dibuat menggunakan Library
Cronet. Konsep berikut penting untuk memahami siklus proses UrlRequest:
- Status
- Status adalah kondisi khusus yang dimiliki permintaan pada waktu tertentu.
Objek
UrlRequestyang dibuat menggunakan Library Cronet bergerak melalui berbagai status dalam siklus prosesnya. Siklus proses permintaan mencakup status awal, serta beberapa status transisi dan akhir. - Metode
UrlRequest - Klien dapat memanggil metode tertentu pada objek
UrlRequestbergantung pada statusnya. Metode ini memindahkan permintaan dari satu status ke status lainnya. - Metode
Callback - Dengan mengimplementasikan metode class
UrlRequest.Callback, aplikasi Anda dapat menerima info terbaru tentang progres permintaan. Anda dapat mengimplementasikan metode callback untuk memanggil metode objekUrlRequestyang membawa siklus proses dari satu status ke status lainnya.
Daftar berikut menjelaskan alur siklus proses UrlRequest:
- Siklus proses berada dalam status Started setelah aplikasi Anda memanggil
metode
start(). - Server mungkin mengirimkan respons pengalihan, yang mengarahkan alur ke metode
onRedirectReceived(). Dalam metode ini, Anda dapat melakukan salah satu tindakan klien berikut:- Ikuti pengalihan menggunakan
followRedirect(). Metode ini mengembalikan permintaan ke status Dimulai. - Batalkan permintaan menggunakan
cancel(). Metode ini membawa permintaan ke metodeonCanceled()tempat aplikasi dapat melakukan operasi tambahan sebelum permintaan berpindah ke status akhir Dibatalkan.
- Ikuti pengalihan menggunakan
- Setelah aplikasi mengikuti semua pengalihan, server akan mengirimkan header respons dan Cronet akan memanggil metode
onResponseStarted(). Permintaan berada dalam status Menunggu read(). Aplikasi harus memanggil metoderead()untuk mencoba membaca bagian dari isi respons. Setelah aplikasi Anda memanggilread(), permintaan akan berada dalam status Membaca, dengan kemungkinan hasil berikut:- Tindakan pembacaan berhasil, dan ada lebih banyak data yang tersedia. Cronet
memanggil metode
onReadCompleted()dan permintaan kembali berada dalam status Menunggu read(). Aplikasi dapat memanggil metoderead()lagi untuk melanjutkan pembacaan isi respons. Aplikasi juga dapat berhenti membaca permintaan menggunakan metodecancel(). - Tindakan pembacaan berhasil, dan tidak ada lagi data yang tersedia. Cronet
memanggil metode
onSucceeded()dan permintaan berada dalam status akhir Succeeded. - Tindakan pembacaan gagal. Cronet memanggil metode
onFailed()dan status akhir permintaan adalah Failed.
- Tindakan pembacaan berhasil, dan ada lebih banyak data yang tersedia. Cronet
memanggil metode
Diagram berikut menunjukkan siklus proses objek UrlRequest:
Siklus proses permintaan Cronet
| Legend | |
|---|---|
| Status awal |
Status akhir |
| Status transisi |
Metode callback |
Metode UrlRequest |