พร็อกซี

public final class Proxy

แสดงถึงพร็อกซีที่ CronetEngine ใช้ได้

วิธีส่งคำขอ HTTP ผ่านพร็อกซีขึ้นอยู่กับปัจจัยหลายอย่าง เช่น ประเภทของพร็อกซีที่ใช้, เวอร์ชัน HTTP ที่ใช้, คำขอถูกส่งไปยังปลายทางที่มีสคีม URI เป็น http หรือ https นอกจากนี้ การสร้างหรือไม่สร้างอุโมงค์ผ่านพร็อกซีก็ขึ้นอยู่กับปัจจัยเหล่านี้ด้วย

สรุป

ประเภทที่ซ้อนกัน
public abstract class Proxy.HttpConnectCallback

ควบคุมอุโมงค์ที่สร้างขึ้นผ่าน HTTP CONNECT

การดำเนินการที่ทำได้เพื่อตอบสนองต่อการเรียก onResponseReceived
public abstract class Proxy.HttpConnectCallback.Request implements AutoCloseable

แสดงถึงคำขอ HTTP CONNECT ที่ส่งไปยังพร็อกซีเซิร์ฟเวอร์
@Retention(value = RetentionPolicy.SOURCE)
@IntDef(value = )
public annotation Proxy.Scheme

รูปแบบที่รองรับเมื่อกำหนดพร็อกซี

ค่าคงที่
static final int

สร้างการเชื่อมต่อแบบข้อความธรรมดากับพร็อกซีเอง
static final int

สร้างการเชื่อมต่อที่ปลอดภัยกับพร็อกซีเอง

เมธอดสาธารณะ
static @NonNull Proxy
createHttpProxy(
    @Proxy.Scheme int scheme,
    @NonNull String host,
    @IntRange(from = 0, to = 65535) int port,
    @NonNull Executor executor,
    @NonNull Proxy.HttpConnectCallback callback
)

สร้างพร็อกซี HTTP

ค่าคงที่

SCHEME_HTTP

public static final int SCHEME_HTTP = 0

สร้างการเชื่อมต่อแบบข้อความธรรมดากับพร็อกซีเอง

SCHEME_HTTPS

public static final int SCHEME_HTTPS = 1

สร้างการเชื่อมต่อที่ปลอดภัยกับพร็อกซีเอง

เมธอดสาธารณะ

createHttpProxy

public static @NonNull Proxy createHttpProxy(
    @Proxy.Scheme int scheme,
    @NonNull String host,
    @IntRange(from = 0, to = 65535) int port,
    @NonNull Executor executor,
    @NonNull Proxy.HttpConnectCallback callback
)

สร้างพร็อกซี HTTP

เมื่อส่งคำขอ HTTP ผ่านพร็อกซี HTTP การเรียก callback หรือไม่นั้นขึ้นอยู่กับสคีม URI ของปลายทาง

  • สำหรับปลายทางที่มีสคีม URI เป็น https, CronetEngine จะสร้างอุโมงค์ผ่านพร็อกซี โดยสร้างอุโมงค์ผ่านคำขอ HTTP CONNECT ในกรณีนี้ callback จะถูกเรียกเพื่อควบคุมคำขอ HTTP CONNECT ที่ใช้สร้างอุโมงค์
  • สำหรับปลายทางที่มีสคีม URI เป็น http, CronetEngine จะส่งคำขอ HTTP ที่มี URI ทั้งหมดของปลายทางไปยังพร็อกซี ในกรณีนี้ ระบบจะไม่เรียก callback
พารามิเตอร์
@Proxy.Scheme int scheme

Scheme ที่ระบุพร็อกซีนี้ร่วมกับ host และ port
@NonNull String host

โฮสต์ที่ไม่ว่างเปล่าซึ่งระบุพร็อกซีนี้ร่วมกับ scheme และ port
@IntRange(from = 0, to = 65535) int port

พอร์ตที่ระบุพร็อกซีนี้ร่วมกับ scheme และ host ค่าต้องอยู่ในช่วง [0, 65535]
@NonNull Executor executor

Executor ที่จะเรียกใช้ callback
@NonNull Proxy.HttpConnectCallback callback

Callback ที่อนุญาตให้โต้ตอบกับคำขอ HTTP CONNECT และการตอบกลับที่ CronetEngine ส่งเพื่อสร้างอุโมงค์ผ่านพร็อกซี