พร็อกซี

class Proxy

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

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

สรุป

ประเภทที่ซ้อนกัน

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

การดำเนินการที่ทำได้เพื่อตอบสนองต่อการเรียก onResponseReceived

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

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

ค่าคงที่
const Int

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

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

ฟังก์ชันสาธารณะ
java-static Proxy
createHttpProxy(
    @Proxy.Scheme scheme: Int,
    host: String,
    port: @IntRange(from = 0, to = 65535) Int,
    executor: Executor,
    callback: Proxy.HttpConnectCallback
)

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

ค่าคงที่

SCHEME_HTTP

const val SCHEME_HTTP = 0: Int

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

SCHEME_HTTPS

const val SCHEME_HTTPS = 1: Int

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

ฟังก์ชันสาธารณะ

createHttpProxy

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

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

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

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

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

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

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

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

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