Lire en anglais

Partager via

Bibliothèque partagée Azure Core pour Java - version 1.11.0

  • Article

Build Documentation

Azure Core fournit des primitives, des abstractions et des helpers partagés pour les bibliothèques clientes modernes du SDK Azure Java. Ces bibliothèques suivent les instructions de conception du Kit de développement logiciel (SDK) Azure pour Java et peuvent être facilement identifiées par des noms de package commençant com.azure par et des noms de modules commençant par azure-, par exemple com.azure.storage.blobs , se trouvent dans le /sdk/storage/azure-storage-blob répertoire. Vous trouverez ici une liste plus complète des bibliothèques clientes utilisant Azure Core.

Azure Core permet aux bibliothèques clientes d’exposer des fonctionnalités communes de manière cohérente, de sorte qu’une fois que vous avez appris à utiliser ces API dans une bibliothèque cliente, vous saurez comment les utiliser dans d’autres bibliothèques clientes.

Prise en main

Prérequis

Inclure le package

En règle générale, vous n’avez pas besoin d’installer ou de dépendre d’Azure Core, mais il est téléchargé de manière transitive par votre outil de génération lorsque vous dépendez des bibliothèques clientes qui l’utilisent.

XML 
<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-core</artifactId>
  <version>1.11.0</version>
</dependency>

Concepts clés

Les concepts clés d’Azure Core (et donc de toutes les bibliothèques clientes Azure utilisant Azure Core) sont les suivants :

  • Configuration des clients de service, par exemple, configuration des nouvelles tentatives, journalisation, etc.
  • Accès aux détails de la réponse HTTP (Response<T>).
  • Appel d’opérations de longue durée (PollerFlux<T>).
  • Pagination et flux asynchrones (ContinuablePagedFlux<T>).
  • Exceptions pour la création de rapports d’erreurs à partir de demandes de service de manière cohérente.
  • Abstractions pour la représentation des informations d’identification du Kit de développement logiciel (SDK) Azure.

Celles-ci seront introduites au moyen des exemples présentés ci-dessous.

Exemples

Accès aux détails de la réponse HTTP à l’aide de Response<T>

Les clients de service ont des méthodes qui appellent des services Azure. Nous faisons référence à ces méthodes.

Les méthodes de service peuvent retourner un type Response<T>Azure Core partagé. Ce type fournit un accès à la fois au résultat désérialisé de l’appel de service et aux détails de la réponse HTTP retournée par le serveur.

Pipelines HTTP avec HttpPipeline

HttpPipeline est une construction qui contient une liste de HttpPipelinePolicy qui sont appliquées à une requête séquentiellement pour la préparer à être envoyée par un HttpClient.

Hiérarchie d’exceptions avec AzureException

AzureException est l’exception racine dans la hiérarchie utilisée dans Azure Core. Des exceptions supplémentaires telles que HttpRequestException et HttpResponseException sont utilisées pour réduire l’étendue des motifs d’exception.

Pagination avec ContinuablePagedFlux<T>

ContinuablePageFlux gère l’envoi d’une demande de page initiale à un service et la récupération de pages supplémentaires à mesure que le consommateur demande plus de données jusqu’à ce que le consommateur ait terminé le traitement ou que toutes les pages aient été consommées.

Opérations de longue durée avec PollerFlux<T>

PollerFlux gère l’envoi d’une demande de service initiale et la demande de traitement des mises à jour sur un intervalle de correction jusqu’à ce que l’interrogation soit annulée ou atteigne un état terminal.

É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.

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

Impressions