IoT Platform:Utiliser le SDK IoT Platform pour Java

Installer le SDK

1. Installez un environnement de développement Java.

   Téléchargez un package d'installation Java depuis le site Web officiel de Java et installez Java en suivant les instructions.

2. Installez le SDK IoT Platform pour Java.

   1. Téléchargez un package d'installation Maven depuis le site Web officiel d'Apache Maven.

   2. Ajoutez les dépendances suivantes à votre projet Maven :

      • Dépendance pour la dernière version du SDK IoT Platform pour Java :

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

      • Dépendance pour le SDK Alibaba Cloud pour Java :

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

Initialiser le SDK

Créez un objet de profil de la classe IClientProfile pour stocker les informations d'initialisation du SDK. Créez ensuite une instance de client de la classe DefaultAcsClient. Appelez la méthode DefaultAcsClient(profile) pour charger les informations d'initialisation du 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.

L'exemple suivant montre comment initialiser le SDK si votre service IoT Platform se trouve dans la région Chine (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.

Envoyer une requête

Le SDK encapsule deux classes pour chaque opération d'API. Les noms des classes sont au format ${API operation name}+"Request" et ${API operation name}+"Response".

• ${API operation name}+"Request" : cette classe sert à appeler une opération d'API. Créez une instance request de cette classe et appelez la méthode set +${request parameter} pour spécifier les paramètres de la requête.

• ${API operation name}+"Response" : appelez la méthode getAcsResponse(request) de l'instance de client créée à partir de DefaultAcsClient pour obtenir une réponse. Appelez la méthode get +${response parameter} de l'instance de réponse de la classe ${API operation name}+"Response" pour obtenir les valeurs des paramètres de réponse.

  Par exemple, appelez la méthode response.getSuccess() pour obtenir le paramètre Success. Ce paramètre de réponse commun indique si la requête a abouti. Les paramètres de réponse communs incluent également RequestId, ErrorMessage et Code.

Pour plus d'informations sur les opérations d'API d'IoT Platform, consultez la rubrique Liste des opérations par fonction. Pour plus d'informations sur les paramètres request et response de chaque opération d'API, consultez la documentation de l'API.

L'exemple suivant montre comment appeler l'opération Pub pour publier un message sur un topic. Pour plus d'informations sur les paramètres de la requête, consultez la rubrique 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();
}

Annexe : Exemple de code

Vous pouvez afficher ou télécharger l'exemple de code des opérations d'API dans le Centre d'exemples de SDK IoT Platform. Des exemples de code pour les SDK Java, Python, PHP, .NET et Go sont fournis.

Le portail des développeurs OpenAPI d'Alibaba Cloud met à disposition un outil de débogage d'API en ligne. Sur la page API debugging, vous pouvez rechercher et tester des appels d'API. Le portail génère automatiquement des exemples de code SDK dans différents langages en fonction des paramètres que vous saisissez. Affichez le code généré dans l'onglet SDK Example et la réponse dans l'onglet Call Result.