ProxyOptions
public final class ProxyOptions
กำหนดค่าพร็อกซีที่ CronetEngine ใช้ได้
สรุป
ประเภทที่ซ้อนกัน |
|---|
@Retention(value = RetentionPolicy.SOURCE)กำหนดลักษณะการทำงานหลังจากพร็อกซีทั้งหมดใน |
ค่าคงที่ |
|
|---|---|
static final int |
อนุญาตการเข้าชมโดยตรงที่ไม่ผ่านพร็อกซี |
static final int |
ไม่อนุญาตการเข้าชมโดยตรง |
เมธอดสาธารณะ |
|
|---|---|
static @NonNull ProxyOptions |
fromProxyList(สร้างการกำหนดค่าพร็อกซีจากรายการ |
ค่าคงที่
ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT
public static final int ALL_PROXIES_FAILED_BEHAVIOR_ALLOW_DIRECT = 1
อนุญาตการเข้าชมโดยตรงที่ไม่ผ่านพร็อกซี
การดำเนินการนี้จะกำหนดลักษณะการทำงานแบบ "fail-open" กล่าวคือ หากพร็อกซีทั้งหมดใน ProxyOptions ล้มเหลว CronetEngine จะกลับไปใช้การเชื่อมต่อที่ไม่ผ่านพร็อกซี
ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT
public static final int ALL_PROXIES_FAILED_BEHAVIOR_DISALLOW_DIRECT = 0
ไม่อนุญาตการเข้าชมโดยตรง
การดำเนินการนี้จะกำหนดลักษณะการทำงานแบบ "fail-closed" กล่าวคือ หากพร็อกซีทั้งหมดใน ProxyOptions ล้มเหลว CronetEngine จะไม่กลับไปใช้การเชื่อมต่อที่ไม่ผ่านพร็อกซี
เมธอดสาธารณะ
fromProxyList
public static @NonNull ProxyOptions fromProxyList(
@NonNull List<Proxy> proxyList,
@ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior
)
สร้างการกำหนดค่าพร็อกซีจากรายการ Proxy
ระบบจะใช้พร็อกซีในรายการตามลำดับ ระบบจะใช้พร็อกซีในตำแหน่ง N+1 ก็ต่อเมื่อ CronetEngine ใช้พร็อกซีในตำแหน่ง N ไม่สำเร็จ หากพร็อกซีในตำแหน่ง N ล้มเหลวไม่ว่าด้วยเหตุผลใดก็ตาม (รวมถึงการปิดอุโมงค์ที่ทริกเกอร์ผ่าน Proxy.HttpConnectCallback) แต่พร็อกซีในตำแหน่ง N+1 สำเร็จ ระบบจะลดลำดับความสำคัญของพร็อกซีในตำแหน่ง N ชั่วคราว ขณะที่พร็อกซีมีลำดับความสำคัญลดลง ระบบจะใช้พร็อกซีดังกล่าวเป็นทางเลือกสุดท้ายเท่านั้น
| พารามิเตอร์ | |
|---|---|
@NonNull List<Proxy> proxyList |
รายการ |
@ProxyOptions.AllProxiesFailedBehavior int allProxiesFailedBehavior |
ลักษณะการทำงานของ CronetEngine หลังจากใช้พร็อกซีทั้งหมดใน |
| ส่ง | |
|---|---|
java.lang.IllegalArgumentException |
หากรายการพร็อกซีว่างเปล่าหรือมีองค์ประกอบใดเป็น |