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生成数据文件里忽略。

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

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