پروکسی 

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

ثابت‌ها

طرح_HTTP 

public static final int SCHEME_HTTP = 0

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

طرح_HTTPS 

public static final int SCHEME_HTTPS = 1

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

روش‌های عمومی

ایجادHttpProxy 

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

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