Siklus proses permintaan Cronet

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 UrlRequest yang 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 UrlRequest bergantung 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 objek UrlRequest yang membawa siklus proses dari satu status ke status lainnya.

Daftar berikut menjelaskan alur siklus proses UrlRequest:

  1. Siklus proses berada dalam status Started setelah aplikasi Anda memanggil metode start().
  2. 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 metode onCanceled() tempat aplikasi dapat melakukan operasi tambahan sebelum permintaan berpindah ke status akhir Dibatalkan.
  3. 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 metode read() untuk mencoba membaca bagian dari isi respons. Setelah aplikasi Anda memanggil read(), 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 metode read() lagi untuk melanjutkan pembacaan isi respons. Aplikasi juga dapat berhenti membaca permintaan menggunakan metode cancel().
    • 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.

Diagram berikut menunjukkan siklus proses objek UrlRequest:

Diagram siklus proses permintaan Cronet
Siklus proses permintaan Cronet

Legend
Status awal Ikon legenda status awal Cronet Status akhir Ikon legenda status akhir Cronet
Status transisi Ikon legenda status transisi Cronet Metode callback Ikon legenda metode callback Cronet
Metode Ikon legenda tindakan klien Cronet UrlRequest