用Java实现基于SOAP的XML文档网络传输及远程过程调用.docx
《用Java实现基于SOAP的XML文档网络传输及远程过程调用.docx》由会员分享,可在线阅读,更多相关《用Java实现基于SOAP的XML文档网络传输及远程过程调用.docx(23页珍藏版)》请在冰豆网上搜索。
用Java实现基于SOAP的XML文档网络传输及远程过程调用
用Java实现基于SOAP的XML文档网络传输及远程过程调用(RPC)
SOAP(SimpleObjectAccessProtocol,简单对象访问协议)是一种基于XML的,用于计算机之间交换信息的协议。
SOAP能应用于各种消息接发系统,并能通过各种传输协议进行消息传递,但最初的侧重点是通过HTTP传输的远程过程调用。
SOAP是Webservice的一个重要组成部份,如果把Webservice比喻成Internet,那么SOAP就可以比喻成TCP/IP。
SOAP是一种协议而非具体产品,微软也有自己的SOAP实现产品,而Java下比较流行的SOAP实现产品就是ApacheSOAP,不过它的下一个版本已经改名成AXIS了。
SOAP是用XML文件来做为数据转输的载体的,走HTTP的线路。
一般企业的防火墙都开放HTTP的80端口,所以SOAP不会被防火墙阻断,这算是SOAP的一个优点。
信息转输的双方都要求支持SOAP服务,因为XML文件发过去,则对方需要有SOAP服务来接收,然后对方会有反馈也是XML文件,这时你也需要安装SOAP服务来接收。
1.环境配置
为了运行程序,我们首先必须配置好环境:
共要下载四个软件包,它们都是开源免费的。
其中,前两个是Apache的,后两个是SUN的,如下所示:
⏹ SOAP:
apache.freelamp./ws/soap/version-2.3.1/
⏹ Xerces:
xml.apache.org/dist/xerces-j/
⏹ JavaMail:
java.sun./products/javamail/downloads/index.html
⏹ JAF:
java.sun./products/javabeans/glasgow/jaf.html
下载后将它们分别解压缩。
分别在这四个包的解压目录中找到:
xerces.jar、soap.jar、mail.jar、activation.jar(JAF的),则是四个jar文件是我们所需要的。
本机安装环境:
WindowsXP(SP2)+JDK1.4.2_06+Tomcat5.0.28+SOAP2.3.1
配置步骤:
1、安装JDK和Tomcat。
过程比较简单,这里不再详述。
2、将刚才所找到的四个jar文件复制到Tomcat的“Tomcat5.0\mon\lib”目录下,这个目录是Tomcat的默认包目录,在这个目录中的所有包在Tomcat启动时都会被自动加载。
3、将\JDK1.4.2\lib\路径下的tools.jar也复制到Tomcat的“Tomcat5.0\mon\lib”目录下。
4、将soap解压目录的webapps目录下的soap.war文件,复制到Tomcat的“Tomcat5.0\webapps”目录下,这个目录是Tomcat的WEB应用所在目录。
重新启动Tomcat,Tomcat会自动将其解压,并配置好路径。
可以尝试在浏览器中输入“localhost:
8080/soap/”,看SOAP是否安装好。
5、注意在编写程序时,需要将所得到的四个jar文件路径设置到所使用的Java编程环境中,因为在程序中需要用到其中的类文件。
具体步骤略。
6、重启Tomcat服务。
这时Tomcat会将“Tomcat5.0\mon\lib”目录下新加入的包加载到内存中。
到此,我们已经配置好了程序运行所需要的环境。
2.基于SOAP的XML文档网络传输
SOAP规X主要定义了四个元素:
SOAP信封规X,传输和协议绑定,编码规则和一个RPC协定。
用于实现消息的网络传输。
⏹ SOAP信封规X,SOAP信封规X对计算机间传递的数据如何封装定义了具体的规则。
这包括应用特定的数据,如要调用的方法名,方法参数和返回值;还包括谁将处理封装内容,失败时如何编码错误消息等信息。
⏹ 数据编码规则,为了交换数据,计算机必须在编码特定数据类型的规则上达成一致,SOAP也有自己的一套编码数据类型的约定。
大部分约定都基于W3CXMLSchema规X。
⏹ RPC协定,SOAP能用于单向和双向等各种消息接发系统。
SOAP为双向消息接发定义了一个简单的协定来进行远程过程调用和响应,这使得客户端应用可以指定远程方法名,获取任意多个参数并接受来自服务器的响应。
⏹ 传输和协议绑定,提供了更底层协议传输SOAP封套的一套通用机制。
而以上四个部分统称为一个SOAP消息。
我们先来看一篇XML文档是如何变成SOAP的。
采用一个简单的购物订单文件PO.xml。
内容为:
xmlversion="1.0"encoding="UTF-8"?
>
oreilly-jaws-samples">
JoeSmith
14OakPark
Bedford
MA
01730
CandyCanes
444
1.68
Iwantcandy!
其对应的SOAP消息为:
POST/ServletTemp/HTTPReceiveHTTP/1.0
Host:
localhost
Content-Type:
text/xml;charset=utf-8
Content-Length:
939
SOAPAction:
"urn:
oreilly-jaws-samples"
xmlversion=1.0encoding=UTF-8?
>
Envelope
xmlns:
SOAP-ENV="schemas.xmlsoap.org/soap/envelope/"xmlns:
xsi=".w3.org/2001/XMLSchema-instance"xmlns:
xsd=".w3.org/2001/XMLSchema">
Header>
MessageHeaderxmlns:
jaws="urn:
oreilly-jaws-samples"SOAP-ENV:
mustUnderstand="1"xmlns:
SOAP-ENV="urn:
oreilly-jaws-samples">MeYou9999
MessageHeader>
Header>
Body>
oreilly-jaws-samples">
JoeSmith
14OakPark
Bedford
MA
01730
CandyCanes
444
1.68
Iwantcandy!
Body>
Envelope>
一个SOAP消息包括:
SOAP封套,SOAP头(可选),SOAP主体。
我们首先将XML文档包装到一个SOAP体中,然后再把SOAP体包装到一个SOAP封套中,可以在封套中再添加一个SOAP头(不是必须),最后将SOAP封套绑定到一个协议中。
我们来仔细分析一下代码。
⏹ SOAP封套
SOAP封套的声明在XML标签的最外层,它表明了一个SOAP文档的边界。
下面的封套标签显示了三个必要的属性,这些属性指明了封套中使用的名字空间和语法。
Envelope
xmlns:
SOAP-ENV="schemas.xmlsoap.org/soap/envelope/"xmlns:
xsi=".w3.org/2001/XMLSchema-instance"xmlns:
xsd=".w3.org/2001/XMLSchema">
……
Envelope>
其中第一个属性:
xmlns:
SOAP-ENV="schemas.xmlsoap.org/soap/envelope/"是一个名字空间声明,防止多个XML文件组合时发生标签名字的冲突。
第二个属性声明了XML模式实例的名字空间。
前缀xsi必须放在这个名字空间定义的所有元素和属性之前。
最后一个属性是另外一个名字空间声明,它定义了XMLSchema名字空间,这个名字空间下的元素用来指定xsi:
type属性的值(如xsd:
string)。
⏹ SOAP头
SOAP头和体在语法上非常类似。
SOAP1.1和SOAP1.2都没有头里应该有些什么,它就是简单的存放一些指令,提供给接收消息的SOAP处理器。
建立在SOAP之上的更高级协议(比如ebXML消息服务)就通过定义一些特殊元素来规XSOAP头的格式。
另外当对RPC使用SOAP时,头部也可以用来表示一些底层信息。
Header>
MessageHeaderxmlns:
jaws="urn:
oreilly-jaws-samples"SOAP-ENV:
mustUnderstand="1"xmlns:
SOAP-ENV="urn:
oreilly-jaws-samples">MeYou9999
MessageHeader>
Header>
⏹ SOAP主体
SOAP主体用来存放实际数据或消息的有效负载(本例中为XML文档),从而提供给最终的接受者使用或处理。
⏹ SOAP协议绑定
当绑定到一个HTTP协议时,需要在SOAP封套前面添加HTTP头的信息。
POST/ServletTemp/HTTPReceiveHTTP/1.0
Host:
localhost
Content-Type:
text/xml;charset=utf-8
Content-Length:
939
SOAPAction:
"urn:
oreilly-jaws-samples"
在SOAP1.1中SOAPAction是HTTP绑定所必须的部分,它的目的是让