IoT Platform:Uso del SDK for Java de IoT Platform

Instalar el SDK

1. Instale un entorno de desarrollo de Java.

   Descargue un paquete de instalación de Java desde el sitio web oficial de Java y siga las instrucciones para instalarlo.

2. Instale el SDK for Java de IoT Platform.

   1. Descargue un paquete de instalación de Maven desde el sitio web oficial de Apache Maven.

   2. Agregue las siguientes dependencias a su proyecto de Maven:

      • Dependencia de la versión más reciente del SDK for Java de IoT Platform:

        <!-- https://mvnrepository.com/artifact/com.aliyun/aliyun-java-sdk-iot -->
        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-iot</artifactId>
            <version>7.41.0</version>
        </dependency>

      • Dependencia del SDK for Java de Alibaba Cloud:

        <dependency>
            <groupId>com.aliyun</groupId>
            <artifactId>aliyun-java-sdk-core</artifactId>
            <version>4.5.6</version>
        </dependency>

Inicializar el SDK

Cree un objeto profile de la clase IClientProfile para almacenar la información de inicialización del SDK. Después, cree una instancia de cliente de la clase DefaultAcsClient. Llame al método DefaultAcsClient(profile) para cargar la información de inicialización del SDK.

String accessKey = System.getenv("ACCESS_KEY_ID");
String accessSecret = System.getenv("ACCESS_KEY_SECRET");
IClientProfile profile = DefaultProfile.getProfile("${RegionId}", accessKey, accessSecret);
DefaultAcsClient client = new DefaultAcsClient(profile); // Initialize an SDK client.

A continuación se muestra un ejemplo de cómo inicializar el SDK si su servicio de IoT Platform se encuentra en la región China (Shanghai):

String accessKey = System.getenv("ACCESS_KEY_ID");
String accessSecret = System.getenv("ACCESS_KEY_SECRET");
IClientProfile profile = DefaultProfile.getProfile("cn-shanghai", accessKey, accessSecret);
DefaultAcsClient client = new DefaultAcsClient(profile); // Initialize an SDK client.

Enviar una solicitud

El SDK encapsula dos clases para cada operación de API. Los nombres de estas clases siguen los formatos ${API operation name}+"Request" y ${API operation name}+"Response".

• ${API operation name}+"Request": esta clase sirve para llamar a una operación de API. Cree una instancia request de esta clase y llame al método set +${request parameter} para especificar los parámetros de la solicitud.

• ${API operation name}+"Response": llame al método getAcsResponse(request) de la instancia de cliente creada a partir de DefaultAcsClient para obtener una respuesta. Para recuperar los valores de los parámetros de respuesta, llame al método get +${response parameter} de la instancia de respuesta de la clase ${API operation name}+"Response".

  Por ejemplo, llame al método response.getSuccess() para obtener el parámetro Success. Este parámetro es común en las respuestas e indica si la solicitud fue exitosa. Otros parámetros comunes de respuesta son RequestId, ErrorMessage y Code.

Para obtener más información sobre las operaciones de API de IoT Platform, consulte la lista de operaciones por función. Si necesita detalles sobre los parámetros request y response de cada operación de API, revise la documentación de la API.

En el siguiente ejemplo se muestra cómo llamar a la operación Pub para publicar un mensaje en un topic. Para conocer los parámetros de la solicitud, consulte Pub.

PubRequest request = new PubRequest(); 
request.setIotInstanceId("${iotInstanceId}"); 
request.setProductKey("${productKey}"); 
request.setMessageContent(Base64.encodeBase64String("hello world".getBytes())); 
request.setTopicFullName("/${productKey}/${deviceName}/user/get"); 
request.setQos(0); // QoS 0 and QoS 1 are supported.  
try 
{ 
   PubResponse response = client.getAcsResponse(request); 
   System.out.println(response.getSuccess()); 
   System.out.println(response.getCode());
   System.out.println(response.getErrorMessage());
} 
catch (ServerException e) 
{
   e.printStackTrace();
}
catch (ClientException e)
{
   System.out.println("ErrCode:" + e.getErrCode());
   System.out.println("ErrMsg:" + e.getErrMsg());
   e.printStackTrace();
}

Apéndice: código de ejemplo

Consulte o descargue el código de ejemplo de las operaciones de API en el centro de ejemplos del SDK de IoT Platform. Allí encontrará ejemplos para los SDK de Java, Python, PHP, .NET y Go.

El portal para desarrolladores de openapi de Alibaba Cloud ofrece una herramienta de depuración de API en línea. En la página API debugging, busque y pruebe llamadas a la API. El portal genera automáticamente código de ejemplo del SDK en distintos lenguajes según los parámetros que introduzca. Revise el código generado en la pestaña SDK Example y la respuesta en la pestaña Call Result.