پروکسی 

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 می‌سازد.

ثابت‌ها

طرح_HTTP 

const val SCHEME_HTTP = 0: Int

یک اتصال متنی ساده به خود پروکسی برقرار کنید.

طرح_HTTPS 

const val SCHEME_HTTPS = 1: Int

یک اتصال امن به خود پروکسی برقرار کنید.

کارکردهای عمومی

ایجادHttpProxy 

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 مقصد بستگی دارد:

  • برای مقاصدی با طرح URL با پروتکل https، CronetEngine یک تونل از طریق پروکسی ایجاد می‌کند. این تونل از طریق درخواست HTTP CONNECT ایجاد می‌شود. در این حالت callback برای کنترل درخواست HTTP CONNECT مورد استفاده برای ایجاد تونل فراخوانی می‌شود.
  • برای مقاصدی با طرح http URI، 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 برای ایجاد تونل‌ها از طریق پروکسی ارسال می‌کند.