Java 用 Azure IoT Digital Twins クライアント ライブラリ - バージョン 1.3.14

このライブラリは、ツイン、モデル、リレーションシップなどを管理するための Azure Digital Twins サービスへのアクセスを提供します。

ソースコード | パッケージ

作業の開始

完全な Microsoft Azure SDK は Microsoft Azure ダウンロード ページからダウンロードできます。また、デプロイ パッケージの構築、ツールとの統合、豊富なコマンド ライン ツールなどのサポートが付属しています。

最適な開発エクスペリエンスを得るには、開発者は公式の Microsoft Maven パッケージをライブラリに使用する必要があります。 Maven パッケージは、新しい機能と修正プログラムで定期的に更新されます。

パッケージをインクルードする

BOM ファイルを含める

ライブラリの GA バージョンに依存するには、azure-sdk-bom をプロジェクトに含めてください。 次のスニペットでは、{bom_version_to_target} プレースホルダーをバージョン番号に置き換えます。 BOM の詳細については、 AZURE SDK BOM README に関するページを参照してください。

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

次に、バージョン タグのない依存関係セクションに直接依存関係を含めます。

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

直接依存関係を含める

BOM に存在しないライブラリの特定のバージョンに依存する場合は、次のように直接依存関係をプロジェクトに追加します。

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

前提条件

• Microsoft Azure サブスクリプション
  • Microsoft Azure サービスを呼び出すには、 Azure サブスクリプションを作成します。
• Azure Digital Twins インスタンス
  • Azure Digital Twins SDK を使用するには、まず、次のいずれかのオプションを使用して Digital Twins インスタンスを作成します。
    • Azure portalの使用
    • Azure Management API の使用
    • Azure CLI の使用
      • Azure CLI と Azure CLI 用の Azure IoT 拡張機能 をインストールする必要があります。
      • Digital Twins インスタンスを作成して操作する方法の詳細については、 IoT CLI のドキュメント を参照してください。

クライアントを認証する

Azure Digital Twins サービスと対話するには、 TokenCredential クラス のインスタンスを作成し、 それを DigitalTwinsClientBuilder のコンストラクターに渡す必要があります。

主要な概念

Azure Digital Twins は、物理環境の包括的なモデルを作成する Azure IoT サービスです。 人、空間、デバイスの間の関係と相互作用をモデル化する空間インテリジェンス グラフを作成することができます。

Azure Digital Twins の詳細については、Azure Digital Twins のドキュメントを参照してください。

例

Digital Twins のサンプルを使用して、さまざまな API について理解することができます。

ソース コード フォルダーの構造

/src/メイン/java/com/azure/digitaltwins/core

• Digital Twins クライアント ビルダー DigitalTwinsClientBuilder
• Digital Twins パブリック同期と非同期クライアント DigitalTwinsClient。 DigitalTwinsAsyncClient
• models パッケージ

クライアント ライブラリの一部は Autorest を介して生成され、使用される swagger ファイルは Autorest 構成ファイルで定義されます。

コードを再生成するには、generate.ps1Powershell スクリプトを 実行します。

/src/samples

このディレクトリには、このクライアント ライブラリの基本的な使用方法を示すサンプル コードが含まれています。 詳細については、サンプル readme を参照してください。

トラブルシューティング

すべてのサービス操作では、サービスによって報告されたエラー時に ErrorResponseException がスローされ、役に立つエラー コードやその他の情報が表示されます。

たとえば、 操作をgetModel使用して、モデルを作成する前にモデルが存在するかどうかをチェックします。

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

次の手順

コード サンプルを使用した実装例を参照してください。

共同作成

このプロジェクトでは、共同作成と提案を歓迎しています。 ほとんどの共同作成では、共同作成者使用許諾契約書 (CLA) にご同意いただき、ご自身の共同作成内容を使用する権利を Microsoft に供与する権利をお持ちであり、かつ実際に供与することを宣言していただく必要があります。 詳細については、 https://cla.microsoft.com を参照してください。

pull request を送信すると、CLA を提供して PR (ラベル、コメントなど) を適宜装飾する必要があるかどうかを CLA ボットが自動的に決定します。 ボットによって提供される手順にそのまま従ってください。 この操作は、Microsoft の CLA を使用するすべてのリポジトリについて、1 回だけ行う必要があります。

このプロジェクトでは、Microsoft オープン ソースの倫理規定を採用しています。 詳しくは、「Code of Conduct FAQ (倫理規定についてよくある質問)」を参照するか、opencode@microsoft.com 宛てに質問またはコメントをお送りください。