Proxy

class Proxy

Đại diện cho một proxy mà CronetEngine có thể sử dụng.

Cách gửi yêu cầu HTTP thông qua các proxy phụ thuộc vào nhiều yếu tố. Ví dụ: loại proxy đang được sử dụng, phiên bản HTTP đang được sử dụng, liệu yêu cầu có đang được gửi đến một đích đến có lược đồ URI http hay https hay không. Ngoài ra, việc thiết lập đường hầm thông qua proxy hay không cũng phụ thuộc vào các yếu tố này.

Tóm tắt

Các loại lồng nhau

Kiểm soát các đường hầm được thiết lập thông qua HTTP CONNECT.

Các thao tác có thể được thực hiện để phản hồi khi onResponseReceived được gọi.

Biểu thị một yêu cầu HTTP CONNECT đang được gửi đến máy chủ proxy.
@Retention(value = RetentionPolicy.SOURCE)
@IntDef(value = )
annotation Proxy.Scheme

Các lược đồ được hỗ trợ khi xác định một proxy.

Hằng số
const Int

Thiết lập một kết nối văn bản thuần tuý với chính proxy.
const Int

Thiết lập một kết nối an toàn với chính proxy.

Hàm công khai
java-static Proxy
createHttpProxy(
    @Proxy.Scheme scheme: Int,
    host: String,
    port: @IntRange(from = 0, to = 65535) Int,
    executor: Executor,
    callback: Proxy.HttpConnectCallback
)

Tạo một proxy HTTP.

Hằng số

SCHEME_HTTP

const val SCHEME_HTTP = 0: Int

Thiết lập một kết nối văn bản thuần tuý với chính proxy.

SCHEME_HTTPS

const val SCHEME_HTTPS = 1: Int

Thiết lập một kết nối an toàn với chính proxy.

Hàm công khai

createHttpProxy

java-static fun createHttpProxy(
    @Proxy.Scheme scheme: Int,
    host: String,
    port: @IntRange(from = 0, to = 65535) Int,
    executor: Executor,
    callback: Proxy.HttpConnectCallback
): Proxy

Tạo một proxy HTTP.

Khi gửi yêu cầu HTTP thông qua một proxy HTTP, việc callback có được gọi hay không phụ thuộc vào lược đồ URI của đích đến:

  • Đối với những đích đến có lược đồ URI https, CronetEngine sẽ thiết lập một đường hầm thông qua proxy. Đường hầm được thiết lập thông qua yêu cầu HTTP CONNECT. Trong trường hợp này, callback sẽ được gọi để kiểm soát yêu cầu HTTP CONNECT dùng để thiết lập đường hầm.
  • Đối với những đích đến có lược đồ URI http, CronetEngine sẽ gửi một yêu cầu HTTP (chứa toàn bộ URI của đích đến) đến proxy. Trong trường hợp này, callback sẽ không được gọi.
Tham số
@Proxy.Scheme scheme: Int

Scheme cùng với host và port xác định proxy này.
host: String

Máy chủ lưu trữ không trống, cùng với scheme và port, xác định proxy này.
port: @IntRange(from = 0, to = 65535) Int

Cổng cùng với scheme và host xác định proxy này. Giá trị của tham số này phải nằm trong khoảng [0, 65535].
executor: Executor

Trình thực thi nơi callback sẽ được gọi.
callback: Proxy.HttpConnectCallback

Lệnh gọi lại cho phép tương tác với yêu cầu HTTP CONNECT và phản hồi của yêu cầu đó mà CronetEngine gửi để thiết lập các đường hầm thông qua proxy.