プロキシ

public final class Proxy

CronetEngine で使用できるプロキシを表します。

プロキシ経由で HTTP リクエストが送信される方法は、さまざまな要因によって異なります。たとえば、使用されているプロキシのタイプ、使用されている HTTP バージョン、リクエストが http または https URI スキームの宛先に送信されているかどうかなどです。また、プロキシ経由のトンネルが確立されるかどうかも、これらの要因によって決まります。

概要

ネストされた型
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 スキームによって異なります。

  • https URI スキームの宛先の場合、CronetEngine はプロキシ経由でトンネルを確立します。トンネルは HTTP CONNECT リクエストを介して確立されます。この場合、 callback が呼び出され、トンネルの確立に使用される HTTP CONNECT リクエストを制御します。
  • http URI スキームの宛先の場合、CronetEngine は宛先の URI 全体を含む HTTP リクエストをプロキシに送信します。この場合、 callback は呼び出されません。
パラメータ
@Proxy.Scheme int scheme

host と port とともに、このプロキシを識別する Scheme。
@NonNull String host

scheme と port とともにこのプロキシを識別する空でないホスト。
@IntRange(from = 0, to = 65535) int port

scheme と host とともにこのプロキシを識別するポート。値は [0, 65535] の範囲内である必要があります。
@NonNull Executor executor

callback が呼び出されるエグゼキュータ。
@NonNull Proxy.HttpConnectCallback callback

CronetEngine がプロキシ経由でトンネルを確立するために送信する HTTP CONNECT リクエストとそのレスポンスを操作できるコールバック。