GB/T29798-2013

信息技术基于Web服务的IT资源管理规范

Informationtechnology-ITresourcemanagementspecificationbasedonwebservices

本文分享国家标准信息技术基于Web服务的IT资源管理规范的全文阅读和高清PDF的下载,信息技术基于Web服务的IT资源管理规范的编号:GB/T29798-2013。信息技术基于Web服务的IT资源管理规范共有180页,发布于2014-05-01
  • 中国标准分类号(CCS)L79
  • 国际标准分类号(ICS)35.100.05
  • 实施日期2014-05-01
  • 文件格式PDF
  • 文本页数180页
  • 文件大小2.35M

以图片形式预览信息技术基于Web服务的IT资源管理规范

信息技术基于Web服务的IT资源管理规范


国家标准 GB/T29798一2013 信息技术 基于Web服务的IT资源管理规范 Informationtechnology一Iresource mnugememspeifeation basedon Webservices 2013-11-12发布 2014-05-01实施 国家质量监督检监检疫总局 发布 国家标准花管理委员会国家标准

GB/T29798一2013 目 次 前言 范围 规范性引用文件 术语和定义 缩略语 资源寻址 5.1概述 5.2寻址管理 5.2.1引言 5.2.2端点引用 5.2.2.1端点引用的格式 5.2.2.2绑定端点引用 5.2.3消息信息头部 5.2.3.1概述 5.2.3.2构成响应消息 5.2.3.3wSDL操作的关联行为 5.3寻址版本 5.3.1引言 5.3.2技术不同点 5.!兼容性要求 5,4.1发现或协商 5.4.2客户协商策略 5.4.3初始化消息交换 5.4.4规则 5.5寻址使用 2 5.5.1端点引用的使用 2 5.5.2默认寻址模型 5.5.2.1 2 概述 5.5.2.2 RerourceURI 选择器 5.5.2.3 5.5.2.4默认寻址模型的出错消息 20 5.5.3服务特定寻址模型 5.5.4必须遵守的属性 20 5.5.5头信息wsa:To 5.5.6其他寻址头信息 5.5.6.l 处理寻址头信息 22 5.5.6.2 :ReplyTo wsa
GB/T29798一2013 5.5.6.3 wsa:FaultTo 23 5.5.6.4 elD和wsa:RelatesTo 23 wsa:Message 5.5.6.5 24 WwsaAction 5.5.6.6 wsa:From 26 26 控制头部 6.1 wsman:OperationTimeout 26 wsman;MaxEnvelopeSiz 21 6.2 6.3 28 wSman:ocale 26 6.4 wSmanOptionSet 6.5 wsman:ReguestEPR 31 32 资源访问 32 7.1概述 3 7.2寻址一致性 35 7.3Get操作 36 7.4Put操作 7.5 4 Delete操作 7.6Create 操作 7; 片段级访问 7.8片段级Get 46 15 片段级Put 48 7.10片段级Delete 5d 7.11片段级cr 5 reate 53 资源枚举 8.1 53 概述 5 8.2枚举Enumerate操作 54 8.2.1概述 8.2.2枚举的Count选项 5 58 8.2.3对小结果集枚举的优化 6d ? 8.3过滤器解释 8.4 62 Pull操作 65 8.5Release操作 8.6 67 Hoe查询和片段级枚举 68 枚举EPRs 8.8Renew 69 更新枚举操作 8.9 GetStatusEnumeration 获得枚举状态操作 72 8.10EndEnumeration 终止枚举操作 用户自定义动作(方法) l0 73 事件通知 73 10.l 概述 74 10.2订阅操作 74 10.2.1引言 78 10.2.2过滤
GB/I29798一2013 80 10.2.3重连接 80 10.2.4订阅响应SubscribeResponse 81 10.2.5心跳 82 10.2.6书签 10.2.7递送模式 84 85 10.2.8事件行为URI 10.2.9递送次序以及通知 85 10.2.9.1概要 85 85 10.2.9.2推模式 10.2.9.3带响应的推模式 86 10.2.9.4批量递送模式 So 10.2.9.5拉递送模式 90 10.3获得订阅状态GetStatusSubscription 91 10.4取消订阅 992 10.5更新 93 10.6终止订阅SubseriptionEnd 94 10.7递送的确认 95 10.8拒绝递送 96 10.9丢失的事件 96 10.10访问控制 98 10.11实现考虑 98 10.12通知的广告 98 11元数据以及发现 99 12安全 101 12.1 概述 101 12.2安全配置文件 101 12.3对于事件订阅的安全考虑 101 12.4订阅和事件的相关性 103 12.5传输级的认证失败 103 12.6第三方订阅的安全问题 103 13 传输和信息编码 103 103 13.1sOAP 13.2响应丢失 104 3.3消息重现 105 13.!编码限制 105 13.5二进制附件 105 3 大小写敏感 105 106 14出错信息 14.1 + 106 概述 106 14.2出错消息编码 * 107 14.3出错消息 108 14.4退化的出错信息
GB/T29798一2013 108 14.5出错信息的扩展性 109 14.6主要出错消息 128 附录A规范性附录标记约定 130 附录B规范性附录符合性规则 131 附录C规范性附录HTTP(S)传输和安全配置文件 137 附录D(资料性附录XPath支持 142 附录E规范性附录选择过滤器语言 附录F资料性附录ldentifyXMISchema 附录G(资料性附录)资源访问操作的XMLSche ma和WSDL 146 附录H(资料性附录)XMI空间和wsDL中的枚举操作 150 附录I资料性附录 NotificationOperationsXMlSchema和WSDL 158 附录(资料性附录)XML空间的寻址操作 166 参考文献 169
GB/T29798一2013 前 言 本标准按照GB/T1.1一2009给出的规则起草 请注意本文件的某些内容可能涉及专利 本文件的发布机构不承担识别这些专利的责任 本标准由全国信息技术标准化技术委员会(SAC/TC28)提出并归口 本标淮起草单位电子技术标雅化研究所,复旦大学、上海宝信软件股份有限公司、上海北塔软 件股份有限公司、浪潮集团有限公司、北京中科红旗软件技术有限公司、中标软件有限公司 本标准主要起草人吴杰,昌智慧,袁媛,高林、王潮阳、刘贤刚、刘琳、周明、文中领,刘正伟

GB/T29798一2013 信息技术 基于web服务的I资源管理规范 范围 本标准通过定义基于sOAP的web服务协议格式,给出了系统资源管理的一个通用操作集合,并 定义了其最小实现要求 本标准适用于基于web服务的网络资源管理,管理对象包括PC机、服务器、设备、web服务、应用 软件及其他可管理实体系统 规范性引用文件 下列文件对于本文件的应用是必不可少的 凡是注日期的引用文件,仅注日期的版本适用于本文 件 凡是不注日期的引用文件,其最新版本(包括所有的修改单)适用于本文件 GB13000-2010信息技术通用多八位编码字符集(UcS) IETFRFC3066语言鉴定标签(TagsfortheIdentificationofLanguages) IETFRFc3986统一资源标识符(Uniformresourceidentifier(URL);Genericsyntax IETFRFC4559Mierosoftwindows、中基于sPNE(GO的kerberos和NTLMHTTP身份鉴别 (SPNEGO-basedKerberosandNTIMHTTPAuthenticationinMierosoftWindows) OAsIsweb服务用户名令牌配置webServicesSecurityUsernameTokenProfile1.0) w3C简单对象访问协议(Simpleobject accessprotocol,S(O)AP w3CsoAP消息传输优化机制(sOAPMessagetransmissionoptimizationmechanism w3Cweb服务策略框架规范ws-Polieyfranmework) w3CXM1路径语言(w3cXMI.Pathlanguuage) w3CXML信息集第二版w3CXMLInformationSet2.0) w3CXM模式第一部分结构(w3CXMLSchemaPartl:Structures) w3CXML模式第二部分;数据类型(w3CXM1SchemaPart2;Datatypes) w3cweb服务寻址-核心(webservitces Addressing-Core) w3Cweb服务寻址-SOAP绑定webServicesAddressing-SOAPBinding w3Cweb服务寻址-元数据(webServicesAddressing-Metadata w3C可扩展语言w3CeXtensiblemarkuplanguage,XM1 w3CXML名称空间(NamespacesinXML 术语和定义 下列术语和定义适用于本文件 客户elient 使用本标准中定义的web服务来访问管理服务的客户端应用
GB/T29798一2013 3.2 消费者 cOnsumer 请求从数据源枚举数据的一个web服务 3.3 数据源datasouree 支持通过标准定义的枚举操作并使用枚举上下文遍历数据的一个web服务 递送模式deliverymode 事件消息从源端发送到接收者的机制 3.5 枚举上下文enumerationconmtext 应用Pull操作,通过XML元素信息构成的逻辑序列来表达特定遍历的一个会话上下文 3.6 事件宿eventsink 个接收事件通知(noifeations)的web服务 事件源eventsoure 发送通知和接收请求来创建订阅的web服务 3.8 被管资源managedresouree 管理者感兴趣的一个实体 注:可以是一个物理对象,比如笔记本电脑或打印机,也可是一个抽象实体,比如一个服务 3.9 通知notification 表明事件已发生的一个消息 3.10 pwshhmle 推模式 -种递送机制,sOAP事件消息以单独的异步方式从源端发送到接收者 3.11 资源 reS0urce 一个web服务 这种资源可通过一个 可通过端点引用寻址,并可使用标准中定义的操作访问的 xML文档来表逃 这个xML.文悄也作为被管资课的表示 3.12 resourceclass 资源类 被管资源的一个抽象表示(类型). 注:资源类定义了与管理相关的操作和属性的表示形式,例如,笔记本电脑的一系列操作和属性的描述就是一个资 源类 3.13 资源工厂 faetory reS0urce 能使用标准中定义的创建(ereate)操作创建新资源的一个web服务 3.14 资源实例 resOurceinstance -个资源类实例化的结果 例如,笔记本电脑的一系列与管理相关的操作以及属性值
GB/T29798一2013 3.15 选择器 SelectOr 当应用默认的寻址模型时,选择器是用于判别实例的一对与资源相关的名称和值 展开来说,选择 器实质上是一个标识了所需要资源实例的过滤器(filter)或键值(key) 当使用服务指定的模型时,可 能并不需要选择器 3.16 服务service 通过规范化的描述来表征、对外提供访问地址、并可被重复使用的业务功能单元 示例审批服务、客户管理服务、登录注册服务等 注1:创建服务的目的是为了供需要使用该服务实现的功能的使用者调用 注2每个服务通过规范化的描述来表征,包括接口,操作,语义,动态行为,策略,服务质量等描述 [GB/T29262一2012,定义2.8] 3.17 订阅者subseriber 发送创建、更新,副除订阅请求的一个wb服务 3.18 订阅管理者subseription manager 代替事件源接收请求来获取订阅状态、更新、删除订阅的一个web服务 缩略语 下列缩略语适用于本文件 BNF巴科斯范式(Backusnormalform) BOM字节顺序标记(byte-ordermark CQL公共信息模型查询语言cIMQueryLanguage) EPR端点引用endpointreferencey GssAPI通用安全服务应用程序接口(GenericSecurityServicesApplicationProgramlnterface) sOAP简单对象访问协议(SimpleobjeectAccessProtocol SPNEG0简单保护GSSAP的协商机制SimpleandProteetedGSSAPINegotiationMeehanism) SQL结构化查询语言(StructuredQueryLanguage) URI统一资源标识符(UniformResoureeIdentifier) UR1统一资源定位符UniformResourceLocator) UTFUCS转换格式(UC'sTransforrmationFormat) UUID通用唯一标识符UniversallyUniqueldentifier wsDL.web服务描述语言webServiceDeseriptionL.anguage) 5 资源寻址 5.1概述 本标准使用基于sOAP的寻址机制(见5.2)来定义web服务端点引用和所使用的sOAP消息头 部分(参见附录J 5.3指出如何解决5.2和w3C推荐寻址方式中定义寻址机制的版本问题 本标准若没有明确指 出,“寻址”一般是指5.2中定义的情况
GB/T29798一2013 多种寻址模型可使用5.4中描述的方式 实际应用中可实现以下任何一种处理模型: 5.2中定义的基本寻址模型 5.5.2中定义的默认寻址模型 本标准没有定义新的寻址模型 这些寻址模型可能会对寻址产生额外限制 5.2寻址管理 5.2.1引言 本条定义两个可互操作的结构,端点引用和消息头部,它们传输的信息通常由传输协议和信息系统 提供 这些结构将这些基本信息规格化成统一格式,使得它们可以被传输或被应用独立处理 web服务端点是一个实体、处理器或资源,它可以被引用.也可作为web服务消息的目的对象 端点引用传递的信息需要标示和引用一个web服务端点,可在多种方式中使用 端点引用包含访问web服务端点需要的信息 端点引用也用于为单个消息提供接收或发送web服务寻址功能(参见附录J 为了处理后者情况,本条定义一组消息信息头部,使统一的消息寻址独立于底层传输 这些端到端 的消息头部特征包括源,目标端点和消息标识的寻址(参见附录J 例如,下面的例子阐述了在sO)AP1.2消息中使用的机制 参见http;//business456.example/eli entltohttp://fabrikkaml23.example/Purehasing 到一/s,Header>描述了soAP1.2消息的头部机制,机制由使用条件来决定 消 息体在至一/S:Body>中被描述 指出消息标识 wsa:MessagelD 到 wsa:MessagelD wsa: 到 ReplyTo /wsa;ReplyTo>指出消息应被回复的端点引用地址 指出消息最终接 收者地址URI wsa;Aetion>标签指出符合语法的操作URI S;Envelope xmlns: S=p 1/2003/05/soap-envelope //www.w3.org/" s/2004/08/atdressing" xmlns;别sa="http://schemas.>xalsoap.org/ws/ S:Header wsa:MessageID uuid.6B29rC40-CA47-1067-B31D-00DD010662Da /wsa:MessageID wsa:ReplyIo wsa:;Address>http:/business456.example/client1之/ .Address> wsa; wsa:ReplyTo wsa;To>http://fabrkam123.example/Purchasing/wsa;Io. /fabrikam123.example/SubmitP0/wsa:Action wsa;Action>http: /S:Header S:Body /S;Body> /S:Envelope 5.2.2端点引用 5.2.2.1端点引用的格式 本条定义了端点引用的xML表述,包括xML类型(wsa.:EmdpointReferenceType)和xML.元素 :EndpointReference>). wsa
GB/T29798一2013 wsa;EndpointReferenceIype类型用于任何引用web服务端点的地方 以下描述了这种类型的内容 wsa:EndpointReference Address wsa:Address -e;anyUR /wsa:1 wsa:ReferenceProperties /wsa:ReferenceProperties wsa:ReferenceParameters wsa:ReferenceParameters xs:OName PRarype wsa;PortT'ype wsa WC :ServiceNamePortName="xs:NCName"?>xs:QName wsp:Policy /wsp:Policy /wsa:Endp0intReference 以下描述了属性和元素 wsa:EndpointReference: 表示wsa;EndpointReference类型的元素,这个例子使用预定义的wsa;EndpointReference元素 wsa:EndpointReference/wsa:Address: 该(类型xs;anyURI的)必要元素指定标识端点的寻址URI(参见附录J) 这个地址可以是服务端 点的一个逻辑地址或标识 ;EndpointReference/wsa;RefereneePrc wsa; roperties/: 该可选元素包含与端点有关的任何数量的引用属性 端点引用属性是xML元素,需要和端点进 行合适的交互 引用元素由端点引用提供者提供,否则假设成对用户应用透明 不赞成使用引用属性,可以使用引用参数代替 wsa:EndpointReference/wsa:ReferenceProperties/any ReferenceProperties的每一个子元素表示一个独立的参考属性 wsa;EndpointReference/wsa;ReferenceParameters/ 该可选元素包含任何与端点有关的独立参数 引用参数是与端点交互所需的XML元素 引用参 数由端点引用提供者提供,否则假设成对用户应用透明 参照5.4中本标准具体提到的引用参数 wsa:EndpointReference/wsa:ReferenceParameters/any 每一个引用参数的子元素代表了一个单独的引用参数 wsa:EndpointReference/wsp:Policy 该可选元素指出 了 种与端点交互相关的规则 一些XM规则元素(在wS-Poliey中描述的元 素),指出了它的行为,需求和端点的能力 这些规则可在端点中更容易被处理,因为它是动态生成的 但是,当发生交互时,与其不一致或失效的内部规则不具有约束力 wsa:EndpointReference/wsa a;PortType 这个可选的元素指出了端点的主要端口类型的值 wsa:EndpointReference/wsa:ServiceName 可选的元素,指定了wsdl;service定义,包括端点引用的wsDL描述 服务名提供了一个服务端 点的完全描述 一个可选名称标识了服务中对应的端口号 /@Pa Name wsa:Endpointl tReference/wsa:ServiceName/ Port 可选的属性,指定了wsdll;port的名称 wsa;EndpointRedference/@(any 这是一个允许额外指定属性的扩展机制 例如,下面阐述了一个端点引用的例子 这个元素引用了URI:http://www.labrikeaml23.exampe/acct inabX=" http://www.fabrikam123.example/acct一/wsa:Address /wsa;BndpointReference
GB/T29798一2013 5.2.2.2绑定端点引用 当 -条消息需要对端点引用寻址时,在端点引用中所包含的信息根据发送消息中使用的协议和数 据表示的转换映射到消息中 指定协议映射或绑定)定义端点引用中的信息如何被复制到消息和协议 字段 本条定义了端点引用的sOAP绑定 这个映射可被其他绑定(wSDL绑定或规则)取代,然而没 有可用策略表明使用了一个不同映射,假设应用这里定义的sOAP绑定 为确保和大范围设备的互操 作性,所有一致性实现应支持sOAP绑定(见附录B) 端点引用的sOAP绑定由以下两条规则所定义 R5.,2.2.2-1;端点引用中的 wsa;Address元素被复制到wsa;To的sOAP消息头部域中 R5.2.2.2-2每一个引用属性和引用参量元素都成为sOAP消息的头部 每一个引用属性或参量 的元素(包括所有子元素,属性和内部命名空间)被添加到新消息的头部 例如:下面的例子说明如何使用sOAP绑定来构造端点引用消息 Wsa:EndpointReferencexmlns;Wsa= Xxmlns:fabrkam= wsa:Address>http://www.fabrikam123.example/acct一/wsa;Address wsaReferenceParameterS 123456789 fabrkam:CustomerKey 7fabrikam:CustomerKey fabrikam:ShoppingCart>ABCDEEG/fabrikam:ShoppingCart /wsa:ReferenceParameters /wsandpointReference 按照前面陈述的映射规则,地址值被复制到To头部,“CustomerKey"元素宜被拷贝到sOAP消息 的端点引用地址中 sOAP消息将会成为以下形式 S:veIpe" Xmlns:S="http://www.W3.org/2003y05/soapenvelope xXImlns:;wsa= xmlns;fabrikam= S:Header To> -http://www.fabrikam123. wsa:" 3.example/acct/wsa;To一 fabrikam:CustomerKey>123456789ABCDEG/fabrikam:ShoppingCart /S:Header S:Body /S:Body一 /S:Bnvelope> 5.2.3消息信息头部 5.2.3.1概述 本条规定了消息头部的语法 消息信息头部共同增加图1所示的头部消息 这些头部能确保标示和查找交互中相关的端点 基 本交互模式是“单向”的 在这个模式中,源无需更多的交互定义就可发送消息到目的端 “请求响应”是一种常见的互动模式,由源端发送最初的消息请求),请求目的端发送随后的消息给 源端(响应) 响应可以是一个应用程序的消息,出错消息,或任何其他信息 该消息的头部提供端到端的消息特性,这使得可以容易的作为一个单元确保安全 这些头部信息 是不变的,不会在消息传输过程中被修改
GB/T29798一2013 消息信息头部内容如下 eID> wSa; agD>石海yR /wsa:Message nn >x8;anyURIxs:anyURI一/wsa:To wsa:Actionxs;anyURI/wsa;Action wsa;From>endpoint-referenceendpoint-reference/wsa:ReplyTo wsa:FaultIo>endpoint-reference一/wsa;FaultTo 下面的描述对上述内容进行补充和限制 wsa:MessagelD 该可选元素(s:anyURI类型)在时间和空间上唯一标识一条消息 若有wsa;Reply或wsa" FaulTo元素,则也应该有wsa;MessagelD元素 此元素不能被任何两条消息共享 头部的值是一个 不透明的URI,对其具体定义不属于本标准的讨论范围 如果消息需要请求答复,则应出现该属性 wsa:RelatesTo 此可选重复)元素指示此消息关联到另一条消息,以UR1-QName对的形式出现 该元素的子元 素(xs;anyURI类型)包含未指定消息的wsa;MessagelD元素 200408 ed http:/7/schemas.xmlsoap.org/ws/ /addressing/id/unspec: wsa;RelatesTo/@RelationshipType 该可选属性作为一个QName的关系类型,当它不存在时,它的默认值是wsa;Reply 在表1中对它有一个关系类型的预定义 表1关系类型 QName 措述 指出这是对由URI标识消息的响应消息 wsa;Reply wsa ;ReplyTo 该可选元素提供用于标识目的接收者回复该消息的端点引用 如果需要一个回复,则必须有该元素 若此元素出现,则wsa.MesugelD也应出现 如果期望一个回复,消息中应包含一个wat a;ReplyT头部 发送者应使用wsa.ReplyTD内容来构成5.2.3.2中定义的回复消息 如果没有wsa:ReplyTo,wa:From头 部内容可用来构成给源端的消息 如果消息中没有有意义的回复,该头部可不出现 wsa:From 该(wsa;EndpointReferenceType类型的)可选元素提供消息产生处的端点引用 wsa:FaultTo 该可选元素提供了指出该出错消息接收者的端点引用 若该元素出现,则wsa;MessageID也应出 现 当构成一个出错消息时,发送者应使用这个头部的内容 若该头部不存在,发送者可使用wsa: Reply的头部 若接收者不能接收出错消息,则该头部可以不出现 wsa;To 该(xs;:anyURI类型的)必选元素提供这条消息的目的接收者地址 wsa:Action 该(xs;anyURI类型的)必选元素唯一(且透明地)标识消息中暗含的语义 对于所有资源端点,如 果服务不支持对特定资源类的某个操作,则服务应返回一个wsa:ActionNotSupported出错信息 若需 要通过分开形式来支持最大化的互操作,实现中也可支持其他用户方法 接收到消息的分发基于两种属性 必选元素 wsa;To和wsa;Aetion标识确定了处理消息的目标
GB/T29798一2013 地址和消息的行为 由于网络技术被广泛使用如NAT,DHCP和防火墙),许多部署者不能够给端点分配一个全局的 URI 为对这些匿名的端点初始化消息交换类型和接收响应,寻址定义了以下的URI http://schemas.xmlsoap.org/ws/2004/08/addressing/role/anonymous 地址头部中使用的 .wsa.From和/或wsa:FautTo元素的请求应提供一些额外的机 wSa 1;ReplyTo 制,用以传送响应或出错消息 这种机制可以是简单的请求或响应传输协议 这个URI可被用来作为 响应消息的wsa:To头.而不宜在其他环境中作为wsa:To头使用(见附录B). 5.2.3.2构成响应消息 个请求消息的响应消息应该可以按照下述的方式构造 示例1:下面的例子刚述了使用so)AP.2消息头部块的请求消息 s:Envelopexmlns:S="http://www.w3.org/2003/05/soap-envelope' 1/ws/2004/08/addressing" Xmlnswsa= http: /schemas.xmlsoap.org/" amlns:123="http://www.fabrikan23.exanple/sve53" S:Header wsa;MessageID>uuid:;aaaabbbb-cccc-dddd-eeee-ff /wsa;MessageID wsa:ReplyTo. wsa;Address //business456.example/client1 一http:/ /wsa;ReplyTo wsa:ToS:mustUnderstand="1"一mailto:joe@fabrikam123.example/wsa:To一 wsa:;Action>http;//fabrikam123.example/mail/Delete maxCount>42之/maxCount /f123:Delete 二/s:Body /s:Envelope 示例2:下面的例子刚述了使用soAP1.2消息头部块的响应消息 S:Bnvelope xmlns;S= "http://w.a.org/203y05/soapenmvelope" /adressing" //schemas.xmlsoap.org/ws/2004/08/ "http:/ xXxmlns;wsa= xmlns:f123="http://www.fabrikam123.example/svc53" S;Header wsaMessageID uuid:aaaabbbb-cccc-dddd-eeee-wwwwwwwwwww wsa:MeSsageI wsa:RelatesTo uuid:aaaabbbb-cccc-dddd-eeee-ffffffffffff wsa:RelatesTo wsa:;Tos;mustUnderstand="1" http://business456.example/client1 /wsa:To wsa:Action> //fabrikam123.example/mail/DeleteAck/wsa;Action> p
GB/I29798一2013 /SHeader S:Body f123:DeleteAck/> /8,Body /S.Bnvelope 5.2.3.3wSDL操作的关联行为 5.2.3.3.1显式关联 寻址定义了关联wSDL portType中带有输人输出和出错元素行为的两种机制:显示关联和默认 行为类型 行为可通过使用wa;Action元素而被显式关联 例如,下面的wSDL表达: definit1onstargetNamespace- "Ep7 exampIe.com/sEo8kauote portTypename="stockQuotePortType" operationname="GetLastTradePrice" inputmessage="tns:GetTradePricesInput" wsa:Action="http://example.com/GetQuote" outputmessage="tns:GetIradePricesOutput' wsaAction= "http://exanple.com/Q.ote" /operation /portType> definitions 对输人Getl.astTradePrice进行的操作由http;//example.com/GetQuote在StockQuotePortType 定义 输出的操作也由http://example.com/Quote定义 5.2.3.3.2默认行为模式 wsa:Action属性未出现的情况下以下类型被用来为输人和输出构建一个默认的操作 操作 在 URRI的一般格式如下 targetNamespace/portTypeName/inputNameloutputNname “/”是操作中使用的符号,属性值如下 targetNamespace是目的命名空间(/definition/@targetNamespace),如果目的命名空间以“/” 结尾,则不需要增加额外的“/”; portTypeName是端口类型的名称(/definition/portType/@name):; ameloutputName)是2.4.5条中定义的元素名 impunNa 对出错消息,这种类型不适用 相反,以下的URI是默认的操作URI: /fault http:/schemas.xmlsoap.org/ws2004/08/acdr ressing 例如,以下的wSDL片段: definitionstargetNamespace= "Etp:7 7/example.com/stoCkquote portTypename="StockQuotePortType"
GB/T29798一2013 operationname="GetLastradePrice" inputmessage="tns.GetTradePricesInput”name="GetQuote"厂 outputmessage="tns:GetTradePrices0utput”name="Quote"/> /operation> /portIype /definitions targetNamespace http://example.com/stockquote StockQuotePortType portTypeName inputName GetQuote outputName Quote 应用之前的类型如下 inputaction http://example.com/stockquote/StockQuotePortType/(GetQuote http://example.com/stockquote/StockQuotePortType/Quote outputaction 若属性名不存在,wSDL定义了默认输人和输出的名称 例如,如下的wSDL片段: defnitionstargetNamespace="http:7example.com/stockqote" portTypename="StockQuotePortType" operationname="GetLastTradePrice" "tns:GetTradePricesIr input" inputmessage= t outputmessage="tns:GetTradePricesOutput" /operation portIype /definitions targetNamespace http://example,com/stockquote StockQuotePortType portTypeName 按照wSDL2.4.5中定义的规则,若属性名不存在的话,默认值是请求操作附加的操作名 GetL.astTradePriceRequest inputName 默认的输出操作名是响应消息附加的: tTradePriceRe GetLast outputName Response 使用先前的模式产生如下的消息: inputaction http://example.com/stockquote/StockQuotePortType/GetLastTradePriceRe gueSt outputaction http://example.com/stockquote/StockQuotePortType/GetLastTradePriceRe- SpOnse 5.3寻址版本 5.3.1引言 除了5.2中使用的Addressing版本,也可选择使用ws-Addressingw3C的推荐版本 本条中,使用以下缩写: Addre wSMA是指5.2中的寻址管理(Management essing)的版本
GB/T29798一2013 wSA-Rec是指wS-Addressingw3C推荐的版本 5.3.2技术不同点 wSMA和wSA-Ree规范引用了不同的XML命名空间(见附录A) 发送web服务消息的端点 对于寻址SOAP头部应使用一个或另一个命名空间;接收的端点可能识别一个或者两个命名空间 5.4兼容性要求 5.4.1发现或协商 客户可以根据wSA来决定服务的能力,发现wSA版本比协商更有效 例如,如果一个服务支持 标识,那么客户可以事先确定服务支持的Addressing版本 因此,当wsA-Rec使用时,应支持标示 标识在以下场合将会使用: 客户发送给服务一个标识消息 如果服务不支持标识,客户可以认定服务只支持wsMA 如果服务成功处理了标识消息,客户通过查看AddressingVersionUR1元索检查寻址的版本 如果相应元素出现,就可以选择合适的版本 如果标识响应消息不能包含任何寻址版本,则客户无法知道寻址的版本,则应使用5.4.2中描 述的其中一个策略 在任何情况下,为了避免不必要的重新发现和重新协商,实现本标准的客户宜保留服务端能力 信息 5.4.2客户协商策略 可使用wSMA或wSA-Rec寻址版本 如果实现本标准的客户不知道服务的wSA版本能力,当 开始连接服务时,它可能会使用不同的策略 客户可以和wSA任意版本,使用wSA-Rec或wSMA 的请求消息开始交互信息 消息交互的过程如下所述 策略1:客户使用wSA-Rec发送请求 wSA-ReesOAP头部需要被mustUnderstand=1属 性标示,以此确保如果接受者不支持wSA-Ree的寻址版本会产生出错信息 客户可使用 wSMA重新进行操作 标识操作的响应应该包括寻址支持的所有版本 策略2;客户使用wSMA发送请求,服务使用wSMA响应请求 5.4.3初始化消息交换 初始发送的消息需要使用与消息发送中的端点引用相同的Addressing版本 例如,如果在SOAP 头部使用wSA-Rec的一个订阅请求消息(比如wsa:To和wsa;ReplyTo)NotifyToEPR中使用ws MA,则请求响应消息需使用wSA-Rece,但事件将使用wsMA发送 5.4.4规则 R5.4.4-1:如果实现本标准的服务支持wSA-Ree,则它应支持标识操作 R5.4.4-2;实现本标准的服务应支持wsMA,宜支持wsA-Ree R5.4.43;本标准的实现应使用与目的端端点引用相同的寻址版本向端点发送消息(见5.3) R5.4.4-4;在一个单独的sOAP消息中,本标准的实现应对所有寻址的sOAP头部使用相同的寻址 版本 因为本标准允许任何一种寻址方式的使用,RR5.4.44去除了WSAsOAP头部两种版本的混合使 用,但它允许出现不同寻址版本的端点引用 11
GB/T29798一2013 为了提供wSMA到wSA-Rec的迁移方式,特定消息模式允许使用任何一个版本的端点引用类 型 然而使用通用方式编写的模式本身(即使用xs:any)允许任意的XML出现,实现中应将这类元素 内容限制到一种端点引用的类型 因此,本标准推荐实现支持两种版本的寻址 5.5寻址使用 5.5.1端点引用的使用 寻址(或者寻址类型)创建端点引用(EPR)来传递web服务端点寻址信息 本标准定义了EPR中 可选使用的默认寻址模型 端点引用可作为单个资源实例的寻址模型 本标准也定义了一个默认的寻址模型 但如果系统本 身建立了完善的寻址模型或采用一个寻址服务器进行不透明的端点引用检索,只要这些面向服务的寻 址模型是基于本标准所支持的任何寻址版本都可以作为系统的寻址模型,可不必采用默认的寻址模型 R5.5.1-1;所有用端点引用对资源类或资源实例进行寻址的soAP消息都应遵循用端点引用(地址 和引用参数)寻址这种寻址规则 这个规则也同样适用于消息的后续操作如Pul或Release中,这些操 作也需要端点引用来把消息发送到正确的处理者 规则R5.5.1-1闹述了如Pul和Renew这样的操作也需要完整的端点引用 以Pu为例,即使 EnumerateResponse返回的上下文信息似乎消除了端点引用的必要性,但它依然需要端点引用来准确 寻址,Enumerate也一样 同样Renew操作也要求应用由subscriptionManager从SubscribeResponse 中获得端点引用 如果web服务在回应消息中包含一个端点引用,则它应接受后续消息中利用该端点引用寻址 客 户在用端点引用进行寻址之前不需要对端点引用进行处理 R5.5.1-2;服务返回的端点引用应可用于对该服务的被管资源寻址 R5,.5.13;任何由服务返回的端点引用,不管是默认的寻址模型或其他寻址模型,只要被管资源还 存在就应保证端点引用的有效性 5.5.2默认寻址模型 5.5.2.1概述 本标准为资源定义了一个默认寻址模型,服务并不一定要使用该寻址模型,但该寻址模型适合于大 多数的实现,并可增加服务和客户之间互操作的成功概率 本标准后续部分的例子中经常使用这个默认寻址模型,且包含组件ResourceURI和SelectorSet消 息头 本标准独立于实际的数据模型,并未对特定资源定义ResoueeURI结构或设定选择器的值,这些 可由厂商自行设定或参考其他规范 本标准描述和使用该默认模型并不代表符合本标准的服务应要支持该寻址模型 5.5.2中所有例子和一致性规则都假定服务是基于该默认寻址模型实现的 对于不使用该默认寻 址模型的服务,这些规则并不适用 默认寻址模型中使用端点引用来寻址,下面是端点引用中一组sSOAP头信息 To必备元素);服务的传输地址; wsa: kesourceURI(当使用默认寻址模型时是必备元素;资源类或实例的URI表示; wsman wsmanSelectorSet可选元素;当一个资源类存在多个实例的时候,用于鉴别或选择特定的 实例 Res 使用默认寻址模型时,wsman:l tourceURI的s;mus stUnderstand属性应标记为“ture” 否则一 个未实现默认寻址模型的服务可能会返回一个并不是客户请求的资源给客户 下面是为端点引用定义的默认寻址模型的XML描述 12
GB/I29798一2013 wsaBaponERereence wsa:Address Networkaddress wsa;Address wsaReferenceParameters wsman:ResourceURI resourceURI/wsman:ResourceURI> wsman:SelectorSet wsmanSelectorName="selector-name" Selector-value wSman:SelectOr wsmanSelectorSet /wsa:ReferenceParameters /wsa:BndpointReference' 下面的描述对上述内容进行补充和限制 wsa:Address: 服务的传输地址 wsa;ReferenceParameters/wsman:ResourceURI 寻址的资源类或实例的URI URI既可能代表资源类,也可能表示资源实例 这个URI和wsa;ToURI的结合实现了对资源类 或实例的寻址 wsa:ReferenceParameters/wsman:SelectorSet: 如5.5.2.2中所述,这是一个可选的操作 在ResourceUR1存在多实例的情况下,这个值用来选定特定实例 上述格式适用于在元数据中定义地址,或在消息体中返回指定地址,如NotifyTo,wsa;ReplyTo和 wsa:FaultTo操作 当soAP消息中使用了默认寻址模型时,寻址规范指定了这种转化的发生 下面是一个端点引用定义的例子 Wsa:EndpointReference wsa;AddressAddress /wsa:Address wSa;ReferenceParametersXImlns;wsman= Reso1rceURT resURT 1SI 'wsman:ResourceURI> wsman:SelectorSet wsman:SelectorName="Selector-name" Selector-alue wsman:Selector wsman:SelectorSet /wsaReferenceParameters //wsa:EndpointReference 在sOAP消息中可使用如下的寻址模型 wsa;Address变成了wsa;To,引用属性和引用参数被 解包 以下是使用寻址的sOAP消息例子 s:Envelope s;Header wsa:;ToAddress //wsa:To AetionUR wsa;Action /wsa;Action 13
GB/T29798一2013 wsman:ResourceURImustUnderstand="true"resURI/wsman;ResourceURI wsman:SelectorSet wsman:SelectorName="Selector-name" Selector-value wsman:Selector wsman:SelstorSet> /s:Header s:Body> //s:Body /s:Envelope 以下是一个使用wsRec寻址的soAP消息例子 s:Bnvelopexmlns:wsa="http://www.w3.org/2005/08/addressing s;Header wsa:TomustUnderstand="true" Address /wsa;To wsa:ActionmustUnderstand="true" ActionURI/wsa:Action wsman:ResourceURImustUnderstand true 'true" wsa:isReferenceParameter resUR wsman:ResourceURI wsman:SelectorSetwsa:isReferenceParameter="true" wsman:SelectorName="Selector-name Selector-value wsman:Selector /wsman:SelectorSet /s:Header s;Body /s;Body sEnvelope 在这两个例子中,wsa;:To,wsman;ResourceURI和wsman: nseletasu这些元索一起用于对被管 资源实例的寻址,但对资源的操作或方法是由wsa:Action信息头指定的 下面例子是基于默认寻址模型的实际应用中消息的Addressing信息头 s;Bnvelope xmlns;s="http://www.M3.org/2003/05/soap-envelope" xmlns:wsa="http://schemas.xmlsoap.org/ws/2004/0476/08/addressing" //schemas.dmtf、 /wbem/wsman/1/wsman.xsd"> Xmlns;wSman= "http:/ org/ sHeader wsa:To>http://123.99.222..36/wsman/wsa:Io wsman:ResourceURmustUnderstand="true" http: example.org/hardware/2005/02/storage/physDisk wsman;ResourceURI wSmanSelectorSet wsman:selectorName="LU">2之/wsan:Selector>485 wsman:SelectorSet wsa;Action ws/2004/09/transfer/Get httP:/7/schemas.xmlsoap.org/ /wsa;Action 14
GB/I29798一2013 eIDurn:uu489id:d9726315-bc91-430b-9ed8-ce5ffb858a91 wsa;Messagel /wsa:MessageID /s;Header> s;Body /s;Body一 /s:Envelope 下面的描述对上述内容进行补充和限制 wsa:To 服务的网络(或传输层)地址 wsman:ResourceURI 特定资源类或资源实例的ResourceURI. Seletors Set wsman:S 个选择器包 wsmanSeleetorSet/wsman;Seleetor 如果一个资源类中存在多个实例,选择特定的资源实例 在这个例子中,选择器是“LUM”,被选择资源是单元编号为“2”的设备 wsa:Action 标识对选定的资源进行什么样的操作(这个例子中是“Get操作”) wsa:MessagelD 为了跟踪和相关性,唯一标识这个消息 在本标准的例子中经常便用RrC122中定义的格式,但这并不是应使用的格式 5.5.2.2RerourceURl RersourceURI用来指定资源类或资源实例 R5.5.2.2-1;wsman;ResourceURI的格式并没有强制要求符合RFC3986规定 ResourceURI的语法和格式只要是符合RFC3986要求的URI 虽然没有默认的格式名,但默认 通常使用http;或urn: 若使用http:,用户可能希望在这个地址上找到基于网络的这个资源文件 wsman:ResourceURI和wsa;To两个元素共同定义了实际资源 R5.5.2.2-2;面向厂商或者面向组织的UI宜把因特网的域名放在格式名后的第一个次序,如下面 例子URI中的“example.org” 示例: s:Header wsa;To>http://123.15.166.67/wsmanGB/T29798一2013 ws/2004/09/transfer/Delete http:/7schemas.xmlsoap.org htt ttp://schemas.xmlsoap.org/ws/2004/09/enumeration/Enumerate schemas,xmlsoap.org/ws/2004/09/enumeration/Pul http; schemas.xmlsoap.org/ws/2004/09/enumeration/Renew http; schemas.xmlsoap.org S /2004/09/enumeration/GetStatus 2004 schemas.xmlsoap.org/ enumeration/Release schemas http XSOAtO eventing/Subseribe 下面的消息要求返回 消息中包含端点引用的subscriptionManager元素,端点 SpOnse 包括ResoueceURI 引用的格式由服务决定,可能包括也 http://schemas.xmlsoa 08/eventing/Renew ls0ap.Org http;//schemas.xmlsoap.org/ws/2004/08/eventing/GetStatus 当使用默认寻址模型的时候,如果ResourceUR1soAP头信息是必需的,它可能会用一种简单的 形式,例如,http;//example.com 或http://example.com/resource R5.5.2.2-4:当请求消息中有自定义操作时,为了把消息发送到正确的句柄,ResoureeURI信息头可 以会出现在消息中 R5.5.2.2-5:RResourceURI元素不宜出现在如响应或者事件消息中,除非关联的端点引用在Refer enceParamete ers中包含Re rceURI元素 esour 在实际应用中,只有请求引用到特定资源类的消息中 wSman ResourceUR1元素才是必须的 响 应并不定位到管理资源,所以 wsman;ResourceURI对于响应并没有实际意义 R5.5,.2.2-6;在使用默认寻址模型时,若wsman;ResourceUI丢失了或者用了出错消息的格式,服 务应该返回如下的wsa;DestinationUnreachable出错消息 http://schemas.dmtl.org/wbem/wsman/1/wsman/faultDetail/InvalidResoureeURI R5.5.2.2-7 7;wsman:ResourceeURI元素应只用来标识一个资源,不可用来标识资源的操作,资源的 操作应该用wsa: UR来表示 Action wsa:Action 自定义的基于WSDL的方法有从寻址角度考虑的ResourceURI和从执行角度考虑的w URI两个方面 在很多案例中,ResourceUR1只是简单的wsDL标识名和端口号, ,wsa;ActionURI是 在端口或接口定义中的特定方法 尽管理论上单独一个URI可以定义多实例资源中的单个实例,但推荐使用wsa:To元素来定位服 务,用wsman;ResourceURI元素来识别资源类,用wsman:SeleetorSet来引用资源实例 如果资源只 有单个实例,用wsman;Resoureel cURRI就可以引用单个实例 这个用法并不是必须要求的,只是一个指导建议 即使对于同一个资源类,服务也可以为任何给定 的操作使用完全不同的选择器,并可以允许或要求En numerate需要选择器 可以参照7.2中关于寻址一致性的建议 自定义操作有两个唯一标识;用来标识wsDL及端口(或接口)的wsman,ResourceURI,和用来表 示特定方法的wsa;ActionUR1 如果一个接口中只存在一个方法,那么从某种意义上来说wsman ResourceUR1和wsa;AetionUR1就是相同的 用wa;AetionURI来表示一个自定义方法的ResourceUR1并没有错,但为了客户和服务操作处 理的符合性,我们要求消息中应有wsman ;ResourceUR和wsa:AetionURI元素 示例1;下面是一个重设网卡操作的端点引用例子 http:/example.org l6
GB/I29798一2013 /wsman:ResourceUR> wsa:Action http://example.org/2005/02/networkcards/reset /wsa;Action /s:Header 很多时候,ResourceURI就是wsDL名称和端口,wsa:ActionURI包含一个附加的标识作为后 缀,如下例所示 示例2" s:Header wsa;To> http;//1.2.3.4/wsman /wsa:To. wsman:ResourceURT http://example org/2005/02/networkcards wSman lResourceURI wsa:Action一 http://example.org/2005/02/networkcards/reset /wsa;Action /s:Header 个例子,ResourceURI可能与wsa:ActionUR1完全没有联系,如下 最后 示例3 s;Header wsa;To>http://1.2.3.4/wsmanGB/T29798一2013 在一些信息领域,选择器引用的值就是资源的关键字,而在另一些领域,选择器就是物理或逻辑目 录系统的一部分,或是搜索空间的一部分 在这些案例中,选择器用来表示资源,但并不是资源描述的 -部分 R5.5.2.3-1:如果资源有多个实例,在使用默认模型时,wsman:s :SelectorSet元素可用来标识特定的 资源实例 为了精确得到标识资源类的特定实例,wsman:Selecton Set 元素中可出现任何个数的 Selector值 根据特定的实现环境,服务可以区分选择器的名称和值的大小写(参见13.6). wsman: 如果客户需要知道选择器大小写的策略,服务可以提供元数据文档来描述这个策略 元数据的格 式已经超出了本标准范围 R5.,5.,2.3-2;在与ResourceURI相关的范围内,SelectorSet元素中的所有内容均被认为是单引用 参数 R5.5.2.3-3;使用默认寻址模型的服务应该检查消息中所有的选择器,并用逻辑AND方式来对他 们进行处理 如果出现选择器对目标资源实例的出错消息操作,服务宜返回一个wsman;InvalidSelec tors出错消息给客户,具体格式如下 如果选择器丢失 http://schemas.dmtf.org/wbem/wsman/1/wsman/faultDetail/InsufficientSeleetors 如果选择器的值是一个出错消息的类型: chemas.dmtl.org/wbem/wsman/1/wsman/faultDetail/TypeMismateh http 如果选择器的值是一个正确的XML类型,但超出了本标准定义的范围 tf.org/wbem/wsman/1/wsman/faultDetail/InvalidValue schemas.dmt 如果不是一个合法的选择器名称 http://schemas.dmtf.org/wbem/wsman/1/wsman/faultDetail/UnexpeetedSeleetors R5.5.2.3-4:在嵌套的同一层中,选择器的名称属性值不应出现重复 若重复,服务宜返回一个 ws- man:InvalidSeleetors出错消息,具体格式如下: http://schemas.dmtf.org/wbem/wsman/1/wsman/faulDetail/DuplicateSeleetors 本标准没有强制必须使用选择器 在一些实现中可能存在使用复杂的UR1,这些ResourceUR1本 身就唯一标识了实例 SelectorSet元素的格式如下 s:Envelope alns:8=http://www.w3.org/2003/05/soapenvelope" //schemas.xmlsoap.org/ws/2004/08/addressing” Xmlnswsa= htp:/ xmlns:wsman="http://schemas.dntf.org/xbem/wsman/1/wsman.xsd"> s;Header wsa:To servicetransportaddress/wsa;To一" wsman:ResourceURI ResourceURT wsman;ResourceURI wsman:SelectorSet wsman:SelectorName="name" value/wsman:Selector一 wsman:SelectorSet s;Header s;Body /s:Body一 /s:Envelope 下面的描述对上述内容进行补充和限制 18
GB/T29798一2013 To wsa: 网络地址 ceUR wsman:Resource 用于指定资源类 wsman:SelectorSet 选择器元素集合 wsman;SeleetorSet/wsman;Seleetor 用于描述选择器和它的值 若需要多个选择器,一个Seleetor元素就是整个选择器的一部分 该元素的值就是Seleetor的值 wsman:SelectorSet/wsrman:Selector/@Name 选择器的名称(区分大小写 选择器的值可以是嵌套的端点引用 下面的例子中,标签的选择器是SelectorSet的一部分,这个选 择器包含一个嵌套自己的Address,ResourceURI、和SelectorSet元素的端点引用 s:Envelope xmlns:s= http://ww.3.org'2003/05/sop-emeiope" //schemas.xmlsoap.org/ws/2004/08/addres xmlnswsa http:" ssing //schemas.dat.orsg/sbem/wsman/1/wsman.xsd"" xmlns:wsman="http: s;Header wsman;SelectorSet wsman:SelectorName="Primary" 123 /wsman:Selector "EPR" Name wsa:EndpointReference address wsa:Address AddresS enceParameters ResourceURI resourceURI torSe WCmT Name="name"一>valueGB/T29798一2013 R5.5.2.3-6如果wsa:Address 的值和wsa:To的值不一致或者不是http://schemas.xmlsoap.org/ ws/2004/08/addressing/role/anonymous时,遵循本标准的服务可能会拒绝一个选择器或嵌套端点引 用的嵌套选择器 嵌套机制的初始目的是为了一个资源能够响应其他资源的信息 R5.5.2.3-7;当一个选择器名称超过2048个字符时,服务可能会处理失败 R5.5.2.3-8当一个选择器值(包括嵌人的选择器)超过4096个字符的时候,服务可能会处理失败 根部的SeletorSet元素内容如果超过8096个字条的时候,可能会消息处理失败 R5.5.2.3-9:当选择器标识资源实例主键时,这类主键不宜被修改,或可由服务端提供其他措施来防 止用户随意修改以避免发生异常(见附录B) 5.5.2.4默认寻址模型的出错消息 当基于默认模式的出错消息产生时,经常包括特定的出错消息代码 这些具体的代码可查看14.G 在使用面向服务的寻址模型的时候,这些出错消息并不适用 5.5.3服务特定寻址模型 尽管本标准指定了默认的寻址模型,但在某些情况下,这些模型不可用或不适合 R5.5.3-1.符合本标准的服务可能不能正确解析默认寻址模型中的信息头 客户可设置wsman: ResourceUR1为mustUnderstand="true",则当无法正确解析时服务应返回s;NotUnderstood出错 消息 R5.5.3-2:符合本标准的服务也可使用本标准范围之外的信息头 服务可使用可供选择的寻址模型来进行资源引用 这些寻址模型可能使用或可能不使用Re sourceURI或SelectorSet元素,只要它们符合寻址规则,是合法的寻址模型即可 除了定义可选择的寻址模型,服务可能根本不定义任何寻址模型而是使用运行时产生的可根据寻 址标准规则处理的透明EPR 当使用这些寻址模型时,客户应用程序应理解并用发现机制去获得端点引用,这些超出了本标准的 描述范围 5.5.4必须遵守的属性 本条描述了不论实现是使用本标准定义的寻址(见5.3.2)还是使用w3C推荐版的wS-Addressing 寻址,均可使用mustUnderstand属性 在本标准中,SOAP信息头部的mustUnderstand属性被解释为应遵守 例如,如果一个SOAP信 息头在本标准中是可选择的,但使用了mustUnderstand=“true”属性,服务应遵守或返回一个出错消 息 为了保证服务视某头信息为可选择的,mustUnderstand属性可被忽略 如果wsa:AetionURI不被理解,实现将不知道如何去处理这个消息 所以,下列元素在实际应用 中,包不包含mustUnderstand= "ru"属性没有实际影响因为musUnderstand已经隐含实现 To wsa: wsa;MessagelID wsa:RelatesTo wsa:Action wsa ;ReplyTo wsa;FaultTo R5.5.4-1:符合本标准的服务,在处理上述这些操作时,无论是否使用mustUnderstand=“true”属 性,效果应都一样 20
GB/T29798一2013 因此,客户在上述这些元素中忽略 mustUnderstand=“true”属性对操作的实际意义没有影响 R5.5.4-2;如果服务不能理解一个标有mustUnderstand=“true”属性的信息头,服务应返回一个 5: NotUnderstood出错消息 服务的目标是当请求不希望被曲解时,容忍不一致的mustUndersta nd使用 在实现默认寻址模型时,为了确保服务符合默认寻址模型,客户在 wstman;ResoureeURI元素中使 用mustUnderstand=“true”是非常重要的 使用服务自定义寻址模型的实现可能忽略这些和客户意 一致的信息头值和行为 图不 5.5.5头信息wsa;To 本条描述了在本标准定义的寻址(见5.4.2)和w3C推荐版的ws-Addressing寻址中的wsa;T头 信息使用方法 在请求消息中,wsa;To地址包含服务的网络地址 某些时候,该地址已经足够用来定位资源的地 址 而在其他情况下,服务只是多个资源的分派代理,在这种情况下,端点引用需包含例如引用元素等 附加信息来标识特定资源 例如,在使用默认寻址模型时,需附加ResoureeUR1和eleetorSet元素 本标准并不排除在同一个物理系统中多个监听服务并存的情况 (这些服务将使用发现机制来区 分这些服务,这已经超出了本标准的描述范围 R5.5.5-l:无论请求,回应或事件,所有的消息中均应包含wsa:To信息头 在没有特殊要求的情况 下 ,建议需要鉴别的服务在资源网络地址中使用/wsman后缀 如果使用了/wsman,宜不允许没有鉴 别的访问 /123.15.166.67/wsman wsaTo /wsa:To hP R5.5.5-2;在没有其他要求的情况下,建议不需要鉴别的服务在资源的网络地址中使用/ wSman- anon 后缀 如果使用了/wsman-anon,将不需要鉴别的访问 wsa:To>http://123.15.166.67/wsman-anon/wsa:To> 如果服务只提供了一组资源,只需要wsa;To信息头即可寻址 soAP消息中包含传输层地址也许是多余的,因为网络链接早已被客户端创建好 然而,当消息是 经过中间媒介路由器的时候,就必须要传输层地址,这样中间媒介就可以和正确的端点建立链接 为了定位服务和服务中的一组资源,wsa;To头信息可以包含任何个数的标识 所有后续消息,例如,Pul和Release(都为Enumerate的后续操作),都包含端点引用 事实上,这 些消息中包含前面消息中的上下文信息,其与sOAP消息和寻址模型无关 R5.5.5-3;如果对资源的寻址发生如下出错消息时,服务宜发布出错消息 如果资源死机,返回 wsa:EndpointUnavailable出错消息;http://schemas.dmtf.org" wbem/wsman/1/wsman/faultDetail/Resource(Offline 如果不能找到资源,返回 wsa;:DestinationUnreachable出错消息 如果资源有效,但内部发生出错消息,返回 wsman:lnternalError出错消息 如果资源由于安全原因不能被访问,返回一个wsman:AccessDenied出错消息 5.5.6其他寻址头信息 5.5.6.1处理寻址头信息 在本标准信息中,有如下与寻址相关的头信息模块 R5.5.6.1-1;符合本标准的服务应能识别和处理以下Addressing信息头模块 在Addressing中定 义的其他信息头都是可选的,但是一个符合本标准的服务可能会拒绝任何附加的信息头,并发送 NotUnderstood出错信息头来表示处理失败 s:N 21
GB/T29798一2013 wsa:To ReplyTo(若需要回复时,是必需的 wSa wS8 a;FaultTo可选 ssgedD(必需的) wsa:Mes wsa:Action(必需的 a;RelatesTo(在响应中是必需的) Wsa 这些头信息模块的使用将在下面章条中进行讨论 5.5.6.2wsa;ReplyIo 本标准寻址对wsa:ReplyTo用法要求如下 R5.5.6.2-1;若需要响应时,请求消息中应有wsa;ReplyTo信息头 这个地址可以是被服务支持的 //schemas.xmlsoap.org/ws/2004/08/addressing/rolel 用来建立新链接的有效地址,也可以是http:/ anonymousURI,后者表明响应是通过请求链接来传递的 如果wsa: ReplyTo信息头丢失了,应该返 回 wsa;MessageInformationHeaderRequired出错消息 如事件传递或we:sadbcriptionEad等这些消息,不需要响应,可以忽略wsa.RepyTo元素 R5,.5.6.2-2:一个符合本标准的服务可以要求所有的响应通过请求到达的链接传递 这个时候,应 该用R5.4.6-2中讨论的UR1来指明 否则,服务应该返回wsman:UnsupportedFeature出错消息,具 体代码如下 http://schermas.dmtf.org/wberm/wsman/1/wsman/faultDetail/AddressingMode R5.,5.6.2-3;若传递的事件需要确认,事件发送者应包含wsa;ReplyTo元素,可参照10.8中的使用 方法 寻址规范允许客户在wsa;ReplyTo头信息中自定义引用参数 寻址规范要求从请求中把这些引 用参数提取出来,把ReferenceParameters 包去掉,把所有值作为顶层的头信息放在响应中,如5.2所 述 这样可以允许客户更好得把响应与请求消息联系起来,这个步骤不能被省略 在下面的例子中,xsomeHeader信息头被包含在响应消息中 s:Bnvelope xmlns:s "htt tp://www.w83.org/2003/05/soap-envelope" xmlnswsa "http://schemas.xmlsoap.org/ws:/2004/08/ /addressing xmlns:wsman "http://schemas.dmtf.org/wbem/wsman/1/wsman.xsd”" SHeader wsa:To>http://1.2.3.4/wsman wsa:ReplyIo wsa:Address http://schemas.xmlsoap.org/ws/2004/08/adressing/role/anonymous /wsa:Address wsaReferenceParameters x:someHeaderxmlns;:x= user-definedcontent/x:someHeader一 wsa:ReferenceParameters ;ReplyTo /wsa /s:Header s;Body心 /s;Body sEnvelope R5.5.6.2-4;如果 wsa;ReplyTo地址不可用或丢失,服务不宜响应请求,且应根据当前网络传输的 心

中文新闻信息分类与代码
上一篇 本文分享国家标准中文新闻信息分类与代码的全文阅读和高清PDF的下载,中文新闻信息分类与代码的编号:GB/T20093-2013。中文新闻信息分类与代码共有670页,发布于2014-05-01
信息技术学习、教育和培训学习管理系统规范
本文分享国家标准信息技术学习、教育和培训学习管理系统规范的全文阅读和高清PDF的下载,信息技术学习、教育和培训学习管理系统规范的编号:GB/T29801-2013。信息技术学习、教育和培训学习管理系统规范共有84页,发布于2014-05-01 下一篇
相关推荐