SIMessage

SIMessage 接口是服务集成总线消息的公共接口,供调解和其他服务集成总线组件使用。此接口扩展 java.lang.Cloneable 和 java.lang.Serializable。

调解所支持的服务数据对象 (SDO) 版本是 V1

SIMessage 接口具有许多方法,这些方法允许您处理消息属性、头内容、路由路径、元数据和其他内容:
  • getDataGraph 方法返回 SDO 数据图。此数据图包含以树形表示的 SIMessage 有效内容。通过使用数据图,您可以直接处理消息有效内容中的各个字段。有关 SDO 数据图的更多信息,请参阅SDO 数据图
  • 可以通过调用 getNewDataGraph(format) 方法来转换消息有效内容的代码。该方法以新的格式返回有效内容的副本。可以通过使用 setDataGraph(DataGraph, format) 来将新的数据图写回到消息中。有关更多信息,请参阅在消息格式之间进行代码转换
  • 如果您想要将消息作为简单的字节流来记录,您可以通过使用方法 getDataGraphAsBytes 将消息有效内容作为字节数组来检索。 有关数据图与字节之间的来回转换的更多信息,请参阅对消息有效内容进行代码转换来将其转换为字节数组对字节数组进行代码转换来将其转换为消息有效内容
  • 具有用于获取、设置、删除和清除用户属性和消息属性的方法。您还可检索用户属性名称的列表。有关使用属性的更多信息,请参阅使用消息属性
  • 转发和反转路由路径定义中间总线目标的序列列表,通过这些目标传递消息以到达目标总线目的地。使用路由路径以将在多个目标上配置的调解应用到沿着路径发送的消息。以下方法允许您获取和设置 SIMessage 的 ForwardRoutingPath 和 ReverseRoutingPath 的内容:
    • getForwardRoutingPath()
    • setForwardRoutingPath()
    • getReverseRoutingPath()
    • setReverseRoutingPath()
    有关路由路径的更多信息,请参阅目标路由路径。有关如何处理路由地址的信息,请参阅在消息头中设置路由地址
  • 如果您的调解会更改消息的内容,那么存在消息不再有效的风险。如果数据图无效,那么无法通过服务集成总线来发送消息,也无法将消息存储在消息存储器中。在这种情况下,消息不是格式正确的消息。当消息的所有属性值都可以序列化并且消息的数据图与消息的格式一致时,该消息才是格式正确的消息。可以使用 isWellFormed 方法来测试消息。当消息包含格式正确的数据图时,该方法返回 true。此测试对性能有影响。有关更多信息,请参阅为调解设置调整属性
  • 您可以使用消息存在的时间,从最初发送消息的时间开始(以毫秒计):
    • 方法 getTimeToLivesetTimeToLive 允许您获取和设置消息头中 TimeToLive 字段的值。值 0 指示消息永远都不会到期。
    • 方法 getRemainingTimeToLivesetRemainingTimeToLive 允许您获取消息到期之前的剩余时间(以毫秒计)和设置消息应该到期之前的剩余时间(以毫秒计)。

有关 SIMessage 的更多信息,请参阅 API 文档。


指示主题类型的图标 参考主题



时间戳记图标 最近一次更新时间: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=rjy1310
文件名:rjy1310.html