Java

本类阅读TOP10

·使用MyEclipse开发Struts框架的Hello World!(录像1)
·hibernate配置笔记
·AOP编程入门--Java篇
·linux下Tomcat 5.0.20 与 Apache 2 安装/集成/配置
·在win2003下整合了整合Tomcat5.5+ apache_2.0.53+ mod_jk_2.0.47.dll
·构建Linux下IDE环境--Eclipse篇
·Jsp 连接 mySQL、Oracle 数据库备忘(Windows平台)
·ASP、JSP、PHP 三种技术比较
·Tomcat5.5.9的安装配置
·AWT GUI 设计笔记(二)

分类导航
VC语言Delphi
VB语言ASP
PerlJava
Script数据库
其他语言游戏开发
文件格式网站制作
软件工程.NET开发
Sun ONE Application Server 开发者指南(19)

作者:未知 来源:月光软件站 加入时间:2005-2-28 月光软件站

 

SOAP消息

本节向你介绍SOAP消息的结构和组成部分、如何访问它们、以及如何处理SOAP消息。本节讲述以下主题:

SOAP消息的组成部分

SOAP消息是一个包括SOAPEnvelope、一个可选的SOAPHeader、以及SOAPBodyXML文件。SOAP消息头包含了使消息在到达最终目的地之前,能够被路由到一个或多个中间节点的信息。

  SOAP消息的组成部分
这个图展示了SOAP消息的结构和组成部分。不同对象代表了SOAP消息的每一个部分。

SOAPMessage对象包括:

  • 一个SOAPPart对象,其中包括
    • 一个SOAPEnvelope对象,其中包括
      • 一个空的SOAPHeader对象可选,包括它是为了方便,因为大多数消息都要用到它。
      • 一个空的SOAPBody对象 -可以容纳消息的内容,还能容纳包含了状态信息或者消息故障明细的错误消息。
  • AttachmentPart可能容纳普通文本或者图像文件。

SOAPEnvelope是代表消息的XML文件的根元素。它为消息如何处理、由谁处理定义了框架。XML内容从SOAPEnvelope开始。

SOAPHeader是添加特性到SOAP消息的基本机制。它可以容纳任意数目的扩展了基础协议的子元素。例如,header子元素可能会定义认证信息、事务信息、本地信息、等等。处理消息的软件可以在没有事先约定的情况下,使用这个机制定义谁应该处理某个特性,以及该特性是强制的还是可选的。

body是发给消息最终接收者的强制信息的容器。SOAP消息还可以容纳一个附件,它不一定非得是XML文件。

访问消息的元素

当创建消息体或附件的时候,以及处理消息的时候,你需要访问消息的组成部分。

SOAPMessage对象含有一个SOAPPart对象。通过message对象可以得到它。

SOAPPart soapPart = message.getSOAPPart();

然后你可以利用SOAPPart获得它所含有的SOAPEnvelope对象。

SOAPEnvelope envelope = soapPart.getEnvelope();

现在你可以利用envelope获得它的空SOAPHeaderSOAPBody对象。

SOAPHeader header = envelope.getHeader();

SOAPBody body = envelope.getBody();

SOAPBody对象最初是空的。

命名空间

XML命名空间是一种限定元素和属性名称的方法,目的是消除它们与同一文件中其他名称之间产生的歧义。一个名确的XML命名空间声明采用如下格式:

<prefix:myElement

xmlns:prefix ="URI">

声明定义prefix作为一个特定URI的别名。在myElement元素内,你可以对任何元素或属性使用前缀,从而指定元素或属性属于URI指定的命名空间。下面的代码是命名空间声明的一个例子。

<SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/">

该定义定义了SOAP_ENV作为命名空间http://schemas.xmlsoap.org/soap/envelope/

的别名。

定义了别名之后,可以使用它作为Envelope元素中任何属性或元素的前缀。

预定义的SOAP命名空间

  • SOAPEnvelopeSOAP消息的根元素,拥有下面的命名空间标识http://schemas.xmlsoap.org/soap/envelope
  • SOAP serialization,定义SOAP序列化规则的URI,拥有下面的命名空间标识"http://schemas.xmlsoap.org/soap/encoding".

当使用SAAJJAXM构造或者消费消息的时候,你有责任保证正确设定或处理命名空间,并且丢弃含有错误命名空间的消息。

创建SOAP消息的时候使用命名空间

当创建SOAP消息的bodyheader元素的时候,你必须使用命名空间为元素指定一个完整的名称。通过调用方法SOAPEnvelope.createName可以获得一个名称。

调用该方法时,可以传递一个本地名称作为参数,或者可以指定本地名称、前缀、以及URI。例如,下面的命令行定义了一个名为bodyNameName对象。

Name bodyName = MyEnvelope.createName("TradePrice", "GetLTP", "http://foo.eztrade.com");

这和下面的命名空间声明作用相同。

<GetLTP:TradePrice xmlns:GetLTP= "http://foo.eztrade.com">

下面的代码演示了如何创建一个名称并把它和SOAPBody元素绑定。注意createName方法的使用和位置。

SoapBody body = envelope.getBody();//get body from envelope

Name bodyName = envelope.createName("TradePrice", "GetLTP", "http://foo.eztrade.com");

SOAPBodyElement gltp = body.addBodyElement(bodyName);




相关文章

相关软件