Azure IoT Digital Twins-Clientbibliothek für Java – Version 1.3.14

Artikel
10/21/2023

Diese Bibliothek bietet Zugriff auf den Azure Digital Twins-Dienst zum Verwalten von Zwillingen, Modellen, Beziehungen usw.

Quellcode | Paket

Erste Schritte

Das vollständige Microsoft Azure SDK kann von der Microsoft Azure-Downloadseite heruntergeladen werden und wird mit Unterstützung für das Erstellen von Bereitstellungspaketen, die Integration in Tools, umfangreiche Befehlszeilentools und vieles mehr bereitgestellt.

Um die beste Entwicklungserfahrung zu erzielen, sollten Entwickler die offiziellen Microsoft Maven-Pakete für Bibliotheken verwenden. Maven-Pakete werden regelmäßig mit neuen Funktionen und Hotfixes aktualisiert.

Schließen Sie das Paket ein

BOM-Datei einfügen

Fügen Sie das azure-sdk-bom in Ihr Projekt ein, um die Abhängigkeit von der GA-Version der Bibliothek zu übernehmen. Ersetzen Sie im folgenden Codeausschnitt den Platzhalter {bom_version_to_target} durch die Versionsnummer. Weitere Informationen zur Stückliste finden Sie in der AZURE SDK-BOM-INFODATEI.

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

und fügen Sie dann die direkte Abhängigkeit ohne Versions-Tag in den Abschnitt „Abhängigkeit“ ein.

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

Direkte Abhängigkeiten einfügen

Wenn Sie abhängigkeiten von einer bestimmten Version der Bibliothek übernehmen möchten, die in der Stückliste nicht vorhanden ist, fügen Sie die direkte Abhängigkeit wie folgt zu Ihrem Projekt hinzu.

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-digitaltwins-core</artifactId>
  <version>1.3.14</version>
</dependency>

Voraussetzungen

Ein Microsoft Azure-Abonnement.
- Um Microsoft Azure-Dienste aufzurufen, erstellen Sie ein Azure-Abonnement.
Ein Azure Digital Twins-instance
- Um das Azure Digital Twins SDK zu verwenden, erstellen Sie zunächst eine Digital Twins-instance mit einer der folgenden Optionen:
  - Verwenden von Azure-Portal
  - Verwenden von Azure-Verwaltungs-APIs
  - Verwenden der Azure CLI
    - Sie müssen die Azure CLI und die Azure IoT-Erweiterung für die Azure CLI installieren.
    - Weitere Informationen zum Erstellen und Interagieren mit Ihrem Digital Twins-instance finden Sie in der IoT CLI-Dokumentation.

Authentifizieren des Clients

Um mit dem Azure Digital Twins-Dienst zu interagieren, müssen Sie eine instance einer TokenCredential-Klasse erstellen und an den Konstruktor Ihres DigitalTwinsClientBuilder übergeben.

Wichtige Begriffe

Azure Digital Twins ist ein Azure IoT-Dienst zur Erstellung umfassender Modelle der physischen Umgebung. Er kann Raumintelligenzgraphen erstellen, um die Beziehungen und Interaktionen zwischen Personen, Bereichen und Geräten zu modellieren.

Weitere Informationen zu Azure Digital Twins finden Sie in der Dokumentation zu Azure Digital Twins.

Beispiele

Mithilfe von Beispielen für Digital Twins können Sie sich mit verschiedenen APIs vertraut machen.

Struktur des Quellcodeordners

/src/Standard/java/com/azure/digitaltwins/core

Client-Generator für Digital Twins DigitalTwinsClientBuilder
Die öffentlichen Digital Twins-Synchronisierungs- und asynchronen Clients DigitalTwinsClient, DigitalTwinsAsyncClient
models Paket

Teile der Clientbibliothek werden über Autorest generiert, und die verwendete Swagger-Datei wird in der Konfigurationsdatei Autorest definiert.

Um den Code neu zu generieren, führen Sie das PowerShell-Skript generate.ps1aus.

/src/samples

Dieses Verzeichnis enthält Beispielcode, der die grundlegende Verwendung dieser Clientbibliothek veranschaulicht. Weitere Informationen finden Sie in der Beispiellesedatei.

Problembehandlung

Alle Dienstvorgänge lösen ErrorResponseException bei fehlern aus, die vom Dienst gemeldet wurden, mit hilfreichen Fehlercodes und anderen Informationen.

Verwenden Sie beispielsweise den getModel Vorgang, um zu überprüfen, ob das Modell vorhanden ist, bevor Sie es erstellen.

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);
    }
}

Nächste Schritte

Sehen Sie sich Implementierungsbeispiele mit unseren Codebeispielen an.

Mitwirken

Beiträge und Vorschläge für dieses Projekt sind willkommen. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. Ausführliche Informationen finden Sie unter https://cla.microsoft.com.

Wenn Sie einen Pull Request (PR) übermitteln, überprüft ein CLA-Bot automatisch, ob Sie eine Lizenzvereinbarung bereitstellen und den PR entsprechend ergänzen müssen (z.B. mit einer Bezeichnung oder einem Kommentar). Führen Sie einfach die Anweisungen des Bots aus. Sie müssen dies nur einmal für alle Repositorys ausführen, die unsere CLA verwenden.

Für dieses Projekt gelten die Microsoft-Verhaltensregeln für Open Source (Microsoft Open Source Code of Conduct). Weitere Informationen finden Sie in den häufig gestellten Fragen zum Verhaltenskodex. Sie können sich auch an opencode@microsoft.com wenden, wenn Sie weitere Fragen oder Anmerkungen haben.

Freigeben über