WebService开发心得

      又好久没有上来写文章了（为什么要说又呢？？？），最近比较忙，不过都是乱七八糟的事情，哎！
前一阵公司有个项目，用VS 2005开发的Web Service，有点心得，写下来，与君共勉！！！

      这次完全采用Schema来定义数据结构，以一个书目查询的服务为例！那么我们先来定义一个关于书籍信息的数据结构的Schema：

<?xml version="1.0" encoding="UTF-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:in="http://www.bookinfo.com/bookinfo/" targetNamespace="http://www.bookinfo.com/bookinfo/" elementFormDefault="qualified" attributeFormDefault="unqualified">
    <xs:complexType name="BookInfoType">
        <xs:sequence>
            <xs:element name="BookName" type="xs:string"/>
            <xs:element name="AuthorName" type="xs:string"/>
            <xs:element name="Price" type="xs:float"/>
            <xs:element name="Publish" type="xs:string"/>
            <xs:element name="PublishDate" type="xs:dateTime"/>
        </xs:sequence>
    </xs:complexType>
    <xs:element name="BookInfo" type="in:BookInfoType"/>
</xs:schema>

      之后我们再来定义一下Request协议的Schema

<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:ns1="http://www.bookinfo.com/bookinforequest/" targetNamespace="http://www.bookinfo.com/bookinforequest/" elementFormDefault="qualified" attributeFormDefault="unqualified">
    <xs:element name="QueryInfo">
        <xs:complexType>
            <xs:sequence>
                <xs:element name="BookName" type="xs:string" minOccurs="0"/>
                <xs:element name="AuthorName" type="xs:string" minOccurs="0"/>
                <xs:element name="PublishDate" minOccurs="0">
                    <xs:complexType>
                        <xs:sequence>
                            <xs:element name="StartDate" type="xs:dateTime"/>
                            <xs:element name="EndDate" type="xs:dateTime" minOccurs="0"/>
                        </xs:sequence>
                    </xs:complexType>
                </xs:element>
            </xs:sequence>
        </xs:complexType>
    </xs:element>
</xs:schema>

      好了，Request协议的结构定义完了，接下来就是Resposne的Schema了！

 

<?xml version="1.0" encoding="utf-8"?>
<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:in="http://www.bookinfo.com/bookinfo/" xmlns:r="http://www.bookinfo.com/bookinforesponse/" targetNamespace="http://www.bookinfo.com/bookinforesponse/" elementFormDefault="qualified" attributeFormDefault="unqualified">
    <!-- 引用Schema -->
    <xs:import namespace="http://www.bookinfo.com/bookinfo/" schemaLocation="D:\文档\Document\BookInfo.xsd"/>
    <!--引用Schema结束-->
    <!--数据类型定义-->
    <!--书籍信息列表-->
    <xs:complexType name="BookInfoListType">
        <xs:sequence>
            <xs:element name="BookInfo" type="in:BookInfoType" maxOccurs="unbounded"/>
        </xs:sequence>
    </xs:complexType>
    <!--书籍信息列表结束-->
    <!--数据类型定义结束-->
    <!--内容-->
    <xs:element name="BookInfoList" type="r:BookInfoListType"/>
    <!--内容-->
</xs:schema>

      Schema都定义完成了，我们可以使用VS自带的工具xsd.exe来生成XML序列化过的类文件了，xsd.exe会将Schema里的文档部分的根节点生成类，并将其它的element及attribute序列化为子类及属性

      将生成的类文件加到我们的项目里，开始WebService的编写

      首先是WebMethod的定义

      [WebMethod]
      public BookInfoListType BookInfoRequest(QueryInfo query) 
      {
           return null;      
      }
   
      这里比较特殊的就是方法的返回数据类型及参数数据类型，返回的数据类型为BookInfoListType，而参数的数据类型为QueryInfo，这两个类型，都是我们用Schema生成的类型，可以根据类实例属性的值，生成符合Schema要求的XML串，也可以自动解析符合Schema定义的XML字符串，将XML串里的数据信息，赋给类实例的相应属性
      当我们调用WebService时，.Net会将Post过来的XML字符串进行解析，并将XML字符串里的值，赋给类实例里的相应的属性，我们再通过取得的属性值进行相关操作
      在设置返回数据类型的类实例时，可以将想要返回的值赋给类实例，之后return这个实例就可以了，.net会
将这个XML序列化过的类实例生成XML串，并Response

      附上程序实例 WebSite