SOAP北京航空航天大学课件

SOAP2006-05主要内容SOAP发展历史SOAP的主要功能SOAP协议组成部分信封标题RPC相关应用发展历史SOAP最早由DaveWinner、DonBox和BodAtkinson提出。在1987年，Microsoft开始考虑基于XML的分布式计算，其目标是使应用程序能够使用HTTP上层的远程过程调用(RPC)相互通信。DevelopMentor和Userland加入到了讨论。在1998年初，S0AP名字就已经被确定。Userland在1998年发布了一个XML-RPC规范。1999年9月SOAP0.9提交IETF。2000年5月8日，SOAP1.1作为Note提交W3C。IBM发布JavaSOAP实现，并给开放源代码组织ApacheXMLProject。Sun公司将Web服务集成到J2EE中。2000年9月13日，W3C组建了XML协议工作组，专门负责设计XML协议，以便成为基于XML分布式计算的核心。这个工作组将SOAP1.1作为基础，并于2001年7月9日提交了第一份工作组草案SOAP1.2。SOAP概述SOAP主要功能：定义通信单元的机制：一个SOAP封套封装了所有其他的信息。一个消息可以有一个消息体，消息体中可以包含任何XML格式文档。错误处理机制：标识错误源和导致错误的原因，并允许错误诊断信息在共享者和交互者之间传递。可扩展件机制：使用XML模式和名字空间技术，灵活扩展元素。灵活的数据表示机制：允许交换已经以某种格式序列化的数据，同时也提供了以XML格式表示诸如编程语言数据类型这样的抽象数据结构的规则。表示远程过程调用(RPC)和作为响应的SOAP消息的约定，并且便于映射为过程式编程语言结构。支持以文档为中心的方法。将SOAP消息束定到HTTP的机制，因为HTTP是Internd上最常用的通信协议。SOAP基于XML的协议，由四部分组成:信封（Envelope）：定义了一个消息框架，描述消息的内容是什么，是谁发送的，谁应当接受并处理它以及如何处理。编码规则（EncodingRules）：用于表示应用程序需要使用的数据类型的实例。绑定（Binding）：定义底层通信协议，进行消息交换。RPC：表示远程过程调用和应答的协定。命名空间"""""http://""oding""wsdl/""wsdl/soap"""

SOAP用例<env:Envelopexmlns:env=""><env:Header>

<n:alertcontrolxmlns:n=""><n:priority>1</n:priority><n:expires>2001-06-22T14:00:00-05:00</n:expires>

</n:alertcontrol></env:Header>

<env:Body>

<m:alertxmlns:m=""><m:msg>PickupMaryatschoolat2pm</m:msg>

</m:alert></env:Body></env:Envelope>MessageEnvelopeSOAP结构SOAP消息是由一个SOAPEnvelope、一个可选的SOAPHeader和一个SOAPBody组成的XML文档。元素和属性的命名空间标识是""。SOAP消息应当包含如下部分：一个SOAPenvelope。Envelope是表示该消息的XML文档的根级元素。一个SOAPHeader。Header是为了支持在松散环境下在通讯方之间尚未预先达成一致的情况下为SOAP消息增加特性的通用机制。SOAP定义了很少的一些属性来用于指明谁可以处理该特性以及它是可选的还是强制的。一个SOAPBody。Body为该消息的最终接收者所想要得到的信息提供了一个容器。此外，SOAP定义了Body的一个子元素Fault用于报告错误。SOAPHeaderSOAP提供了一个可伸缩的机制用于在分散的模块化的环境下扩展SOAP消息，而通讯双方并不需要有预先的约定知识。典型的扩展例子可以是实现一些诸如认证、事务管理以及支付的Header条目。Header元素应当被编码为SOAPEnvelopeXML文档的第一直接子元素。Header的所有直接子元素都被称为Header条目。Header条目的编码规则包括:一个SOAPHeader条目由一个完整修饰的元素名来标识，所谓完整修饰的元素名是由一个命名空间URI和局部名来组成。SOAPHeader元素的所有直接子元素都必须是完整修饰的。encodingStyle属性可以用于指明Header条目的编码风格。actor属性和SOAPmustUnderstand属性可以用于指明由哪个SOAP结点来处理条目以及如何处理条目。SOAPHeader描述安全凭证事务ID路由调试信息支付令牌……actor属性SOAP消息从生成者到达最终接受者，将潜在地沿着消息路径经过一系列的SOAP中间结点。SOAP中间结点是一个能够接受和转发SOAP消息的应用程序。所有的中间结点都如同最终接受者一样由一个URI来标识。

actor属性用一个RUI标识节点处理对应的文件头时必须扮演的角色。当一个节点接收到一个SOAP消息时，它要分析文件头，以确定哪些代码块是由该节点支持的角色。Header元素中接收者角色类似和约的接受者。一个接收者接到其想要的一个Header元素必须不转发该Header给SOAP消息路径中的下一个应用程序。SOAPactor全局属性可以被用于指明Header元素的接收者。而SOAPactor属性的值是一个URI。这个特别的URI""指明该Header元素是直接的下一个进行消息处理的SOAP应用程序想要的。这与HTTP的连接头字段的hop-by-hopscopemodel的表示。若省略SOAPactor属性，则表明接收者是SOAP消息的最终接收者。SOAPBodySOAPBody元素提供一个简单的用于与消息的最终接收者交换强制信息的机制。而Body元素的典型应用包含序列的RPC调用和错误报告。Body元素在编码上作为SOAPEnvelope元素的一个直接子元素。如果包含Header元素，则Body元素必须直接跟随Header元素，否则Body元素必须是Envelope元素的第一直接子元素。所有Body元素的直接子元素被成为SOAPBody条目，同时每一个Body条目都应当编码为SOAPBody元素里的一个独立元素。SOAPBodyBody条目的编码规则包括:1．一个Body条目由一个完整修饰的元素名来标识，所谓完整修饰的元素名是由一个命名空间URI和局部名来组成。SOAPBody元素的直接子元素可以是命名空间修饰的。2．SOAPencodingStyle属性可以被用来表明Body条目中使用的编码规则。3．SOAP定义了一个Body条目，用于报告错误的Fault条目。SOAP错误SOAPFault元素是用于在SOAP消息中传输错误或状态信息。如果SOAP消息需要包含SOAPFault元素的话，它必须作为一个Body条目出现，同时在Body元素内它必须至多出现一次。SOAPFault元素定义了如下子元素:1．faultcode元素是应那些要提供一个算法上的机制来标识错误的软件的需要。faultcode必须在SOAPFault元素中出现。SOAP定义了一个很小的SOAP错误代码的集合用于覆盖基本的SOAP错误。2．faultstring元素是为那些错误代码提供一个人可以读懂的错误解释，它不是为程序处理而设，提供一些解释该错误种类的信息。3．faultactor元素是为在SOAP消息路径中是谁引起了该错误的发生这一情况描述信息。faultactor属性的值是一个标识该源的一个URI。所谓并非作为SOAP消息最终接收者的应用程序必须在SOAPFault元素中包含faultactor元素。而消息的最终接收者可以使用faultactor元素来明确地指明是它生成了该错误。4．detail元素是用于传输与SOAPBody元素相关的应用程序特别的错误信息。如果Body元素中的内容不能被成功地处理的时候，它必须出现。它必须不能被用于传输属于Header条目的错误信息。SOAP编码简单类型SOAP采用了在“XMLSchemaPart2:Datatypes”的“Build-indatatypes”节中定义的所有类型，包括值和词汇空间(lexicalspaces)1．字符串：“string”数据类型在“XMLSchemaPart2:Datatypes”中被定义。2．枚举：“XMLSchemaPart2:Datatypes”规范定义了一种称为“玫举(enumeration)”的机制。3．字节数组：一个Byte数组可以编码为单引用或多引用值。对一个不透明的Byte数组的推荐表示是使用在XMLSchema规范中定义的“base64”编码方式。4．多态存取标识：多态地访问数个类型的值，在运行时刻每个类型都是可使用的。一个多态存取标识实例必须包含一个“xsi:type”属性以描述类型的实际值。SOAP编码复合类型SOAP依照在程序语言中常常看见的以下结构模式来定义复合类型:1．“struct”是一个复合类型值，其成员的存取标识名是相互区别的唯一标志，应彼此各不相同。2．“array”是一个复合类型值，其成员的顺序位置是相互区别的唯一标志。SOAP中的RPCSOAP的一个设计目标就是要利用XML的可扩展性和可伸缩性来包装和交换RPC调用。在RPC中，使用HTTP作为SOAP协议绑定媒介的情况下，一个RPC调用可以很自然地映射到一个HTTP请求，而RPC响应则可以映射到HTTP响应。使用SOAP方式的RPC并不限于HTTP协议绑定。为实施一个方法调用，需要以下信息:1．目标SOAP结点的URI2．方法名3．可选的方法或过程的特征4．方法或过程的参数5．可选的头数据

SOAP依赖协议绑定来提供传送URI的机制。SOAP请求消息<SOAP-ENV:Envelope

xmlns:SOAP-ENV="http://{soaporg}/envelope/"

SOAP-ENV:encodingStyle=

"http://{soaporg}/encoding/"><SOAP-ENV:Body><m:QuotePricexmlns:m="Some-URI"><commodity>Computer</commodity></m:QuotePrice></SOAP-ENV:Body></SOAP-ENV:Envelope>RPC和SOAPBody该方法响应显示为一个简单结构struct，包含每个[out]或[in/out]参数的存取标识。而第一个存取标识是返回值，而随后则是按照原来次序的返回参数。每个[out]或[in/out]参数都被表示为一个存取标识，该存取标识的名和类型都对应于相应参数的名和类型。返回值的存取标识名并没有多少语义。同样的，结构的名也并没有多少语义。当然，无论如何，在添加了“Response”字串的方法名后，要有一个约定来命名它。方法调用出错应使用SOAPFault元素来编码。如果一个绑定协议对于错误表达还有额外规则，那么这些规则都应当被遵守。方法和响应的结构可以使用规则来编码，也可以使用在encodingStyle属性中描述的其他编码。应用程序可以处理漏写参数的请求不过也可以返回一个错误。因为在响应中若包含“result”则表明成功，若包含“fault”则表明失败，所以如果方法响应中同时包含了“result”和“fault”则是错误的。在HTTP中使用SOAP

SOAP利用HTTP的请求/响应消息模型，将SOAP请求的参数放在HTTP请求里，而将SOAP响应的参数放在HTTP响应里。SOAPActionHTTP请求头字段(headerfield)可以用于指示SOAPHTTP请求的目的。它的值是一个标识该目的的URI。POST/StockQuoteHTTP/1.1Content-Type:text/xml;charset="utf-8"Content-Length:nnnn

SOAPAction:"http:///abc#MyMessage"<env:Envelope

xmlns:env="">...</env:Envelope>在HTTP之上的SOAP遵从用于在HTTP中表示通讯状态的HTTP状态代码的语义。

HTTP/1.1200OKContent-Type:text/xml;charset="utf-8"Content-Length:nnnn

<env:Envelope

xmlns:env="">...</env:Envelope>SOAP工具列表Company/OrganizationReporting

ImplementationName

ImplementationVersionSpecVersion/CommentApacheGlenDanielsAxisBeta1andafterLimitedsupportforJuneSOAP1.2specinBeta1,andfortheDecemberSOAP1.2specinthecurrentCVSimplementation.Don'tyetfullysupportnewencodingorallfaults,butweplantobefullycompliantsoon,trackingthespecintofuturereleases.BEADavidOrchard

WebLogicServer8.0andlaterBEAprovidesasoap1.2endpointat.EndpointcontactisManojCheenath.MicrosoftHenrikFrystykNielsen

BizTalkInordertohelpmeetingtheW3Cimplementationrequirements,MicrosoftwillprovideapublicendpointthatcanacceptincomingSOAP1.2messagesandbeabletogenerateSOAP1.2messagesandsendthemtootherSOAP1.2endpoints.Endpointisat(Contacts:AlexDeJarnatt<>andJohnKoropchak<>).SOAPLitePaulKulchenko

SOAP::Lite0.55andlaterLimitedsupportforSOAP1.2.PlantosupportmostofthespecbeforeMarch2003.SystinetJacekKopecky

WASPServerforJava4.0WASP4.5supportsmostfeaturesoftheJune2002LastCalldraftofSOAP1.2.Endpointisavailable,seeformoreinformation.TIBCODonMullen

WebServicesSDK2.0TIBCO'sSOAP1.2endpointisavailableatWhiteMesaBobCunnings

WhiteMesaServer3.0EndpointsupportsSOAP1.2,seefordetails.SOAP工具列表Company/OrganizationImplementationName

ImplementationVersionSpecVersion/CommentIBMWebsphere5.0orlaterApacheSOAPhasworkedundereveryversionofWebSpherefrom1.1to3.02.ItwillworkoutoftheboxonWebSphere3.5wit