在WebLogic Workshop中设置SOAP Header

中国IT动力,最新最全的IT技术教程

最新100篇 | 推荐100篇 | 专题100篇 | 排行榜 | 搜索 | 在线API文档

当前位置：> Bea专区 > BEA Workshop

在WebLogic Workshop中设置SOAP Header

作者:Roger Weber 时间:2006-08-04 12:33 出处:bea.com.cn 责编:月夜寒箫

摘要：在WebLogic Workshop中设置SOAP Header

　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");

}

　　在这个例子中我们看到，Workshop知道表示SOAP Header的XMLBean文档。我们创建一个使用HeaderDocument.Factory.parse(String)的实例。String是我们想要包括在SOAP Header中的XML内容。任何操纵string或者XMLBean自身的普通方法都可用于创建该内容。

　　只要存在HeaderDocument，我们就可以使用newDomNode()方法获得Node。这个Node是XMLBeans在文档中用作占位符的合成根节点。使用getFirstChild()操作生成转换为Element的Header Node。然后，这个Element在服务控件中被传递到setOutputHeaders( Element[] )。

　　同样，org.w3c.dom.Document可以用作Element工厂。无需尝试编写关于DOM编程的教程，以下是如何创建Document的例子，然后把它用作一个工厂来创建Header Elements。

package myPackage;

import javax.xml.parsers.DocumentBuilder;

import javax.xml.parsers.DocumentBuilderFactory;

import javax.xml.parsers.ParserConfigurationException;

import org.w3c.dom.Document;

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()

{

Document doc = null; //allocate a document

try

{

//create the document

DocumentBuilderFactory factory =

DocumentBuilderFactory.newInstance();

factory.setNamespaceAware(true);

doc = factory.newDocumentBuilder().newDocument();

}

catch (ParserConfigurationException pce)

{

//should do something here.

}

// create the <SOAP-ENV:Header> element

Element header = doc.createElementNS(

"http://schemas.xmlsoap.org/soap/envelope/",

"SOAP-ENV:Header");

// create the <my:Content> element

Element headerContent = doc.createElementNS(

"http://my.org/uri/",

               "my:Content");

       header.appendChild(headerContent);

       // insert the text in the content node

headerContent.appendChild(doc.createTextNode("Content Text"));

Attr nsAttr = doc.createAttributeNS(

"http://www.w3.org/2000/xmlns/",

"xmlns:my");

        nsAttr.setValue("http://my.org/uri/");

       headerContent.setAttributeNodeNS(nsAttr);

       myServiceControl.setOutputHeaders(new Element[] {header});

myServiceControl.serviceMethod("argument");

}

　　上述方法讲述了如何使用javax.xml.parsers.DocumentBuilder和javax.xml.parsers.DocumentBuilderFactory 创建Document，以及如何使用Document构造所需要的 Element。

关闭本页