com.rabbitmq.stream.Message Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of stream-client Show documentation
The RabbitMQ Stream Java client library allows Java applications to interface with RabbitMQ Stream.
There is a newer version: 0.20.0
// Copyright (c) 2020-2023 VMware, Inc. or its affiliates.  All rights reserved.
//
// This software, the RabbitMQ Stream Java client library, is dual-licensed under the
// Mozilla Public License 2.0 ("MPL"), and the Apache License version 2 ("ASL").
// For the MPL, please see LICENSE-MPL-RabbitMQ. For the ASL,
// please see LICENSE-APACHE2.
//
// This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND,
// either express or implied. See the LICENSE file for specific language governing
// rights and limitations of this software.
//
// If you have any questions regarding licensing, please contact us at
// [email protected].
package com.rabbitmq.stream;

import java.util.Map;

/**
 * API for outbound and inbound messages.
 *
 * A RabbitMQ stream message must comply to the AMQP 1.0 message format for the best
 * interoperability.
 *
 * 
Please see section 3.2 "message format" of the AMQP 1.0 specification to find out about the
 * exact meaning of the message sections.
 *
 * 
Messages instances are usually created with a {@link MessageBuilder}.
 */
public interface Message {

  /**
   * Does this message has a publishing ID?
   *
   * 
Publishing IDs are used for de-duplication of outbound messages. They are not persisted.
   *
   * @return true if the message has a publishing ID, false otherwise
   */
  boolean hasPublishingId();

  /**
   * Get the publishing ID for the message.
   *
   * 
Publishing IDs are used for de-duplication of outbound messages. They are not persisted.
   *
   * @return the publishing ID of the message
   */
  long getPublishingId();

  /**
   * Get the body of the message as an array of bytes.
   *
   * @return the message body
   */
  byte[] getBodyAsBinary();

  /**
   * Get the message body.
   *
   * 
The actual type is defined by the underlying AMQP 1.0 codec.
   *
   * @return the message body
   */
  Object getBody();

  /**
   * Get the properties of the message.
   *
   * @return the properties of the message
   */
  Properties getProperties();

  /**
   * Get the application properties of the message.
   *
   * @return the application properties of the message
   */
  Map getApplicationProperties();

  /**
   * Get the message annotations of the message.
   *
   * 
Message annotations are aimed at the infrastructure, use application properties for
   * application-specific key/value pairs.
   *
   * @return the message annotations
   */
  Map getMessageAnnotations();

  /**
   * Add a message annotation to the message.
   *
   * @param key the message annotation key
   * @param value the message annotation value
   * @return the modified message
   * @since 0.12.0
   */
  default Message annotate(String key, Object value) {
    this.getMessageAnnotations().put(key, value);
    return this;
  }

  /**
   * Create a copy of the message.
   *
   * The message copy contains the exact same instances of the original bare message (body,
   * properties, application properties), only the message annotations are actually copied and can
   * be modified independently.
   *
   * @return the message copy
   * @since 0.12.0
   */
  default Message copy() {
    return this;
  }
}