Bibliothèque de client Azure IoT Digital Twins pour Java - version 1.3.14

Article
10/25/2023

Cette bibliothèque permet d’accéder au service Azure Digital Twins pour la gestion des jumeaux, des modèles, des relations, etc.

| Code source Paquet

Prise en main

Le KIT de développement logiciel (SDK) Microsoft Azure complet peut être téléchargé à partir de la page de téléchargements Microsoft Azure , et il est fourni avec la prise en charge de la création de packages de déploiement, de l’intégration avec des outils, des outils en ligne de commande riches, etc.

Pour une expérience de développement optimale, les développeurs doivent utiliser les packages Microsoft Maven officiels pour les bibliothèques. Les packages Maven sont régulièrement mis à jour avec de nouvelles fonctionnalités et correctifs logiciels.

Inclure le package

Inclure le fichier de nomenclature

Incluez azure-sdk-bom dans votre projet pour dépendre de la version ga 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-digitaltwins-core</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-digitaltwins-core</artifactId>
  <version>1.3.14</version>
</dependency>

Prérequis

Un abonnement Microsoft Azure.
- Pour appeler les services Microsoft Azure, créez un abonnement Azure.
Un instance Azure Digital Twins
- Pour utiliser le Kit de développement logiciel (SDK) Azure Digital Twins, commencez par créer un instance Digital Twins à l’aide de l’une des options suivantes :
  - Utilisation de Portail Azure
  - Utilisation des API de gestion Azure
  - Utilisation d’Azure CLI
    - Vous devez installer azure cli et l’extension Azure IoT pour Azure CLI.
    - Pour plus d’informations sur la création et l’interaction avec votre instance Digital Twins, consultez la documentation de l’interface CLI IoT.

Authentifier le client

Pour interagir avec le service Azure Digital Twins, vous devez créer une instance d’une classe TokenCredential et la transmettre au constructeur de votre DigitalTwinsClientBuilder.

Concepts clés

Azure Digital Twins est un service Azure IoT qui permet de créer des modèles complets de l’environnement physique. Il peut créer des graphes d’intelligence spatiale afin de modéliser les relations et les interactions entre les personnes, les espaces et les appareils.

Pour en savoir plus sur Azure Digital Twins, consultez la documentation Azure Digital Twins.

Exemples

Vous pouvez vous familiariser avec différentes API à l’aide d’exemples pour Digital Twins.

Structure du dossier du code source

/src/main/java/com/azure/digitaltwins/core

Le générateur de client Digital Twins DigitalTwinsClientBuilder
Les clients DigitalTwinsClientde synchronisation publique et asynchrone Digital Twins , DigitalTwinsAsyncClient
models Paquet

Des parties de la bibliothèque cliente sont générées via Autorest, et le fichier swagger utilisé est défini dans le fichier de configuration Autorest.

Pour régénérer le code, exécutez le script PowerShell generate.ps1.

/src/samples

Ce répertoire contient un exemple de code qui illustre l’utilisation de base de cette bibliothèque cliente. Pour plus d’informations, consultez l’exemple de fichier lisez-moi.

Dépannage

Toutes les opérations de service lèvent ErrorResponseException en cas d’échec signalé par le service, avec des codes d’erreur utiles et d’autres informations.

Par exemple, utilisez l’opération getModel pour case activée si le modèle existe avant de le créer.

try {
    syncClient.getModel("someRandomModelId");
}
catch (ErrorResponseException ex) {
    if (ex.getResponse().getStatusCode() == HttpURLConnection.HTTP_NOT_FOUND) {
        return id;
    } else {
        // This request should not retried if it encounters a 401 error, for instance
        throw new IllegalStateException("Encountered unexpected error while searching for unique id", ex);
    }
}

Étapes suivantes

Consultez des exemples d’implémentation avec nos exemples de code.

Contribution

Ce projet accepte les contributions et les suggestions. La plupart des contributions vous demandent d’accepter un contrat de licence de contribution (CLA) déclarant que vous avez le droit de nous accorder, et que vous nous accordez réellement, les droits d’utilisation de votre contribution. Pour plus d’informations, visitez https://cla.microsoft.com.

Quand vous envoyez une demande de tirage (pull request), un bot CLA détermine automatiquement si vous devez fournir un contrat CLA et agrémenter la demande de tirage de façon appropriée (par exemple, avec une étiquette ou un commentaire). Suivez simplement les instructions fournies par le bot. Vous ne devez effectuer cette opération qu’une seule fois sur tous les dépôts utilisant notre contrat CLA.

Ce projet a adopté le Code de conduite Open Source de Microsoft. Pour plus d’informations, consultez les Questions fréquentes (FAQ) sur le code de conduite ou envoyez vos questions ou vos commentaires à opencode@microsoft.com.

Partager via