跳到主要内容

在PubSub+ JCSMP API中管理消息

以下部分讨论了在使用 PubSub+ JCSMP API 时如何管理消息。

  • 获取消息属性
  • 设置消息属性
  • 显示消息

获取消息属性​

客户端可以在消息发布之前从已创建的消息中获取消息属性，或者从 API 从事件代理接收到的消息中获取消息属性。

要查看可以检索的消息属性的完整列表，请参阅 PubSub+ 消息传递 API 部分中的相应 API。

某些消息属性（如过期、TTL 和死信队列资格）仅在与保证消息一起使用时才有效。有关详细信息，请参阅相关的 API 参考文档。

在 PubSub+ JCSMP API 中，您可以使用所有 XMLMessage.get*() 方法来获取消息属性。例如：

  • XMLMessage.getApplicationMessageType()
  • XMLMessage.getDeliveryMode()
  • XMLMessage.getSenderId()

要查看方法的完整列表，请参阅 PubSub+ 消息传递 API JCSMP 参考。

设置消息属性​

客户端可以在消息发布之前为已创建的消息设置消息属性，或者为 PubSub+ JCSMP API 从事件代理接收到的消息设置消息属性。

要查看可以设置的消息属性的完整列表，请参阅 PubSub+ 消息传递 API 部分中的相应 API。

某些消息属性（如过期、TTL 和死信队列资格）仅在与保证消息一起使用时才有效。有关详细信息，请参阅相关的 API 参考文档。

要设置消息属性，您可以使用所有 XMLMessage.set*() 方法。例如：

  • XMLMessage.setApplicationMessageType(String id)
  • XMLMessage.setDeliveryMode(DeliveryMode mode)
  • XMLMessage.setSenderId(String senderId)

要查看方法的完整列表，请参阅 PubSub+ 消息传递 API JCSMP 参考。

显示消息​

您可以使用消息转储工具以人类可读的形式显示消息的内容。此工具方法或函数作为编程辅助工具，便于开发和测试消息传递应用程序。您可以显示已创建的消息或已接收的消息的内容。

要显示消息内容，请使用 XMLMessage.dump()

生成的输出格式为：

<字段>：<值>

例如，消息部分（如消息头字段 SenderId）显示为：

SenderId：mySenderID

如果消息中存在消息部分，但其包含 NULL 或空字符串，则会显示该字段（在此示例中为 SenderID:），但没有值。如果消息中不存在消息部分，则不会为该部分生成输出。例如，如果不存在 SenderId 头字段，则不会生成 SenderId 字段或值。