Proxy

public final 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
public abstract class Proxy.HttpConnectCallback

Contrôle les tunnels établis via HTTP CONNECT.

Actions qui peuvent être effectuées en réponse à l'appel de onResponseReceived.
public abstract class Proxy.HttpConnectCallback.Request implements AutoCloseable

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

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

Constantes
static final int

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

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

Méthodes publiques
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
)

Construit un proxy HTTP.

Constantes

SCHEME_HTTP

public static final int SCHEME_HTTP = 0

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

SCHEME_HTTPS

public static final int SCHEME_HTTPS = 1

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

Méthodes publiques

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
)

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 int scheme

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

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

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

Exécuteur où callback sera appelé.
@NonNull Proxy.HttpConnectCallback callback

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.