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

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

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

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