Package com.hivemq.extension.sdk.api.interceptor.publish.parameter

Interface PublishInboundOutput

All Superinterfaces:
AsyncOutput<PublishInboundOutput>, SimpleAsyncOutput<PublishInboundOutput>
@DoNotImplement
public interface PublishInboundOutput
extends AsyncOutput<PublishInboundOutput>
This is the output parameter of any PublishInboundInterceptor providing methods to define the outcome of PUBLISH interception.

It can be used to

  • Modify an inbound PUBLISH packet
  • Prevent delivery of an inbound PUBLISH packet

Only one of the methods preventPublishDelivery() may be called.

Subsequent calls will fail with an UnsupportedOperationException.

Since:
4.0.0, CE 2019.1

  • Method Details

    • getPublishPacket

      @NotNull @NotNull ModifiablePublishPacket getPublishPacket()
      Use this object to make any changes to the inbound PUBLISH.
      Returns:
      A modifiable publish packet.
      Since:
      4.0.0, CE 2019.1

    • preventPublishDelivery

      void preventPublishDelivery()
      Prevent the onward delivery of the PUBLISH packet with reason code AckReasonCode.SUCCESS for the PUBACK/PUBREC.
      Throws:
      UnsupportedOperationException - When preventPublishDelivery is called more than once.
      Since:
      4.0.0, CE 2019.1

    • preventPublishDelivery

      void preventPublishDelivery​(@NotNull AckReasonCode reasonCode)
      Prevent the onward delivery of the PUBLISH packet with reasonCode set as reason code in the PUBACK/PUBREC.
      Parameters:
      reasonCode - The reason code to sent in PUBACK/PUBREC.
      Throws:
      UnsupportedOperationException - When preventPublishDelivery is called more than once.
      Since:
      4.0.0, CE 2019.1

    • preventPublishDelivery

      void preventPublishDelivery​(@NotNull AckReasonCode reasonCode, @Nullable String reasonString)
      Prevent the onward delivery of the PUBLISH packet with reasonCode and reasonString set as reason code and reason string in the PUBACK/PUBREC respectively.
      Parameters:
      reasonCode - The reason code to sent in PUBACK/PUBREC.
      reasonString - The reason string to sent in PUBACK/PUBREC.
      Throws:
      UnsupportedOperationException - When preventPublishDelivery is called more than once.
      Since:
      4.0.0, CE 2019.1

    • async

      @NotNull @NotNull Async<PublishInboundOutput> async​(@NotNull Duration timeout, @NotNull TimeoutFallback timeoutFallback, @NotNull AckReasonCode reasonCode, @Nullable String reasonString)
      If the timeout is expired before Async.resume() is called then the outcome is handled either as failed or successful, depending on the specified fallback.

      Do not call this method more than once. If an async method is called multiple times an exception is thrown.

      Parameters:
      timeout - Timeout that HiveMQ waits for the result of the async operation.
      timeoutFallback - Fallback behaviour if a timeout occurs.

      If the fallback is SUCCESS then the publish will be delivered.

      If the fallback is FAILURE then the publish will be dropped.

      reasonCode - The reason code sent in PUBACK/PUBREC when timeout occurs.
      reasonString - The reason string sent in PUBACK/PUBREC when timeout occurs.
      Throws:
      UnsupportedOperationException - If async is called more than once.
      Since:
      4.0.0, CE 2019.1

    • async

      @NotNull @NotNull Async<PublishInboundOutput> async​(@NotNull Duration timeout, @NotNull TimeoutFallback timeoutFallback, @NotNull AckReasonCode reasonCode)
      If the timeout is expired before Async.resume() is called then the outcome is handled either as failed or successful, depending on the specified fallback.

      Do not call this method more than once. If an async method is called multiple times an exception is thrown.

      Parameters:
      timeout - Timeout that HiveMQ waits for the result of the async operation.
      timeoutFallback - Fallback behaviour if a timeout occurs.

      If the fallback is SUCCESS then the publish will be delivered.

      If the fallback is FAILURE then the publish will be dropped.

      reasonCode - The reason code sent in PUBACK/PUBREC when timeout occurs.
      Throws:
      UnsupportedOperationException - If async is called more than once.
      Since:
      4.0.0, CE 2019.1