zoukankan      html  css  js  c++  java
  • php学习之道:WSDL具体解释(一)

    WSDL文档使用web服务描写叙述语言来定义服务。

    文档包含逻辑(抽象)部分和详细部分。

    抽象部分用于定义独立于实现的数据类型和消息,详细部分定义一个endpoint怎样实现一个能够与外界进行交互的服务。

    通常建议在写代码前定义WSDL文档和XML schema,可是这就要求对WSDL很熟悉。

    逻辑部分:

    包含types,message以及portType元素。types元素中。xml schema用来定义组成消息的数据的结构。一定数量的消息元素用来定义服务所用消息的格式。portType元素包含一个或多个operation元素,用来定义被operation发送的消息。

    详细部分:

    包含binding和service元素。binding元素描写叙述message元素描写叙述的那些数据单元怎样映射到一个详细的数据格式。Service元素包含一个或多个port元素,这些port元素用于定义endpoint。

    整体上来说,一个WSDL文档有下面元素组成:

    • definitions--WSDL文档的根元素,该元素的属性指明了wsdl文档的名称。文档的目标名字空间,以及WSDL文档应用的名字空间的速记定义。
    • types--数据单元的xml样式定义。形成了服务所用消息的构建块。
    • portType---描写叙述服务逻辑接口的operation元素的集合。

    • operation--一个服务包括的操作的描写叙述,当操作被调用时。操作被定义为两个endpoint之间的消息传递。
    • binding---一个endpoint的实际数据格式说明,一个binding元素定义怎样将一个抽象消息映射到一个详细数据格式。该元素指明诸如參数顺序。返回值等信息。
    • service---相关port元素的集合,这些元素被库藏,用户组织endpoint定义。
    • port--通过binding和物理地址定义的endpoint。这个元素将全部抽象定义聚集在一起。

    设计一个WSDL的步骤:

    1.定义服务用到的data types

    2.定义服务用到的消息

    3.定义服务接口

    4.定义消息与接口之间的bindings和线上数据的详细呈现方式

    5.定义每一个服务的传输细节。

    以下依据每步展开论述:

    1.定义逻辑数据单元

       定义一个服务时,第一件事情。你必须考虑的是作为暴露到外部的參数所用到的数据,将如何呈现。

    与那些是选用固定数据结构编码的程序不同,服务必须定义出他们的数据以逻辑单元的形式。这包含两步:

      1.1将数据拆分成逻辑单元,这些单元能被映射为数据类型,并被服务的物理实现所引用。

           假设你定义了一个服务接口,而且该接口已经实现,你必须将实现操作的数据类型转换成xml元素,用于组装成消息。假设你从头開始,你必须定义你的消息构建时用到的构建块,这种话。他们从实施角度看才有意义。

          注1:定义服务数据单元可用的类型体系:依据WSDL规范,你能够使用不论什么类型体系。

    然而在W3C规范中定义的XML schema是首选的规范的类型体系。

    因此,XML架构在Apache CXF的内在类型系统。

         注2:xml schema:xml schema被用来定义一个xml文档怎样构建,用于定义一个文档由哪些元素组成。这些元素能够使用xml schema类型,比方xsd:int的或者他能够使用用户定义的类型,用户定义类型也是使用xml元素的组合来构建的饿。或者他们是用严格的已存在类型构建。通过结合类型定义和元素定义。你能够创建复杂的XML文档能够包括复杂的数据。当定义服务使用的数据单元时。你能够定义他们作为类型,这些类型指明消息组成部分的结构,你也能够定义你的消息单元作为组成消息结构的元素。

        注3:生成数据单元的考虑:你能够考虑简单地生成逻辑数据单元,这些单元直接映射你在服务中使用的数据类型。当以这个方式工作时,必须紧密遵循构建RPC类型应用程序的构建模型,这不是构建面向服务架构程序必须的策略。webservice组织提供了一定数量的手冊来定义数据单元,另外W3C也提供了下main的手冊来教你怎样使用xml schema展现数据类型。

      1.2将数据单元(data units)加入到文档

           依赖于你怎样选择去生成WSDL文档,生成新的数据定义要求有大量的知识,CXF GUI工具提供一定数量的帮助来描写叙述数据类型。其它的xml编辑器提供不同级别的帮助。

    不论你选择哪种编辑器,拥有一些与文档相关的知识是非常重要的。

           定义WSDL中用到的数据,需下面步骤:

           a.确定接口要用到的全部数据单元

           b.在文档中生成一个types元素。

           c.创建一个schema元素,作为types元素的子元素

           d.complex类型是元素的集合,使用complexType元素来定义数据类型

           e.对于每一个数组来说,定义他的数据类型也使用complexType元素

           f.对于每一个复杂类型来说,都能够从简单类型衍生出来,定义数据局类型能够通过simpleType元素。

           g.对于每一个枚举类型。定义数据类型使用simpleType元素。

           h.对于每一个元素来说。定义他们使用element元素。

    1.3 xml Schema simple types:

           假设一个消息组件是简单类型的话,那么就不须要给他定义一个类型。接口使用的复杂类型也是通过简单类型定义的。

          注1:输入简单类型:xml简单类型是基本的放置元素,在element元素中。简单类型也被使用在restriction元素和extension元素的base属性中。

    简单类型总是使用xsd作为前缀,比如,为了指明类型int,你将输入xsd:int在type属性中。

    <element name="simpleInt" type="xsd:int" />

        CXF支持下列xml schema简单类型:xsd:string,xsd:normalizedString,xsd:int,xsd:base64Binary等。

    1.4定义复杂数据类型:

         xml schema提供灵活和强大的机制来构建负责数据结构。你能够创建数据结构通过创建一个元素和属性的序列。

    你看能够扩展已有类型来创建更复杂的类型。

        另外,为了构建复杂数据结构,你能够描写叙述特定的类型,诸如:枚举类型。数据类型中的数据有一个特定的取值范围,或者数据类型的数值必须遵循某种特定的模式。通过扩展或者限制原始类型。

    1.5定义数据结构:

        在xml schema中,数据单元是数据域的集合。这些数据域是通过负责类型元素定义的。指明一个复杂的类型须要三块信息:

        a.复杂元素的名称须要被指定。

        b.复杂类型的第一个子元素用来描写叙述该结构的域的行为,当他被放入线上时。

        c.每一个结构中的域,都被用element元素定义。

        以下的雷子是一个复杂类型有两个子元素:

                  结构例如以下:

    struct personalInfo
    { string name;
    int age;
    };

                  相应的WSDL文档:

    <complexType name="personalInfo">
    <sequence>
    name="name" type="xsd:string" /> <element
    <element name="age" type="xsd:int" /> </sequence>
    </complexType>

    注1:复杂类型的种类:

          xml schema有三种方式描写叙述当xml文档被展现并通过线上展示时。当中的域怎样被组织。第一个子元素确定哪种复杂类型被引用。以下展示了用来定义复杂类型行为的三种方式:

    • sequence:全部的复杂类型域必须被显示,而且他们必须有一个确定的次序,该次序与类型定义的次序同样。

    • all:全部的复杂类型域都须要有。可是次序无所谓
    • choice:不过元素中一个能够出如今消息中。

    注2:定义结构的部分:

          你定义数据域。这些数据域是由一个结构体组成。

    每一个复杂类型元素应该包含至少一个element元素。每一个element元素相应已经定义的数据结构中的一个域。

         为了充分描写叙述数据结构中的域,element必须有两个属性:

        name属性:指明数据域的名称而且是唯一的

        type属性:指明该域存储的数据的类型。能够是简单类型也能够是复杂类型。

      除此而外还有两个重要属性:minOccurs和maxOccurs。这个属性用来设置该域在结构中发生的次数上下限。缺省情况下每一个字段值发生一次。使用这些属性,你能够改变结构体中一个域发生的次数。以下的样例中。previousJobs最少发生一次,最多7次。

    <complexType name="personalInfo>
    <all>
    ment name="name" type="xsd:string"/> <el
    <el eement name="age" type="xsd:int"/>
    pe="xsd:string: minOccurs="3" maxOccu
    <element name="previousJobs" t yrs="7"/> </all>
    </complexType>

    注3:定义属性:在xml文档中,属性被包括在element内部的。比如在complexType元素中name就是属性,它通常跟在<sequence>,<all>等元素的后面。比如:
     

    <complexType name="personalInfo>
    <all>
    ment name="name" type="xsd:string"/> <el
    <el eement name="previousJobs" type="xsd:string"
    </all> <attribute name="age" type="xsd:i
    minOccurs="3" maxOccurs="7"/> nt" use="optional" />
    </complexType>

    1.6定义数组
     

       CXF支持两种方式来定义数组。第一种是定义一个复杂类型,採用简单元素。他的最大发生属性是个大于1的值,另外一种方式是使用SOAP数组,SOAP数组提供添加的功能。比方ability来简化定义多为数组而且发送分离后的数组。

      复合类型数组:复合类型数组是特殊的sequence复合类型。你能够简单定义一个复合类型通过简单元素,而且制定该元素的最大发生maxOccurs属性。

    比如,定义一个数组。拥有二个浮点数字,你能够使用复合类型例如以下:

    <complexType name="personalInfo>
    <element name="averages" type="xsd:float" maxOccurs="20"/>
    </complexType>

    你也能够定义一个最小发生属性。

     

    SOAP数组:SOAP数组定义通过SOAP-ENC:Array,该类型基于wsdl:arrayType元素。

    <complexType name="TypeName">
    <complexContent>
    <restriction base="SOAP-ENC:Array">
    <attribute ref="SOAP-ENC:arrayType"
    wsdl:arrayType="ElementType<ArrayBounds>"/>
    </restriction>
    </complexContent>
    </complexType>

    上述语法中。typename指定新定义的数组名,ElementType指定数组中元素的数据类型。ArrayBounds指定数组的维度及元素数量,单位数组通过[],多维通过[][]。

     

    <complexType name="SOAPStrings">
    <complexContent>
    se="SOAP-ENC:Array"> <attribute r
    <restriction b aef="SOAP-ENC:arrayType"
    ayType="xsd:string[]"/> </restriction> </c
    wsdl:ar romplexContent>
    </complexType>

    1.7通过extension定义类型

       类似基本的编码语言,xml schema同意你创建数据类型。这些数据类型集成已有的数据类型,这样的机制被称之为:extension。比如你能够创建一个新类型名叫alienInfo,它集成了PersonalInfo结构,通过郑家了新的元素planet。

      extension的类型定义包含四个部分:

     a.通过name属性来定义类型名

     b.通过complexContent元素来指定新类型将拥有多余一个的元素。

     c.被继承的那个类。被称之为base类型,通过base属性来指定。

     d.新类型和属性被定义在extension元素中。

    样例例如以下:

    <complexType name="alienInfo">
    <complexContent>
    ="personalInfo"> <sequence>
    <extension bas e <element name="planet" type="xsd:string"/>
    nt> </complexType
    </sequence> </extension> </complexCont
    e>

    1.8通过restriction来定义类型

    简单样例

    <simpleType name="SSN">
    <restriction base="xsd:string">
    <pattern value="d{3}-d{2}-d{4}"/>
    </restriction>
    </simpleType>

    1.9定义枚举类型:

    <simpleType name="widgetSize">
    <restriction base="xsd:string">
    <enumeration value="big"/>
    > <enumeration value="mungo"
    <enumeration value="large" //> </restriction>
    </simpleType>

    2定义元素:

    在xml schema中的元素体现为一个元素的实例。

    大多数最主要的元素有简单元素组成。像element元素,他是由一定数量的复杂类型定义的。它有三个属性:

    • 名称:一个须要的属性来指明元素的名字
    • type:指明元素的类型。这个类型能够是不论什么xml schema的原类型或者不论什么已经命名的复合类型。

      这个属性属性能够被省略,假设类型已经内置定义。

    • nillable:指定是否元素能够从一个文档中忽略,假设是ture。则元素能够被不论什么依据该SCHEMA生成数据文件里忽略。

    一个元素能够有一个内置类型定义,内置类型被指明,通过复合类型元素或者简单类型元素。

    一旦你说明了是否数据类型是复合或者简单,你能够定义不论什么你须要的数据类型。内置类型定义建议不被使用。由于他不支持重用。

  • 相关阅读:
    多种开源OLAP引擎测评报告
    Go的单元测试
    C#的List实现IComparer接口排序实例
    Java 多线程:(一)
    android:theme
    android:excludeFromRecents="true"
    RK:主屏幕
    Gatsby xinhua log boork(三)
    RK:Provision.apk、SettingsProvider的分析、使用
    Camera(一):查看Camera设备详细信息
  • 原文地址:https://www.cnblogs.com/yfceshi/p/7095342.html
Copyright © 2011-2022 走看看