שרת Proxy

class Proxy

מייצג שרת proxy שאפשר להשתמש בו בשביל CronetEngine.

אופן השליחה של בקשות HTTP דרך שרתי proxy תלוי במגוון גורמים. לדוגמה: סוג ה-proxy שבו נעשה שימוש, גרסת ה-HTTP שבה נעשה שימוש, האם הבקשה נשלחת ליעד עם סכימת URI של http או https. בנוסף, השאלה אם מוקמת מנהרה דרך ה-proxy תלויה גם בגורמים האלה.

סיכום

סוגי רכיבים שהוצבו בתוך רכיבים אחרים

הגדרת מנהרות שנוצרו באמצעות HTTP CONNECT.

פעולות שאפשר לבצע בתגובה לקריאה של onResponseReceived.

מייצג בקשת HTTP CONNECT שנשלחת לשרת ה-proxy.
@Retention(value = RetentionPolicy.SOURCE)
@IntDef(value = )
annotation Proxy.Scheme

סכימות שנתמכות בהגדרת שרת proxy.

ערכים קבועים
const Int

יוצרים חיבור בטקסט גלוי לשרת ה-proxy עצמו.
const Int

יוצרים חיבור מאובטח לשרת ה-proxy עצמו.

פונקציות ציבוריות
java-static Proxy
createHttpProxy(
    @Proxy.Scheme scheme: Int,
    host: String,
    port: @IntRange(from = 0, to = 65535) Int,
    executor: Executor,
    callback: Proxy.HttpConnectCallback
)

יוצר proxy מסוג HTTP.

ערכים קבועים

SCHEME_HTTP

const val SCHEME_HTTP = 0: Int

יוצרים חיבור בטקסט גלוי לשרת ה-proxy עצמו.

SCHEME_HTTPS

const val SCHEME_HTTPS = 1: Int

יוצרים חיבור מאובטח לשרת ה-proxy עצמו.

פונקציות ציבוריות

createHttpProxy

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

יוצר proxy מסוג HTTP.

כששולחים בקשות HTTP דרך שרת proxy של HTTP, ההחלטה אם לקרוא ל-callback או לא תלויה בסכימת ה-URI של היעד:

  • ליעדים עם סכמת URI מסוג https, ‏ CronetEngine יוצר מנהרה דרך השרת הפרוקסי. המנהרה נוצרת באמצעות בקשת HTTP CONNECT. במקרה כזה, יתבצע קריאה ל- callback כדי לשלוט בבקשת HTTP CONNECT שמשמשת ליצירת המנהרה.
  • ליעדים עם סכימת URI של http,‏ CronetEngine שולח בקשת HTTP שמכילה את ה-URI המלא של היעד לשרת ה-proxy. במקרה כזה, הפונקציה callback לא תופעל.
פרמטרים
@Proxy.Scheme scheme: Int

‫Scheme, שביחד עם host ו-port מזהה את שרת ה-proxy הזה.
host: String

מארח לא ריק, שביחד עם scheme ו-port, מזהה את השרת הזה.
port: @IntRange(from = 0, to = 65535) Int

יציאה שמזהה את ה-proxy הזה, יחד עם scheme ו-host. הערך שלו חייב להיות בין 0 ל-65535.
executor: Executor

המוציא לפועל שבו תופעל callback.
callback: Proxy.HttpConnectCallback

פונקציית קריאה חוזרת שמאפשרת אינטראקציה עם בקשת ה-HTTP CONNECT והתגובה שלה, ש-CronetEngine שולח כדי ליצור מנהרות דרך השרת הפרוקסי.