1 Introducción
2 Añadiendo la dependencia Maven
3 Clientes basados en el dispositivo
- 3.1 Client REST
- 3.2 Cliente MQTT
  - 3.2.1 Suscripciones a MQTT
4 Clientes no basados en el dispositivo
- 4.1 Binary Repository Client
5 Ejemplo:

Introducción

Hemos desarrollado 3 clientes Java para comunicarnos con la plataforma: MQTTClient, que utiliza el protocolo MQTT; RestClient, que utiliza la arquitectura REST; y BinaryRepositoryClient, que utiliza el RestClient y está pensado para usarlo para intercambio de archivos binarios.

Ésta es una biblioteca ligera que no requiere ninguna dependencia de Spring y es útil para aplicaciones ligeras en dispositivos edge.

Añadiendo la dependencia Maven

Para usar esta API, tienes que añadir el siguiente repositorio al pom.xml del proyecto, de esta manera:

	<repositories>
		<repository>
			<id>onesait platform releases</id>
			<url>https://nexus.onesaitplatform.com/nexus/content/repositories/releases/</url>
		</repository>
		<repository>
			<id>central Maven</id>
			<url>http://central.maven.org/maven2/</url>
		</repository>
       ...
	</repositories>

Y después añadir la siguiente dependencia:

		<dependency>
			<groupId>com.minsait.onesait.platform</groupId>
			<artifactId>onesaitplatform-java-client</artifactId>
			<version>${onesaitplatform.client.version}</version>
		</dependency>

donde tienes que cambiar ${onesaitplatform.client.version}. Por ejemplo, ahora la última versión es 2.0.2-RELEASE con tu versión de cliente de la API de Java (ver versiones aquí: https://nexus.onesaitplatform.com/nexus/content/repositories/releases/com/minsait/onesait/platform/onesaitplatform-java-client/)

Clientes basados en el dispositivo

MQTTClient y RestClient encajan en esta categoría, ya que requieren una definición de dispositivo (Device) y un Token para hacer la conexión.

Device: ésta es la definición de dispositivo en la plataforma, por ejemplo TicketingApp
Token: el token asociado a esta definición de dispositivo, por ejemplo e7ef0742d09d4de5a3687f0cfdf7f626
Ontology: la ontología utilizada debe estar asociada al dispositivo, por ejemplo Ticket

Un ejemplo sería:

También tendrás que especificar la URL del servidor:

MQTT: ejemplo: ssl://lab.onesaitplatform.com :8883
REST: ejemplo: http:s//lab.onesaitplatform.com/iot-broker

Client REST

Instancia el REST de la siguiente manera:

Ahora puede realizar varias operaciones como en esta prueba:

Cliente MQTT

Para el cliente MQTT, puedes usar una conexión TCP o SSL (MQTT/MQTTS).

Si quieres usar MQTTS, puedes especificar la configuración MQTTSecureConfiguration con la ruta keyStore (.jks) y su contraseña, o utilizar el jks por defecto.