Bibliothèque de plug-ins HTTP Azure Core OkHttp pour Java - version 1.11.16

Article
11/03/2023

Le client HTTP Azure Core OkHttp est un plug-in pour l’API azure-core client HTTP.

Prise en main

Prérequis

Un Kit de développement Java (JDK), version 8 ou ultérieure.

Inclure le package

Inclure le fichier de nomenclature

Incluez azure-sdk-bom dans votre projet pour dépendre de la version de disponibilité générale de la bibliothèque. Dans l’extrait de code suivant, remplacez l’espace réservé {bom_version_to_target} par le numéro de version. Pour en savoir plus sur la nomenclature, consultez le README BOM du KIT DE DÉVELOPPEMENT LOGICIEL AZURE.

<dependencyManagement>
    <dependencies>
        <dependency>
            <groupId>com.azure</groupId>
            <artifactId>azure-sdk-bom</artifactId>
            <version>{bom_version_to_target}</version>
            <type>pom</type>
            <scope>import</scope>
        </dependency>
    </dependencies>
</dependencyManagement>

Incluez ensuite la dépendance directe dans la section des dépendances sans la balise de version.

<dependencies>
  <dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-core-http-okhttp</artifactId>
  </dependency>
</dependencies>

Inclure une dépendance directe

Si vous souhaitez dépendre d’une version particulière de la bibliothèque qui n’est pas présente dans la nomenclature, ajoutez la dépendance directe à votre projet comme suit.

<dependency>
    <groupId>com.azure</groupId>
    <artifactId>azure-core-http-okhttp</artifactId>
    <version>1.11.16</version>
</dependency>

Concepts clés

Exemples

Les sections suivantes fournissent plusieurs extraits de code couvrant certains des scénarios de configuration client les plus courants.

Créer un client simple
Créer un client avec proxy

Créer un client simple

Créez un client OkHttp à l’aide d’un délai d’expiration de connexion de 60 secondes et d’un délai d’expiration de lecture de 120 secondes.

HttpClient client = new OkHttpAsyncHttpClientBuilder().build();

Créer un client avec proxy

Créez un client OkHttp qui utilise un proxy.

HttpClient client = new OkHttpAsyncHttpClientBuilder()
    .proxy(new ProxyOptions(ProxyOptions.Type.HTTP, new InetSocketAddress("<proxy-host>", 8888)))
    .build();

Créer un client avec prise en charge http/2

Créez un client OkHttp qui prend en charge les protocoles HTTP/1.1 et HTTP/2, http/2 étant le protocole préféré.

// Constructs an HttpClient that supports both HTTP/1.1 and HTTP/2 with HTTP/2 being the preferred protocol.
// This is the default handling for OkHttp.
HttpClient client = new OkHttpAsyncHttpClientBuilder(new OkHttpClient.Builder()
    .protocols(Arrays.asList(Protocol.HTTP_2, Protocol.HTTP_1_1))
    .build())
    .build();

Il est également possible de créer un client OkHttp qui prend uniquement en charge HTTP/2.

// Constructs an HttpClient that only supports HTTP/2.
HttpClient client = new OkHttpAsyncHttpClientBuilder(new OkHttpClient.Builder()
    .protocols(Collections.singletonList(Protocol.H2_PRIOR_KNOWLEDGE))
    .build())
    .build();

Étapes suivantes

Prise en main des bibliothèques Azure créées à l’aide d’Azure Core.

Dépannage

Si vous rencontrez des bogues, envoyez des problèmes via GitHub Issues ou consultez StackOverflow pour le Kit de développement logiciel (SDK) Java Azure.

Activation de la journalisation

Les kits SDK Azure pour Java fournissent un article de journalisation cohérent pour faciliter la résolution des erreurs d’application et accélérer leur résolution. Les journaux produits capturent le flux d’une application avant d’atteindre l’état terminal pour faciliter la localisation du problème racine. Consultez le wiki de journalisation pour obtenir des conseils sur l’activation de la journalisation.

Contribution

Pour plus d’informations sur la contribution à ce dépôt, consultez le guide de contribution.

Fourchez-le
Créer votre branche de fonctionnalité (git checkout -b my-new-feature)
Valider vos modifications (git commit -am 'Add some feature')
Envoyer (push) vers la branche (git push origin my-new-feature)
Créer une demande de tirage

Impressions

Partager via