.NET基础示例系列之二十一：Web Service

1.基本概念
我没有考据过Web Service的概念具体是什么时间提出的，肯定已经不是很新鲜。对我来说“潮流只能等，不能追”，我是随其波而逐其流，跟着学习学习。
Web Service的目标是使不同的应用程序域能在Web上实现相互之间的访问、操作。将来或许有一些人或者公司，他们在网络上发布Web Service接口，公众或者公司在需要某些服务功能（如一些非常复杂的计算）时，可以在网络上搜索有无此类功能的接口，找到之后便可以在自己的程序中调用这些接口，并付给接口作者一定的费用，使用者就可以不必自己去实现所需的功能了。

另外，相关的概念还有：
SOAP：它是Simple Object Access Protocol的缩写，即“简单对象访问协议”。简单说来，SOAP就是用来访问Web Service的协议，它的本质工作是定义了访问Web Service的信息发送格式。
WSDL：它是Web Services Description Language的缩写，用来描述Web服务XML语言。它以一定的格式描述某个Web Service接口的名称、参数、返回值等等内容（详细可以参见下面的示例），它就是一个接口文档，当你在教别人怎么调用你的接口时，可以给它一个对应的wsdl文件。


2.创建Web Service接口
使用Visual Studio 2005可以十分方便地创建一个Web Service程序：新建网站>>选择“Asp.net Web服务”模板，输入名称，如“WebSrvSample”，点击确定即可。初始情况下，工程中包含一个.asmx文件、一个.cs文件。我们的代码就写在.cs文件里：

Code
using System;
using System.Web;
using System.Web.Services;
using System.Web.Services.Protocols;

[WebService(Namespace = "http://www.SomeNobody.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
public class ComplexCalculationSrv : System.Web.Services.WebService
{
    public ComplexCalculationSrv () 
    {
        //如果使用设计的组件，请取消注释以下行 
        //InitializeComponent(); 
    }

    [WebMethod(Description="非常复杂的计算")]
    public double DoVeryComplexCalculation()
    {
        //…………
        //省略计算过程^^
        return 3.1415926;
    }
}

这个类的默认名称是Service，如果你修改了类的名称，请手工同步.asmx文件中的相应内容。写完代码之后，F6生成一下就行了。可以通过：
http://hostip/WebSrvSample/ComplexCalculationSrv.asmx 来查看接口。同时，可以通过：http://hostip/WebSrvSample/ComplexCalculationSrv.asmx?wsdl 来查看该接口的wsdl描述，也可以要浏览器中选择另存，将其存为.wsdl文件。内容类似如下：

Code
<?xml version="1.0" encoding="utf-8"?>
<wsdl:definitions xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/" xmlns:tm="http://microsoft.com/wsdl/mime/textMatching/" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/" xmlns:tns="http://www.SomeNobody.org/" xmlns:s="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" xmlns:http="http://schemas.xmlsoap.org/wsdl/http/" targetNamespace="http://www.SomeNobody.org/" xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">
  <wsdl:types>
    <s:schema elementFormDefault="qualified" targetNamespace="http://www.SomeNobody.org/">
      <s:element name="DoVeryComplexCalculation">
        <s:complexType />
      </s:element>
      <s:element name="DoVeryComplexCalculationResponse">
        <s:complexType>
          <s:sequence>
            <s:element minOccurs="1" maxOccurs="1" name="DoVeryComplexCalculationResult" type="s:double" />
          </s:sequence>
        </s:complexType>
      </s:element>
    </s:schema>
  </wsdl:types>
  <wsdl:message name="DoVeryComplexCalculationSoapIn">
    <wsdl:part name="parameters" element="tns:DoVeryComplexCalculation" />
  </wsdl:message>
  <wsdl:message name="DoVeryComplexCalculationSoapOut">
    <wsdl:part name="parameters" element="tns:DoVeryComplexCalculationResponse" />
  </wsdl:message>
  <wsdl:portType name="ComplexCalculationSrvSoap">
    <wsdl:operation name="DoVeryComplexCalculation">
      <wsdl:documentation xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/">非常复杂的计算</wsdl:documentation>
      <wsdl:input message="tns:DoVeryComplexCalculationSoapIn" />
      <wsdl:output message="tns:DoVeryComplexCalculationSoapOut" />
    </wsdl:operation>
  </wsdl:portType>
  <wsdl:binding name="ComplexCalculationSrvSoap" type="tns:ComplexCalculationSrvSoap">
    <soap:binding transport="http://schemas.xmlsoap.org/soap/http" />
    <wsdl:operation name="DoVeryComplexCalculation">
      <soap:operation soapAction="http://www.SomeNobody.org/DoVeryComplexCalculation" style="document" />
      <wsdl:input>
        <soap:body use="literal" />
      </wsdl:input>
      <wsdl:output>
        <soap:body use="literal" />
      </wsdl:output>
    </wsdl:operation>
  </wsdl:binding>
  <wsdl:binding name="ComplexCalculationSrvSoap12" type="tns:ComplexCalculationSrvSoap">
    <soap12:binding transport="http://schemas.xmlsoap.org/soap/http" />
    <wsdl:operation name="DoVeryComplexCalculation">
      <soap12:operation soapAction="http://www.SomeNobody.org/DoVeryComplexCalculation" style="document" />
      <wsdl:input>
        <soap12:body use="literal" />
      </wsdl:input>
      <wsdl:output>
        <soap12:body use="literal" />
      </wsdl:output>
    </wsdl:operation>
  </wsdl:binding>
  <wsdl:service name="ComplexCalculationSrv">
    <wsdl:port name="ComplexCalculationSrvSoap" binding="tns:ComplexCalculationSrvSoap">
      <soap:address location="http://localhost/WebSrvSample/ComplexCalculationSrv.asmx" />
    </wsdl:port>
    <wsdl:port name="ComplexCalculationSrvSoap12" binding="tns:ComplexCalculationSrvSoap12">
      <soap12:address location="http://localhost/WebSrvSample/ComplexCalculationSrv.asmx" />
    </wsdl:port>
  </wsdl:service>
</wsdl:definitions>

3.接口调用
下面演示如何在一个新的程序中调用刚上完成的Web Service接口，可以新建一个WinFrom工程，比如“UseWebSrv”。在项目的引用中添加Web引用，在弹出的窗口中输入接口url地址：
http://hostip/WebSrvSample/ComplexCalculationSrv.asmx，点击“前往”，以测试连接是否成功。随后在“Web引用名”处为你的web引用取个名称，如“WebSrvSample”，点击确定。随后编写调用代码：

Code
using System;
using System.Collections.Generic;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Text;
using System.Windows.Forms;
using UseWebSrv.WebSrvSample;

namespace UseWebSrv
{
    public partial class Form1 : Form
    {
        public Form1()
        {
            InitializeComponent();
        }

        private void button1_Click(object sender, EventArgs e)
        {
            ComplexCalculationSrv srv = new ComplexCalculationSrv();
            double d = srv.DoVeryComplexCalculation();
            this.textBox1.Text = d.ToString();
        }
    }
}

注意引用的名称空间即此项目的名称空间+你刚才为Web引用取的名称。


4.其它问题
实验中发现在Web Service接口代码中不能使用方法的重载，就是不允许存在方法名一样的两个方法，即使它们的参数不同。