UploadDataProvider

public void close()

Được gọi khi một yêu cầu không còn cần UploadDataProvider này nữa, để các tài nguyên (chẳng hạn như tệp) có thể được giải phóng một cách rõ ràng.

public abstract long getLength()

Nếu đây là một tệp tải lên không phân đoạn, thì phương thức này sẽ trả về độ dài của tệp tải lên. Phải luôn trả về -1 nếu đây là một tệp tải lên được chia thành nhiều phần.

public abstract void read(UploadDataSink uploadDataSink, ByteBuffer byteBuffer)

Đọc dữ liệu tải lên vào byteBuffer. Sau khi hoàn tất, vị trí của vùng đệm sẽ được cập nhật thành cuối cùng của các byte đã đọc. Giới hạn của vùng đệm không thay đổi. Mỗi lệnh gọi của phương thức này phải được theo sau bằng một lệnh gọi duy nhất, có thể đồng bộ hoặc không đồng bộ, đến uploadDataSink: onReadSucceeded khi thành công hoặc onReadError khi thất bại. Không có thao tác đọc hay tua lại nào được gọi cho đến khi một trong các phương thức đó hoặc phương thức còn lại được gọi. Ngay cả khi UrlRequest được liên kết bị huỷ, bạn vẫn phải gọi một trong hai trước khi có thể giải phóng tài nguyên một cách an toàn. Việc gửi một ngoại lệ cũng sẽ dẫn đến việc giải phóng tài nguyên và yêu cầu bị lỗi.

Lưu ý: Đối với các lượt tải lên không phân đoạn, bạn chỉ nên gọi onReadSucceeded khi quá trình đọc đã thành công và ít nhất một byte đã được đọc vào byteBuffer. Đối với các tệp tải lên theo khối (Chưa biết kích thước dữ liệu), bạn có thể gọi onReadSucceeded cho khối cuối cùng bằng vùng đệm byte trống.

public abstract void rewind(UploadDataSink uploadDataSink)

Tua dữ liệu tải lên về đầu. Được gọi khi Cronet yêu cầu trình cung cấp dữ liệu tải lên ở trạng thái tương đương như thể read chưa bao giờ được gọi.

Để báo hiệu rằng thao tác đã hoàn tất, các phương thức triển khai của hàm này phải gọi onRewindSucceeded để cho biết thành công hoặc onRewindError khi thất bại. Ngay cả khi UrlRequest được liên kết bị huỷ, bạn vẫn phải gọi một trong hai trước khi có thể giải phóng tài nguyên một cách an toàn. Việc gửi một trường hợp ngoại lệ từ phương thức này tương đương với việc gọi onRewindError. Nếu không hỗ trợ tua lại (ví dụ: nếu đọc từ một luồng phát một lần), thì thao tác này sẽ gọi ngay onRewindError.

Người triển khai có thể giả định một cách an toàn rằng cả read và lệnh gọi rewind đồng thời sẽ không được phát hành cho đến khi chúng thông báo cho sink rằng quá trình tua lại đã hoàn tất, như mô tả trong đoạn trước.

Phương thức này được Cronet sử dụng nội bộ nếu phần nội dung cần được tải lên nhiều lần. Điều này có thể xảy ra trong nhiều tình huống khác nhau, chẳng hạn như khi theo lệnh chuyển hướng hoặc khi thử lại các yêu cầu sau khi hết thời gian chờ hoặc ngắt kết nối mạng. Xin lưu ý rằng mặc dù việc triển khai tính năng tua lại thường là không bắt buộc, nhưng những yêu cầu cần đến tính năng này sẽ không thành công trừ phi bạn triển khai tính năng tua lại.