Proxy

class Proxy

Représente un proxy qui peut être utilisé par CronetEngine.

La manière dont les requêtes HTTP sont envoyées via des proxys dépend de plusieurs facteurs. Par exemple : le type de proxy utilisé, la version HTTP utilisée, si la requête est envoyée à une destination avec un schéma d'URI http ou https. De plus, l'établissement ou non d'un tunnel via le proxy dépend également de ces facteurs.

Résumé

Types imbriqués

Contrôle les tunnels établis via HTTP CONNECT.

Actions qui peuvent être effectuées en réponse à l'appel de onResponseReceived.

Représente une requête HTTP CONNECT envoyée au serveur proxy.
@Retention(value = RetentionPolicy.SOURCE)
@IntDef(value = )
annotation Proxy.Scheme

Schémas compatibles lors de la définition d'un proxy.

Constantes
const Int

Établit une connexion en texte brut au proxy lui-même.
const Int

Établit une connexion sécurisée au proxy lui-même.

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

Construit un proxy HTTP.

Constantes

SCHEME_HTTP

const val SCHEME_HTTP = 0: Int

Établit une connexion en texte brut au proxy lui-même.

SCHEME_HTTPS

const val SCHEME_HTTPS = 1: Int

Établit une connexion sécurisée au proxy lui-même.

Fonctions publiques

createHttpProxy

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

Construit un proxy HTTP.

Lorsque vous envoyez des requêtes HTTP via un proxy HTTP, l'appel ou non de callback dépend du schéma d'URI de la destination :

  • Pour les destinations avec un schéma d'URI https, CronetEngine établit un tunnel via le proxy. Le tunnel est établi via une requête HTTP CONNECT. Dans ce cas, callback est appelé pour contrôler la requête HTTP CONNECT utilisée pour établir le tunnel.
  • Pour les destinations avec un schéma d'URI http, CronetEngine envoie une requête HTTP contenant l'URI complet de la destination au proxy. Dans ce cas, callback n'est pas appelé.
Paramètres
@Proxy.Scheme scheme: Int

Scheme qui, avec host et port, identifie ce proxy.
host: String

Hôte non vide qui, avec scheme et port, identifie ce proxy.
port: @IntRange(from = 0, to = 65535) Int

Port qui, avec scheme et host, identifie ce proxy. Sa valeur doit être comprise entre 0 et 65 535.
executor: Executor

Exécuteur où callback sera appelé.
callback: Proxy.HttpConnectCallback

Rappel qui permet d'interagir avec la requête HTTP CONNECT et sa réponse, que CronetEngine envoie pour établir des tunnels via le proxy.