UrlRequest.Builder

const val REQUEST_PRIORITY_HIGHEST = 4: Int

Mức độ ưu tiên cao nhất của yêu cầu. Đã chuyển đến setPriority.

const val REQUEST_PRIORITY_IDLE = 0: Int

Mức độ ưu tiên thấp nhất của yêu cầu. Đã chuyển đến setPriority.

const val REQUEST_PRIORITY_LOW = 2: Int

Mức độ ưu tiên thấp của yêu cầu. Đã chuyển đến setPriority.

const val REQUEST_PRIORITY_LOWEST = 1: Int

Mức độ ưu tiên yêu cầu rất thấp. Đã chuyển đến setPriority.

const val REQUEST_PRIORITY_MEDIUM = 3: Int

Mức độ ưu tiên yêu cầu ở mức trung bình. Đã chuyển đến setPriority. Đây là mức độ ưu tiên mặc định được chỉ định cho yêu cầu.

abstract fun addHeader(header: String!, value: String!): UrlRequest.Builder!

Thêm tiêu đề của yêu cầu.

fun addRequestAnnotation(annotation: Any!): UrlRequest.Builder!

Liên kết đối tượng chú thích với yêu cầu này. Bạn có thể thêm nhiều. Được truyền đến RequestFinishedInfo.Listener, hãy xem getAnnotations.

abstract fun allowDirectExecutor(): UrlRequest.Builder!

Đánh dấu rằng các trình thực thi mà yêu cầu này sẽ dùng để thông báo cho các lệnh gọi lại (đối với UploadDataProvider và UrlRequest.Callback) đang cố ý thực hiện việc thực thi nội tuyến, chẳng hạn như directExecutor của Guava hoặc java.util.concurrent.ThreadPoolExecutor.CallerRunsPolicy.

Cảnh báo: Tuỳ chọn này khiến bạn dễ vô tình chặn luồng mạng. Bạn không nên sử dụng phương thức này nếu các lệnh gọi lại của bạn thực hiện thao tác I/O trên đĩa, lấy khoá hoặc gọi vào mã khác mà bạn không kiểm soát và kiểm tra cẩn thận.

fun bindToNetwork(networkHandle: Long): UrlRequest.Builder!

Liên kết yêu cầu với mã nhận dạng mạng đã chỉ định. Cronet sẽ chỉ gửi yêu cầu này bằng mạng được liên kết với mã nhận dạng này. Nếu mạng này ngắt kết nối, yêu cầu sẽ không thành công. Lỗi chính xác sẽ phụ thuộc vào giai đoạn xử lý yêu cầu khi mạng ngắt kết nối. Bạn có thể lấy các mã nhận dạng mạng thông qua Network#getNetworkHandle. Chỉ có từ Android Marshmallow trở lên.

abstract fun build(): UrlRequest!

Tạo một UrlRequest bằng cấu hình trong Builder này. Sau đó, bạn có thể bắt đầu UrlRequest đã trả về bằng cách gọi start.

abstract fun disableCache(): UrlRequest.Builder!

Tắt bộ nhớ đệm cho yêu cầu. Nếu bạn không thiết lập bối cảnh để sử dụng bộ nhớ đệm, thì lệnh gọi này sẽ không có hiệu lực.

abstract fun setHttpMethod(method: String!): UrlRequest.Builder!

Đặt động từ phương thức HTTP để dùng cho yêu cầu này.

Giá trị mặc định khi phương thức này không được gọi là "GET" nếu yêu cầu không có nội dung hoặc "POST" nếu có.

abstract fun setPriority(priority: Int): UrlRequest.Builder!

Đặt mức độ ưu tiên của yêu cầu. Đây phải là một trong các giá trị REQUEST_PRIORITY_*. Yêu cầu được ưu tiên REQUEST_PRIORITY_MEDIUM nếu bạn không gọi phương thức này.

@UrlRequest.Experimental
fun setRawCompressionDictionary(
    dictionarySha256Hash: ByteArray!,
    dictionary: ByteBuffer!,
    dictionaryId: String!
): UrlRequest.Builder!

Cho phép Cronet sử dụng từ điển nén được chỉ định cho yêu cầu này. Khi được chỉ định, Cronet có thể báo hiệu cho máy chủ về tính khả dụng của từ điển nén nói trên. Để có hiệu lực, CronetEngine sẽ thực thi yêu cầu này phải được định cấu hình để bật một lược đồ nén hỗ trợ từ điển bên ngoài. Điều này giúp triển khai một phần draft-ietf-httpbis-compression-dictionary trong Cronet. Cronet sẽ không trực tiếp xử lý tiêu đề phản hồi "Use-As-Dictionary", thay vào đó, Cronet sẽ dựa vào trình nhúng để: xử lý các tiêu đề đó rồi gọi UrlRequest.Builder#setCompressionDictionary cho các yêu cầu khớp với quy tắc của Use-As-Dictionary; hoặc tìm nạp từ điển nén thông qua một số cơ chế ngoài băng tần khác, rồi gọi UrlRequest.Builder#setCompressionDictionary. Cronet sẽ diễn giải từ điển này là chỉ khớp với UrlRequest này. Nếu yêu cầu đó được chuyển hướng và trình nhúng quyết định tuân theo lệnh chuyển hướng, thì từ điển cũng sẽ khớp với URL mới.

fun setRequestFinishedListener(listener: RequestFinishedInfo.Listener!): UrlRequest.Builder!

Đặt một trình nghe được gọi sau khi onCanceled(), onFailed() hoặc onSucceeded() trả về.

Trình nghe được gọi cùng với thông tin đã hoàn tất yêu cầu trên một java.util.concurrent.Executor do getExecutor() cung cấp.

fun setTrafficStatsTag(tag: Int): UrlRequest.Builder!

Đặt thẻ android.net.TrafficStats để sử dụng khi tính lưu lượng truy cập socket do yêu cầu này gây ra. Hãy xem android.net.TrafficStats để biết thêm thông tin. Nếu không có thẻ nào được đặt (ví dụ: phương thức này không được gọi), thì Android sẽ tính lưu lượng truy cập ổ cắm do yêu cầu này gây ra như thể giá trị thẻ được đặt thành 0.

LƯU Ý: Việc đặt thẻ sẽ không cho phép chia sẻ các ổ cắm với các yêu cầu có thẻ khác, điều này có thể ảnh hưởng xấu đến hiệu suất bằng cách cấm chia sẻ kết nối. Nói cách khác, bạn chỉ được phép sử dụng các ổ cắm ghép kênh (ví dụ: HTTP/2 và QUIC) nếu tất cả các yêu cầu đều có cùng thẻ ổ cắm.

fun setTrafficStatsUid(uid: Int): UrlRequest.Builder!

Đặt UID cụ thể để sử dụng khi tính lưu lượng truy cập ổ cắm do yêu cầu này gây ra. Vui lòng xem android.net.TrafficStats để biết thêm thông tin. Được thiết kế để sử dụng khi thực hiện một thao tác thay cho một ứng dụng khác. Người gọi phải có quyền MODIFY_NETWORK_ACCOUNTING. Theo mặc định, lưu lượng truy cập được phân bổ cho UID của người gọi.

LƯU Ý: Việc đặt UID sẽ không cho phép chia sẻ các ổ cắm với các yêu cầu có UID khác, điều này có thể ảnh hưởng xấu đến hiệu suất bằng cách cấm chia sẻ kết nối. Nói cách khác, bạn chỉ được phép sử dụng các socket ghép kênh (ví dụ: HTTP/2 và QUIC) nếu tất cả các yêu cầu đều có cùng một UID.

abstract fun setUploadDataProvider(
    uploadDataProvider: UploadDataProvider!,
    executor: Executor!
): UrlRequest.Builder!

Đặt nhà cung cấp dữ liệu tải lên. Chuyển phương thức thành "POST" nếu không được đặt rõ ràng. Việc bắt đầu yêu cầu sẽ gây ra một ngoại lệ nếu tiêu đề Content-Type không được đặt.