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 phương thức gọi lại do thư viện cung cấp.

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

Lớp UrlRequest đại diện cho các yêu cầu mạng được tạo bằng Thư viện Cronet. Bạn cần hiểu rõ các khái niệm sau đây về vòng đời của UrlRequest:

Tiểu bang
Trạng thái là điều kiện cụ thể của yêu cầu 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 sẽ di chuyển qua nhiều trạng thái trong vòng đời của chúng. Vòng đời của yêu cầu bao gồm trạng thái ban đầu, nhiều trạng thái chuyển tiếp và trạng thái cuối cùng.
UrlRequest phương thức
Ứng dụng khách có thể gọi các phương thức cụ thể trên đối tượng UrlRequest tuỳ thuộc vào trạng thái. Các phương thức này di chuyển yêu cầu từ trạng thái này sang trạng thái khác.
Callback phương thức
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 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, giúp chuyển vòng đời từ trạng thái này sang trạng thái khác.

Danh sách sau đây mô tả quy trình của vòng đời UrlRequest:

  1. Vòng đời ở trạng thái Started (Đã bắt đầu) sau khi ứng dụng gọi phương thức start().
  2. Máy chủ có thể gửi phản hồi chuyển hướng, đưa quy trình đế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 của ứng dụng:
    • Làm theo lệnh chuyển hướng bằng followRedirect(). Phương thức này đưa yêu cầu trở lại trạng thái Đã bắt đầu.
    • Huỷ yêu cầu bằng cancel(). Phương thức này sẽ đưa yêu cầu đến phương thức onCanceled(), nơi ứng dụng có thể thực hiện các thao tác bổ sung trước khi yêu cầu chuyển sang trạng thái cuối cùng là Canceled (Đã huỷ).
  3. Sau khi ứng dụng thực hiện tất cả các lệnh chuyển hướng, máy chủ sẽ gửi tiêu đề phản hồi và Cronet sẽ gọi phương thức onResponseStarted(). Yêu cầu đang ở trạng thái Waiting for read() (Đ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 ứng dụng gọi read(), yêu cầu sẽ ở trạng thái Đang đọc, trong đó có thể có các kết quả sau:
    • Thao tác đọc thành công và có thêm dữ liệu. Cronet gọi phương thức onReadCompleted() và yêu cầu lại ở trạng thái Waiting for read() (Đang chờ đọc()). Ứng dụng có thể 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 sử dụng phương thức cancel().
    • Thao tác đọc thành công và không còn dữ liệu nào. Cronet gọi phương thức onSucceeded() và yêu cầu ở trạng thái cuối cùng là Succeeded (Thành công).
    • Thao tác đọc không thành công. Cronet gọi phương thức onFailed() và trạng thái cuối cùng của yêu cầu là Failed (Không thành công).

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

Biểu đồ vòng đời của yêu cầu Cronet
Vòng đời của yêu cầu Cronet

Huyền Thoại
Biểu tượng chú thích trạng thái ban đầu của Cronet trạng thái ban đầu Biểu tượng chú giải trạng thái cuối cùng của Cronet trạng thái cuối cùng
Biểu tượng chú giải trạng thái chuyển đổi của Cronet trạng thái chuyển tiếp Biểu tượng chú thích phương thức gọi lại Cronet phương thức gọi lại
Biểu tượng chú giải hành động của ứng dụng Cronet UrlRequest phương thức