Proxy

class Proxy

Reprezentuje serwer proxy, który może być używany przez CronetEngine.

Sposób wysyłania żądań HTTP przez serwery proxy zależy od wielu czynników. Na przykład od typu używanego serwera proxy, używanej wersji HTTP oraz tego, czy żądanie jest wysyłane do miejsca docelowego ze schematem URI http czy https. Ponadto to, czy tunel przez serwer proxy zostanie nawiązany, zależy od tych czynników.

Podsumowanie

Typy zagnieżdżone

Kontroluje tunele nawiązywane za pomocą HTTP CONNECT.

Działania, które można wykonać w odpowiedzi na wywołanie onResponseReceived.

Reprezentuje żądanie HTTP CONNECT wysyłane do serwera proxy.
@Retention(value = RetentionPolicy.SOURCE)
@IntDef(value = )
annotation Proxy.Scheme

Schematy obsługiwane podczas definiowania serwera proxy.

Stałe
const Int

Nawiązywanie połączenia w postaci zwykłego tekstu z samym serwerem proxy.
const Int

Nawiązywanie bezpiecznego połączenia z samym serwerem proxy.

Funkcje publiczne
java-static Proxy
createHttpProxy(
    @Proxy.Scheme scheme: Int,
    host: String,
    port: @IntRange(from = 0, to = 65535) Int,
    executor: Executor,
    callback: Proxy.HttpConnectCallback
)

Tworzy serwer proxy HTTP.

Stałe

SCHEME_HTTP

const val SCHEME_HTTP = 0: Int

Nawiązywanie połączenia w postaci zwykłego tekstu z samym serwerem proxy.

SCHEME_HTTPS

const val SCHEME_HTTPS = 1: Int

Nawiązywanie bezpiecznego połączenia z samym serwerem proxy.

Funkcje publiczne

createHttpProxy

java-static fun createHttpProxy(
    @Proxy.Scheme scheme: Int,
    host: String,
    port: @IntRange(from = 0, to = 65535) Int,
    executor: Executor,
    callback: Proxy.HttpConnectCallback
): Proxy

Tworzy serwer proxy HTTP.

Podczas wysyłania żądań HTTP przez serwer proxy HTTP to, czy callback zostanie wywołany, zależy od schematu URI miejsca docelowego:

  • W przypadku miejsc docelowych ze schematem URI https CronetEngine nawiązuje tunel przez serwer proxy. Tunel jest nawiązywany za pomocą żądania HTTP CONNECT. W takim przypadku callback zostanie wywołany, aby kontrolować żądanie HTTP CONNECT używane do nawiązania tunelu.
  • W przypadku miejsc docelowych ze schematem URI http CronetEngine wysyła do serwera proxy żądanie HTTP zawierające cały adres URI miejsca docelowego. W takim przypadku callback nie zostanie wywołany.
Parametry
@Proxy.Scheme scheme: Int

Scheme, który wraz z host i port identyfikuje ten serwer proxy.
host: String

Niepusty host, który wraz z scheme i port identyfikuje ten serwer proxy.
port: @IntRange(from = 0, to = 65535) Int

Port, który wraz z scheme i host identyfikuje ten serwer proxy. Jego wartość musi mieścić się w zakresie [0, 65535].
executor: Executor

Wykonawca, w którym zostanie wywołany callback.
callback: Proxy.HttpConnectCallback

Wywołanie zwrotne, które umożliwia interakcję z żądaniem HTTP CONNECT i jego odpowiedzią, które CronetEngine wysyła w celu nawiązania tuneli przez serwer proxy.