الخادم الوكيل

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

المنفّذ الذي سيتم استدعاء callback فيه.
@NonNull Proxy.HttpConnectCallback callback

طلب معاودة الاتصال الذي يسمح بالتفاعل مع طلب HTTP CONNECT والردّ عليه، والذي ترسله السمة CronetEngine لإنشاء أنفاق عبر الخادم الوكيل.