43.5. 处理 SOAP 处理程序中的消息

正常消息处理由 handleMessage （） 方法处理。

handleMessage （） 方法接收 SOAPMessageContext 对象，以 SOAPMessage 对象和与消息关联的 SOAP 标头提供对消息的访问。此外，上下文提供对消息上下文中存储的任何属性的访问。

handleMessage （） 方法返回 true 或 false，具体取决于消息处理如何继续。它还可能会抛出异常。

您可以使用 SOAP 消息上下文的 getMessage （） 方法获取 SOAP 消息。它将消息返回为 live SOAPMessage 对象。处理程序中消息的任何更改都会自动反映在上下文中存储的消息中。

如果要将现有消息替换为新消息，您可以使用上下文的 setMessage （） 方法。setMessage （） 方法采用 SOAPMessage 对象。

您可以使用 SOAPMessage 对象的 getHeader （） 方法访问 SOAP 消息的标头。这将返回 SOAP 标头作为 SOAPHeader 对象，您需要检查以查找您要处理的标头元素。

SOAP 消息上下文提供 getHeaders （） 方法，如 例 43.10 “SOAPMessageContext.getHeaders （） 方法” 所示，它将返回一个包含指定 SOAP 标头的 JAXB 对象的数组。

您可以使用其元素的 QName 指定标头。您可以通过将 allRoles 参数设置为 false 来进一步限制返回的标头。这指示运行时仅返回适用于活动 SOAP 角色的 SOAP 标头。

如果没有找到标头，则方法会返回一个空数组。

有关实例化 JAXBContext 对象的更多信息，请参阅 第 39 章 使用 A JAXBContext 对象。

传递到逻辑处理程序的 SOAP 消息上下文是应用的消息上下文的实例，可以访问其中存储的所有属性。处理程序有权访问应用范围 和处理程序 范围的属性。

与应用程序的消息上下文一样，SOAP 消息上下文是 Java Map 的子类。要访问存储在上下文中的属性，您可以使用从 Map 接口继承的 get （） 方法和 put （） 方法。

默认情况下，您在逻辑处理程序内的上下文中设置的任何属性都会被分配 HANDLER 范围。如果您希望应用程序代码能够访问所需的属性，您需要使用上下文的 setScope （） 方法将属性明确设置为 APPLICATION。

有关在消息上下文中使用属性的详情，请参考 第 42.1 节 “了解上下文”。

知道消息通过处理程序链的方向通常非常重要。例如，您要将标头添加到传出消息，并从传入的消息中剥离标头。

消息的方向存储在消息上下文的出站消息属性中。您可以使用 MessageContext.MESSAGE_OUTBOUND_PROPERTY 密钥从消息上下文检索出站消息属性，如 例 43.11 “从 SOAP 消息上下文获取消息方向” 所示。

Boolean outbound;
outbound = (Boolean)smc.get(MessageContext.MESSAGE_OUTBOUND_PROPERTY);

属性作为 布尔值对象存储。您可以使用对象的 booleanValue （） 方法来确定属性值。如果属性设为 true，则会出站消息。如果属性设为 false，则消息为 inbound。

handleMessage （） 方法如何完成其消息处理对消息处理的方式有直接影响。它可以通过执行以下操作之一完成：

例 43.12 “在 SOAP 处理程序中处理消息” 显示一个 handleMessage （） 实现，它将 SOAP 消息打印到屏幕。

public boolean handleMessage(SOAPMessageContext smc)
{
  PrintStream out;

  Boolean outbound = (Boolean)smc.get(MessageContext.MESSAGE_OUTBOUND_PROPERTY);

  if (outbound.booleanValue())
  {
    out.println("\nOutbound message:");
  }
  else
  {
    out.println("\nInbound message:");
  }

  SOAPMessage message = smc.getMessage();

  message.writeTo(out);
  out.println();

  return true;
}

例 43.12 “在 SOAP 处理程序中处理消息” 中的代码执行以下操作：

从消息上下文检索 outbound 属性。

测试消息方向并打印适当的消息。

从上下文检索 SOAP 消息。

将消息输出到控制台。