Biblioteca cliente de Azure IoT Digital Twins para Java: versión 1.3.14

  • Artículo

Esta biblioteca proporciona acceso al servicio Azure Digital Twins para administrar gemelos, modelos, relaciones, etc.

Código | fuentePaquete

Introducción

El SDK de Microsoft Azure completo se puede descargar desde la página de descargas de Microsoft Azure y se incluye con compatibilidad con la creación de paquetes de implementación, integración con herramientas, herramientas de línea de comandos enriquecidas, etc.

Para obtener la mejor experiencia de desarrollo, los desarrolladores deben usar los paquetes oficiales de Microsoft Maven para bibliotecas. Los paquetes de Maven se actualizan periódicamente con nuevas funcionalidades y revisiones.

Inclusión del paquete

Inclusión del archivo BOM

Incluya azure-sdk-bom en el proyecto para depender de la versión de disponibilidad general de la biblioteca. En el fragmento de código siguiente, reemplace el marcador de posición {bom_version_to_target} por el número de versión. Para más información sobre la lista de materiales, consulte EL ARCHIVO LÉAME BOM del SDK de 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>

y, luego, incluya la dependencia directa en la sección de dependencias sin la etiqueta de versión.

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

Inclusión de dependencias directas

Si quiere depender de una versión determinada de la biblioteca que no está presente en la lista de materiales, agregue la dependencia directa al proyecto como se indica a continuación.

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

Requisitos previos

Autenticar el cliente

Para interactuar con el servicio Azure Digital Twins, deberá crear una instancia de una clase TokenCredential y pasarla al constructor de DigitalTwinsClientBuilder.

Conceptos clave

Azure Digital Twins es un servicio de Azure IoT que crea modelos completos del entorno físico. Puede crear grafos de inteligencia espacial para modelar las relaciones y las interacciones entre personas, espacios y dispositivos.

Para más información sobre Azure Digital Twins, visite la documentación de Azure Digital Twins.

Ejemplos

Puede familiarizarse con diferentes API mediante ejemplos de Digital Twins.

Estructura de carpetas de código fuente

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

Las partes de la biblioteca cliente se generan a través de Autorest y el archivo swagger usado se define en el archivo de configuración autorest.

Para volver a generar el código, ejecute el script de PowerShell generate.ps1.

/src/samples

Este directorio contiene código de ejemplo que muestra el uso básico de esta biblioteca cliente. Para más información, consulte el archivo Léame de ejemplo.

Solución de problemas

Todas las operaciones de servicio producirán ErrorResponseException en caso de error notificado por el servicio, con códigos de error útiles y otra información.

Por ejemplo, use la getModel operación para comprobar si el modelo existe antes de crearlo.

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

Pasos siguientes

Consulte ejemplos de implementación con nuestros ejemplos de código.

Contribuciones

Este proyecto agradece las contribuciones y sugerencias. La mayoría de las contribuciones requieren que acepte un Contrato de licencia para el colaborador (CLA) que declara que tiene el derecho a concedernos y nos concede los derechos para usar su contribución. Para más detalles, visite https://cla.microsoft.com.

Cuando se envía una solicitud de incorporación de cambios, un bot de CLA determinará de forma automática si tiene que aportar un CLA y completar la PR adecuadamente (por ejemplo, la etiqueta, el comentario). Solo siga las instrucciones que le dará el bot. Solo será necesario que lo haga una vez en todos los repositorios con nuestro CLA.

El proyecto ha adoptado el Código de conducta de código abierto de Microsoft. Para más información, consulte las preguntas más frecuentes del código de conducta o póngase en contacto con opencode@microsoft.com si tiene cualquier otra pregunta o comentario.