Chu kỳ yêu cầu Cronet

Tìm hiểu về vòng đời của các yêu cầu được tạo bằng Cronet và cách quản lý các yêu cầu đó bằng các phương thức gọi lại do thư viện cung cấp.

Tổng quan về vòng đời

Các yêu cầu mạng được tạo bằng Thư viện Cronet được biểu thị bằng lớp UrlRequest. Bạn cần nắm được các khái niệm quan trọng sau đây về vòng đời của UrlRequest:

Tiểu bang

Trạng thái là một điều kiện cụ thể mà yêu cầu xảy ra tại một thời điểm cụ thể. Các đối tượng UrlRequest được tạo bằng Thư viện Cronet di chuyển qua nhiều trạng thái trong vòng đời của chúng. Vòng đời yêu cầu bao gồm trạng thái ban đầu cũng như nhiều trạng thái chuyển tiếp và trạng thái cuối cùng.

Phương thức UrlRequest

Ứng dụng có thể gọi các phương thức cụ thể trên các đối tượng UrlRequest tuỳ thuộc vào trạng thái. Các phương thức này sẽ chuyển yêu cầu từ trạng thái này sang trạng thái khác.

Phương thức Callback

Bằng cách triển khai các phương thức của lớp UrlRequest.Callback, ứng dụng của bạn có thể nhận được thông tin cập nhật về tiến trình của yêu cầu. Bạn có thể triển khai các phương thức gọi lại để gọi các phương thức của đối tượng UrlRequest. Các phương thức này sẽ thực hiện vòng đời từ một trạng thái sang một trạng thái khác.

Danh sách sau đây mô tả luồng của vòng đời UrlRequest:

1. Vòng đời ở trạng thái Started (Đã bắt đầu) sau khi ứng dụng của bạn gọi phương thức start().
2. Máy chủ có thể gửi phản hồi chuyển hướng. Phản hồi này sẽ đưa luồng đến phương thức onRedirectReceived(). Trong phương thức này, bạn có thể thực hiện một trong các hành động sau đây của ứng dụng:
   • Đi theo lệnh chuyển hướng bằng cách sử dụng followRedirect(). Phương thức này sẽ đưa yêu cầu trở về trạng thái Đã bắt đầu.
   • Huỷ yêu cầu bằng cách sử dụng cancel(). Phương thức này đưa yêu cầu đến phương thức onCanceled(). Tại đây, ứng dụng có thể thực hiện thêm các thao tác trước khi yêu cầu được chuyển sang trạng thái cuối cùng Đã huỷ.
3. Sau khi ứng dụng tuân theo tất cả các lệnh chuyển hướng, máy chủ sẽ gửi tiêu đề phản hồi và phương thức onResponseStarted() sẽ được gọi. Yêu cầu có trạng thái Đang chờ read(). Ứng dụng phải gọi phương thức read() để cố gắng đọc một phần nội dung phản hồi. Sau khi read() được gọi, yêu cầu sẽ ở trạng thái Đọc, trong đó có thể có những kết quả sau:
   • Hành động đọc đã thành công, nhưng có nhiều dữ liệu hơn. onReadCompleted() được gọi và yêu cầu ở trạng thái Đang chờ read() một lần nữa. Ứng dụng nên gọi lại phương thức read() để tiếp tục đọc nội dung phản hồi. Ứng dụng cũng có thể ngừng đọc yêu cầu bằng cách dùng phương thức cancel() .
   • Hành động đọc đã thành công và không còn dữ liệu nào khác. Phương thức onSucceeded() được gọi và yêu cầu hiện đang ở trạng thái cuối cùng Thành công.
   • Không thực hiện được hành động đọc. Phương thức onFailed sẽ được gọi và trạng thái cuối cùng của yêu cầu hiện là Không thành công.

Sơ đồ dưới đây cho thấy vòng đời của một đối tượng UrlRequest:

Vòng đời yêu cầu Cronet

Chú giải
Trạng thái ban đầu của	trạng thái cuối cùng
Trạng thái chuyển đổi	phương thức gọi lại
phương thức UrlRequest