【IT168 技术文档】

    WebLogic Workshop提供了一种内建的控件，叫做Service控件，可以用于在WebLogic Workshop应用程序中调用外部的web服务。Service控件隐藏了调用外部web服务的全部细节，包括把参数数据编组到XML以及形成SOAP调用消息，最终发送到目标web服务的服务器上。

    SOAP规范允许SOAP消息包含header。一些web服务要求他们的客户端在调用web服务时，把“out of band” 信息传送给SOAP header。本文描述了当通过Service 控件调用外部web服务时，如何创建SOAP header以及如何把header包含在输出的消息中。

    当web服务使用XML SOAP进行通信时，基本的消息如下。

<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">
<SOAP-ENV:Header>
"optional headers"
</SOAP-ENV:Header>
<SOAP-ENV:Body>
"Message body" </SOAP-ENV:Body>
</SOAP-ENV:Envelope>

    SOAP Envelope包括两块主要内容。最有趣的是实际的消息，或者Body。但是在body之前还有一个可选的 Header。WebLogic Workshop创建和包括了消息的Envelope和Body。由于Header在SOAP规范和SOAP Schema中都是可选的，因此如果没有内容，Workshop就会忽略Header。然而，当作为另一个web服务的客户端时，通常就会要求包含SOAP Header，或者在一些web服务中，即使没有内容，也必须表示Header元素。在这种情况中，使用web服务控件时如何通知Workshop包含这些header呢？

    Service控件界面包括setOutputHeaders（org.w3c.dom.Element[] ）方法，可以用于在输出web服务调用请求中设置SOAP header。因此添加一个简单的元素数组就可以把header添加到发送消息中。但是简单性到此为止。注意，该方法接受了元素数组。如何处理这些数组在8.1 SP2中得到了改进。

    使用8.1 SP1或者早期版本时，传递的数组必须是单个元素，即SOAP-ENV:Header和其后代。在数组或者元素中，多个条目位于SOAP-ENV:Header不支持的位置上。

    从8.1 SP2开始，在数组中可以有多个元素，而且元素可以是SOAP-ENV:Header或者任何元素。如果SOAP-ENV:Header元素被表示，那个就会保留Header以开始构造所产生的Header 。如果它没有被表示，就会为它创建一个。每个后续数组都会被检测，并适当地移植到SOAP-ENV:Header或者现有SOAP-ENV:Header的孩子的树中。

    元素还是一种接口，创建一个实例不需要什么新的操作。因此，必须有其他一些内容被当作工厂来创建该元素。

   既然XMLBeans是一种相当简单的创建XML内容的方式，那么我们就首先来看一看它。Workshop知Soap Envelope Header文档中的XMLBean表示，因此，我们只使用它。

package myPackage;
import org.xmlsoap.schemas.soap.envelope.HeaderDocument;
import com.bea.xml.XmlException;
import org.w3c.dom.Element;
public class MyService implements com.bea.jws.WebService
{
/** @common:control */
private myPackage.MyServiceCtl myServiceControl;
static final long serialVersionUID = 1L;
/** * @common:operation */
public void myMethod()
{ HeaderDocument hd = null;
try
{
hd = HeaderDocument.Factory.parse(
"<SOAP-ENV:Header xmlns:SOAP-ENV=\"http://schemas.xmlsoap.org/soap/envelope/\">" +
"<my:content xmlns:my=\"http://my.com/uri/\">Content Text</my:content>" +
"</SOAP-ENV:Header>");
}
catch (XmlException xe)
{
//should do something here.
}
Element header = (Element) hd.newDomNode().getFirstChild();
myServiceControl.setOutputHeaders(new Element[] { header });
myServiceControl.serviceMethod("argument");
}
}