Biblioteca de clientes dos Gêmeos Digitais do Azure IoT para Java – versão 1.3.14

Artigo
10/21/2023

Essa biblioteca fornece acesso ao serviço gêmeos digitais do Azure para gerenciar gêmeos, modelos, relações etc.

Introdução

O SDK completo do Microsoft Azure pode ser baixado na página de downloads do Microsoft Azure e é fornecido com suporte para a criação de pacotes de implantação, integração com ferramentas, ferramentas avançadas de linha de comando e muito mais.

Para obter a melhor experiência de desenvolvimento, os desenvolvedores devem usar os pacotes oficiais do Microsoft Maven para bibliotecas. Os pacotes Maven são atualizados regularmente com novas funcionalidades e hotfixes.

Incluir o Pacote

Incluir o arquivo da BOM

Inclua o azure-sdk-bom em seu projeto para assumir a dependência da versão ga da biblioteca. No trecho a seguir, substitua o espaço reservado {bom_version_to_target} pelo número de versão. Para saber mais sobre a BOM, consulte o BOM README do SDK do 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>

Depois, inclua a dependência direta na seção de dependências sem a marca de versão.

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

Incluir dependência direta

Se você quiser assumir a dependência de uma versão específica da biblioteca que não está presente na BOM, adicione a dependência direta ao seu projeto da seguinte maneira.

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

Pré-requisitos

Uma assinatura do Microsoft Azure
- Para chamar os serviços do Microsoft Azure, crie uma assinatura do Azure.
Uma instância dos Gêmeos Digitais do Azure
- Para usar o SDK dos Gêmeos Digitais do Azure, primeiro crie uma instância dos Gêmeos Digitais usando uma das opções:
  - Usando portal do Azure
  - Usando APIs de Gerenciamento do Azure
  - Usando a CLI do Azure
    - Você precisará instalar a CLI do Azure e a extensão de IoT do Azure para a CLI do Azure.
    - Consulte a documentação da CLI do IoT para obter mais informações sobre como criar e interagir com sua instância dos Gêmeos Digitais.

Autenticar o Cliente

Para interagir com o serviço dos Gêmeos Digitais do Azure, você precisará criar uma instância de uma classe TokenCredential e passá-la para o construtor de seu DigitalTwinsClientBuilder.

Principais conceitos

Os Gêmeos Digitais do Azure são um serviço de IoT do Azure que cria modelos abrangentes do ambiente físico. Eles podem criar grafos de inteligência espacial para modelar relações e interações entre pessoas, espaços e dispositivos.

Você pode saber mais sobre os Gêmeos Digitais do Azure visitando a Documentação dos Gêmeos Digitais do Azure

Exemplos

Você pode se familiarizar com APIs diferentes usando exemplos de Gêmeos Digitais.

Estrutura da pasta do código-fonte

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

O construtor de clientes dos Gêmeos Digitais DigitalTwinsClientBuilder
A sincronização pública dos Gêmeos Digitais e os clientes assíncronos DigitalTwinsClient, DigitalTwinsAsyncClient
models Pacote

Partes da biblioteca de clientes são geradas por meio de Autorest e o arquivo swagger usado é definido no arquivo de configuração Autorest.

Para regenerar o código, execute o script do Powershell generate.ps1.

/src/samples

Esse diretório contém um código de exemplo que demonstra o uso básico dessa biblioteca de clientes. Para obter informações adicionais, consulte o leiame de exemplo

Solução de problemas

Todas as operações de serviço lançarão ErrorResponseException em caso de falha relatada pelo serviço, com códigos de erro úteis e outras informações.

Por exemplo, use a getModel operação para marcar se o modelo existir antes de criá-lo.

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

Próximas etapas

Confira exemplos de implementação com nossos exemplos de código.

Contribuição

Este projeto aceita contribuições e sugestões. A maioria das contribuições exige que você concorde com um CLA (Contrato de Licença do Colaborador) declarando que você tem o direito de nos conceder, e de fato concede, os direitos de usar sua contribuição. Para obter detalhes, visite https://cla.microsoft.com.

Quando você envia uma solicitação de pull, um bot do CLA determina automaticamente se você precisa fornecer um CLA e preencher a PR corretamente (por exemplo, rótulo, comentário). Basta seguir as instruções fornecidas pelo bot. Você só precisará fazer isso uma vez em todos os repositórios que usam nosso CLA.

Este projeto adotou o Código de Conduta de Software Livre da Microsoft. Para obter mais informações, confira as Perguntas Frequentes Sobre o Código de Conduta ou entre em contato pelo email opencode@microsoft.com para enviar outras perguntas ou comentários.

Compartilhar via