com.hivemq.client.mqtt.mqtt5.message.publish

Interface Mqtt5Publish

All Superinterfaces:

Mqtt5Message

All Known Subinterfaces:

Mqtt5WillPublish

All Known Implementing Classes:

MqttPublish, MqttWillPublish

@DoNotImplement
public interface Mqtt5Publish
extends Mqtt5Message

MQTT 5 Publish message. This message is translated from and to a MQTT 5 PUBLISH packet.

Since:

1.0

Field Summary

Fields

Modifier and Type	Field and Description
static @NotNull MqttQos	DEFAULT_QOS Default QoS level of a Publish message.

Method Summary

Modifier and Type	Method and Description
@NotNull Mqtt5WillPublish	asWill() Transforms this Publish message into a Will Publish with the same properties.
static @NotNull Mqtt5PublishBuilder	builder() Creates a builder for a Publish message.
Mqtt5PublishBuilder.Complete	extend() Creates a builder for extending this Publish message.
@NotNull java.util.Optional<MqttUtf8String>	getContentType()
@NotNull java.util.Optional<java.nio.ByteBuffer>	getCorrelationData()
@NotNull java.util.OptionalLong	getMessageExpiryInterval()
@NotNull java.util.Optional<java.nio.ByteBuffer>	getPayload()
@NotNull byte[]	getPayloadAsBytes()
@NotNull java.util.Optional<Mqtt5PayloadFormatIndicator>	getPayloadFormatIndicator()
@NotNull MqttQos	getQos()
@NotNull java.util.Optional<MqttTopic>	getResponseTopic()
@NotNull MqttTopic	getTopic()
default @NotNull Mqtt5MessageType	getType()
@NotNull Mqtt5UserProperties	getUserProperties()
boolean	isRetain()

Field Detail

DEFAULT_QOS

@NotNull
static final @NotNull MqttQos DEFAULT_QOS

Default QoS level of a Publish message. It is chosen as MqttQos.AT_MOST_ONCE as the QoS level should be explicitly specified if special delivery guarantees are needed.

Method Detail

builder

@NotNull
static @NotNull Mqtt5PublishBuilder builder()

Creates a builder for a Publish message.

Returns:

the created builder.

getTopic

@NotNull
@NotNull MqttTopic getTopic()

Returns:

the topic of this Publish message.

getPayload

@NotNull
@NotNull java.util.Optional<java.nio.ByteBuffer> getPayload()

Returns:

the optional payload of this Publish message.

getPayloadAsBytes

@NotNull
@NotNull byte[] getPayloadAsBytes()

Returns:

the payload of this Publish message as a byte array. Empty byte array if the payload is not present.

getQos

@NotNull
@NotNull MqttQos getQos()

Returns:

the QoS of this Publish message.

isRetain

boolean isRetain()

Returns:

whether this Publish message is a retained message.

getMessageExpiryInterval

@NotNull
@NotNull java.util.OptionalLong getMessageExpiryInterval()

Returns:

the optional message expiry interval in seconds of this Publish message.

getPayloadFormatIndicator

@NotNull
@NotNull java.util.Optional<Mqtt5PayloadFormatIndicator> getPayloadFormatIndicator()

Returns:

the optional payload format indicator of this Publish message.

getContentType

@NotNull
@NotNull java.util.Optional<MqttUtf8String> getContentType()

Returns:

the optional content type of this Publish message.

getResponseTopic

@NotNull
@NotNull java.util.Optional<MqttTopic> getResponseTopic()

Returns:

the optional response topic of this Publish message.

getCorrelationData

@NotNull
@NotNull java.util.Optional<java.nio.ByteBuffer> getCorrelationData()

Returns:

the optional correlation data of this Publish message.

getUserProperties

@NotNull
@NotNull Mqtt5UserProperties getUserProperties()

Returns:

the optional user properties of this Publish message.

getType

@NotNull
default @NotNull Mqtt5MessageType getType()

Specified by:

getType in interface Mqtt5Message

Returns:

the type of this MQTT message.

asWill

@NotNull
@NotNull Mqtt5WillPublish asWill()

Transforms this Publish message into a Will Publish with the same properties.

Returns:

the Will Publish.

extend

@NotNull
Mqtt5PublishBuilder.Complete extend()

Creates a builder for extending this Publish message.

Returns:

the created builder.