software.amazon.awssdk.crt.mqtt

Class MqttClient

java.lang.Object

software.amazon.awssdk.crt.CrtResource

software.amazon.awssdk.crt.mqtt.MqttClient

All Implemented Interfaces:

AutoCloseable

public class MqttClient
extends CrtResource

This class wraps aws-c-mqtt to provide the basic MQTT pub/sub functionalities via the AWS Common Runtime One MqttClient class is needed per application. It can create any number of connections to any number of MQTT endpoints

Constructor Summary

Constructors

Constructor and Description
MqttClient() Creates a default MqttClient with no TLS and a ClientBootstrap constructed with default settings
MqttClient(ClientBootstrap clientBootstrap) Creates an MqttClient with no TLS from the provided ClientBootstrap
MqttClient(ClientBootstrap clientBootstrap, TlsContext context) Creates an MqttClient from the provided ClientBootstrap and TlsContext

Method Summary

Modifier and Type	Method and Description
protected boolean	canReleaseReferencesImmediately() Determines whether a resource releases its dependencies at the same time the native handle is released or if it waits.
TlsContext	getTlsContext() Gets the tls context used by all connections associated with this client.
protected void	releaseNativeHandle() Cleans up the native resources associated with this client.

Methods inherited from class software.amazon.awssdk.crt.CrtResource

acquireNativeHandle, addReferenceTo, close, collectNativeResources, getNativeHandle, isNativeResource, isNull, logNativeResources, releaseReferences, waitForNoResources

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

MqttClient

public MqttClient()
           throws CrtRuntimeException

Creates a default MqttClient with no TLS and a ClientBootstrap constructed with default settings

Throws:

CrtRuntimeException - @see software.amazon.awssdk.crt.io.ClientBootstrap#constructor(EventLoopGroup) @see software.amazon.awssdk.crt.io.EventLoopGroup#constructor(int)

MqttClient

public MqttClient(ClientBootstrap clientBootstrap)
           throws CrtRuntimeException

Creates an MqttClient with no TLS from the provided ClientBootstrap

Parameters:

clientBootstrap - The ClientBootstrap to use

Throws:

CrtRuntimeException - If the system is unable to allocate space for a native MQTT client structure

MqttClient

public MqttClient(ClientBootstrap clientBootstrap,
                  TlsContext context)
           throws CrtRuntimeException

Creates an MqttClient from the provided ClientBootstrap and TlsContext

Parameters:

clientBootstrap - The ClientBootstrap to use

tlsContext - the tls context to use

Throws:

CrtRuntimeException - If the system is unable to allocate space for a native MQTT client structure

Method Detail

getTlsContext

public TlsContext getTlsContext()

Gets the tls context used by all connections associated with this client.

releaseNativeHandle

protected void releaseNativeHandle()

Cleans up the native resources associated with this client. The client is unusable after this call

Specified by:

releaseNativeHandle in class CrtResource

canReleaseReferencesImmediately

protected boolean canReleaseReferencesImmediately()

Determines whether a resource releases its dependencies at the same time the native handle is released or if it waits. Resources that wait are responsible for calling releaseReferences() manually.

Specified by:

canReleaseReferencesImmediately in class CrtResource