xml/schema/wsdl

ゝ一世哀愁。 2022-06-12 05:21 160阅读 0赞

xml/schema

在看webservice时，牵扯到很多xml的知识，看的一片头疼，不得不硬着头皮系统看了一遍这方面的知识，作为学习笔记记录下自己易混淆的地方……

XML可扩展标记语言（EXtensible Markup Language）,是 W3C 的推荐标准,设计宗旨是传输数据和存储数据，而非显示数据。XML 是各种应用程序之间进行数据传输的最常用的工具，并且在信息存储和描述领域变得越来越流行。

HTML 被设计用来显示数据。

头部：

<?xml version="1.0" encoding="utf-8" ?>  
standalone="no" (yes)文档是否独立  
<?xml version="1.0" encoding="utf-8" standalone="yes"?>

对于xml标签中出现的所有空格和换行，xml解析程序都会当作标签内容进行处理。在xml中，空格和换行都作为原始内容被处理，所以在编写xml文件时，使用换行和缩进等方式来让原文件中的内容清晰可读的“良好” 书写习惯可能要被迫改变，例如下面两段内容是不一样的：

<网址>ljfbest.com</网址>

<网址>  
ljfbest.com  
</网址>

有些内容不想被解析，可以放在CDATA区里<!\[CDATA\[<it>abc</it>\]\]>  
转义字符<等

要约束一个xml文档可以通过dtd或者schema，schema已经成为w3c的标准schema文件本身就是一个xml文件，但扩展名通常为.xsd,一个schema文档必须有根节点schema编写了一个schema文档后，通常需要把这个文件中声明的元素绑定到一个URI地址上，在schema技术中有一个专业术语来描述这个过程，即把schema文档声明的元素绑定到一个名称空间上，以后xml文件就可以通过这个URI（即**名称空间**）来告诉解析引擎，xml文档中编写的元素来自哪里，被谁约束，看下面一个例子：

ai.xsd

<?xml version="1.0" encoding="utf-8" ?>
    <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"  
    		targetNamespace="http://ljfbest.com"
    		elementFormDefault="qualified">
    
    	<xs:element name="书架">
    		<xs:complexType>
    			<xs:sequence maxOccurs="unbounded">
    				<xs:element name="书名" type="xs:string" />
    				<xs:element name="作者">
    					<xs:complexType>
    						<xs:sequence maxOccurs="1">
    							<xs:element name="fname" type="xs:string" />
    							<xs:element name="lname" type="xs:string" />
    						</xs:sequence>
    					</xs:complexType>
    
    				</xs:element>
    				<xs:element name="售价" type="xs:float" />
    			</xs:sequence>
    		</xs:complexType>
    	</xs:element>
    
    </xs:schema>

2行：引入schema的命名空间，並且加入前缀xs，如果不加xs的话，文档中的xs:都要刪去 -->

3行：为该文档指定命名空间-->

4行：unqualified，则无须通过命名空间前缀限定目标命名空间的元素， qualified，则必须通过命名空间前缀限定目标命名空间的元素。

然后下面的内容就是对xml约束内容了，主要注意以下的点

简单元素：只含有文本的XML元素，不可以含有其他元件或属性定义简明元素的语法为：

<xs:element name="xxx" type="yyy"/>

属性：简单的元素没有属性，当元素含有属性时，它会被认为是复合元素，但属性本身总是被声明为简单类型。定义一项属性的语法是：  
<xs:attribute name="xxx" type="yyy"/>

复合元素：包含其他元素或属性

其它细节在schema文档中均有详细介绍。下面来看如何在xml中引入该schema……

<?xml version="1.0" encoding="utf-8" ?>
    <xi:书架 xmlns:xi="http://ljfbest.com" xs:schemaLocation="http://ljfbest.com ai.xsd"
    	xmlns:xs="http://www.w3.org/2001/XMLSchema-instance">
    	<xi:书名>java</xi:书名>
    	<xi:作者>
    		<xi:fname>Jianfeng</xi:fname>
    		<xi:lname>Li</xi:lname>
    	</xi:作者>
    	<xi:售价>23.00</xi:售价>
    </xi:书架>

2行：引入书架和的命名空间，并且指出xsd所在位置  
3行：引入schemaLocation的命名空间

wsdl 文档介绍

WSDL 网络服务描述语言 (Web Services Description Language),使用 XML 编写的文档,可描述某个 Web service,它可规定服务的位置，以及此服务提供的操作（或方法）。WSDL文档只是一个Web Service相关特征、规范的定义集，在根部有一个“definitions"元素，其中包含一些定义。具体来说，服务使使用以下七个主要元素来定义的：

•Types - web service 使用的数据类型，一般使用XML Schema中的类型系统。  
•Message - web service 使用的消息,每个消息均由一个或多个部件组成。可以把这些部件比作传统编程语言中一个函数调用的参数。使用Types所定义的类型来定义整个消息的[数据结构][Link 1]。

•PortType - 指明服务器接口，并且通过operation绑定in（参数）/out（返回值）消息，它可描述一个 web service可被执行的操作，以及相关的消息。  
•Operation - 对服务中所支持的操作的抽象描述，一般单个Operation描述了一个访问入口的请求/响应消息对。  
•Binding - 为每个端口定义消息格式和协议细节。  
•Port - 定义为协议/数据格式绑定与具体Web访问地址组合的单个服务访问点。  
•Service - 相关服务访问点的集合。

看看下面的一段WSDL文件：

xml文档第一句：definitions--WSDL文档的根元素，该元素的属性指明了wsdl文档的名称，文档的目标名字空间，以及WSDL文档应用的名字空间的速记定义。它指明了此Web Service的名称为：MyServiceImplService。然后找到名为“MyServiceImplService”的service具体定义如下所示：  
<service name="MyServiceImplService">  
<port name="MyServiceImplPort" binding="tns:MyServiceImplPortBinding">  
<soap:address location="http://localhost:8089/na" />  
</port>  
</service>  
service---相关port元素的集合，用户组织endpoint定义。  
port--通过binding和物理地址定义的endpoint，这个元素将所有抽象定义聚集在一起  
这部分是具体的Web服务的定义，在这个名为MyServiceImplService的Web服务中，提供了一个服务访问入口，访问地址是"http://localhost:8089/na"，使用的消息模式是由前面的binding“MyServiceImplService”所定义的。这段xml定义的操作“add”使用的是SoapDocumentProtocol消息格式（style="document"）。输入和输出参数格式都是“Literal”（use="literal"）。

<output message="tns:addResponse" />  
           </operation>  
</portType>  
portType---描述服务逻辑接口的operation元素的集合。IMyService只有一个操作add。这部分定义了服务访问点的调用模式的类型，表明 MyService的add入口类型是请求/响应模式，请求消息是add，而响应消息是addReponse。

<message name="add">  
<part name="parameters" element="tns:add" />  
</message>  
<message name="addResponse">  
<part name="parameters" element="tns:addResponse" />  
</message>  
这部分是消息格式的抽象定义，其中定义了两个消息格式：  
•addResponse( 响应消息格式 ): 由一个消息片断组成，该消息片断的名字是parameters，包含的具体元素类型是addResponse。  
•add( 请求消息格式 ) : 由一个消息片断组成，该消息片断的名字是parameters ，包含的具体元素类型是add。

<types>  
<xsd:schema>  
<xsd:import namespace="http://service.ljfbest.com/" *schemaLocation="http://localhost:8089/na?xsd=1" />*  
</xsd:schema>  
</types>  
上面这部分是数据类型的定义，其中为定义了两个元素的结构:  
•add(请求参数的类型): 将该元素定义为包含一个字符串元素(arg0)的复合类型元素。  
•addResponse(响应参数的类型): 将该元素定义为包含一个字符串元素(return)的复合类型元素。  
数据类型的详细消息在schemaLocation="http://localhost:8089/na?xsd=1 这个地址里，打开可以看到一个xsd文件：

<xs:schema xmlns:tns="http://service.ljfbest.com/" 
            xmlns:xs="http://www.w3.org/2001/XMLSchema"
    	version="1.0" targetNamespace="http://service.ljfbest.com/">
    	<xs:element name="add" type="tns:add" />
    	<xs:element name="addResponse" type="tns:addResponse" />
    	<xs:complexType name="add">
    		<xs:sequence>
    			<xs:element name="arg0" type="xs:int" />
    			<xs:element name="arg1" type="xs:int" />
    		</xs:sequence>
    	</xs:complexType>
    	<xs:complexType name="addResponse">
    		<xs:sequence>
    			<xs:element name="return" type="xs:int" />
    		</xs:sequence>
    	</xs:complexType>
    </xs:schema>

这表明add操作是一个 int add(int n)的方法。其中上述的类型均遵循xsd的定义。

[Link 1]: http://lib.csdn.net/base/datastructure