webservice学习

1.Webservice
  可返回类型
  int,string,double,bool,DataTable,DataSet,ArraList,List<string[]>,string[],void,Guid

  可传递参数
  对象,int,string,double,bool,List<string[]>,byte[],Guid,out int
   [WebMethod]
   public string Send(SendData item)
   {

   }
   
  特别注意:
  1.不能有方法重写,方法名必须唯一,否则不能添加web引用
  2.webservice方法不能加static修饰,否则引用中找不到需要的方法
  3.webservice方法前一定要有[WebMethod],否则也找不到
  4.返回类型是DataTable的时候,DataTable一定要有名字,否则程序运行中报错
  

1.1    基础概念

       Web Service是一种可以接收从Internet或者Intranet上的其它系统中传递过来的请求,轻量级的独立的通讯技术。通过SOAPWeb上提供的服务,使用WSDL文件进行说明,并通过UDDI进行注册。

XML(Extensible Markup Language)扩展型可标记语言。面向短期的临时数据处理、面向万维网络,是Soap的基础。

Soap(Simple Object Access Protocol)简单对象存取协议。是XML Web Service 的通信协议。当用户通过UDDI找到你的WSDL描述文档后,他通过可以SOAP调用你建立的Web服务中的一个或多个操作。SOAPXML文档形式的调用方法的规范,它可以支持不同的底层接口,像HTTP(S)或者SMTP

WSDL(Web Services Description Language) WSDL 文件是一个 XML 文档,用于说明一组 SOAP 消息以及如何交换这些消息。大多数情况下由软件自动生成和使用。

UDDI (Universal Description Discovery and Integration) 是一种根据描述文档来引导系统查找相应服务的机制。UDDI利用SOAP消息机制(标准的XML/HTTP)来发布,编辑,浏览以及查找注册信息。它采用XML格式来封装各种不同类型的数据,并且发送到注册中心或者由注册中心来返回需要的数据。

    

1.2  Webservice基础实例

代码
using System;
using System.Collections.Generic;
using System.Linq;
using System.Web;
using System.Web.Services;

namespace AspNetWebServiceClient
{
    /// <summary>
    /// Service1 的摘要说明
    /// </summary>
    [WebService(Namespace = "http://tempuri.org/")]
    [WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
    [System.ComponentModel.ToolboxItem(false)]
    // 若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务,请取消对下行的注释。
    // [System.Web.Script.Services.ScriptService]
    public class Service1 : System.Web.Services.WebService
    {

        [WebMethod]
        public string HelloWorld()
        {
            return "Hello World";
        }

        [WebMethod]
        public int Add(int a, int b)
        {
            return a + b;
        }

        [WebMethod]
        public int Subtract(int a, int b)
        {
            return a - b;
        }

    }
}

直接运行看看效果,

1.3    WebservicewebMethod的各种特性:

 

属性

功能

示例

BufferResponse

设置为True时,XML Web服务的响应就保存在内存中,并发送为一个完整的包。如果该属性设置为False,则响应在服务器上构造的同时,会发送给客户机。

[WebMethod(BufferResponse=true)]

CacheDuration

指定响应在系统的高速缓存中的保存时间(秒),默认值为0,表示禁用高速缓存。把XML Web服务的响应放在高速缓存中,会提高Web服务的性能。

   [WebMethod(BufferResponse=true,CacheDuration=30)]

Description

对在XML Web服务的测试页面上显示的Web Method应用文本的描述。

[WebMethod(Description="该方法用于获取一个简单的字符串")]

EnableSession

设置为True时,会激活Web Method的会话状态,其默认值为False

[WebMethod(EnableSession=true)]

MessageName

Method指定一个唯一的名称,如果要使用重载的Web Method,则必须指定。

[WebMethod(MessageName="Method1")]

TransactionOption

Web Method指定事务的支持,其默认值为Disbled。如果Web Method是启动事务的根对象,Web服务就可以用另一个需要事务处理的WebMethod参与事务处理。其值可以是NotSupportedSupportedRequiredRequiresNew

[WebMethod(TransactionOption=System.EnterpriseServices.TransactionOption.Sup

关于Session的特性见下面,其他的特性的代码实例就不贴了

服务端代码:

代码
        [WebMethod(EnableSession = true)]
        public void  Login(string userName)
        {
            if (userName.Length > 0)
            {
                Session["Name"] = userName;
            }
        }

        [WebMethod(EnableSession = true)]
        public string TestSession()
        {
            string userName = Session["Name"].ToString();
            return userName;
        }

客户端代码:

代码
            localhost.Service1 proxy= new SimpleWebService.localhost.Service1();
            proxy.CookieContainer = new System.Net.CookieContainer();
            proxy.Login("123");
            Label1.Text = proxy.TestSession().ToString();

1.4 WebService的异步开发模式

 

当用到WebService时,由于服务器处理速度、网络传输速度等各种原因会使一个WebService从请求开始到获得响应结果之间等待一段时间,这时候线程会处于阻塞状态,程序会等待请求结果导致客户端无法进行其他的动作或处理。这时候就需要异步的使用WebService。 

代码
        public void TestAsyncWebService()
        {
             localhost3.AsyncWebService service = new localhost3.AsyncWebService();
             service.HelloWorldCompleted+=new WebClientTest.localhost3.HelloWorldCompletedEventHandler(service_HelloWorldCompleted);
             service.HelloWorldAsync("China");
        }

        void service_HelloWorldCompleted(object sender, WebClientTest.localhost3.HelloWorldCompletedEventArgs e)
        {
            if (e.Result != null && e.Result.Length > 0)
            {
                string result= e.Result;
                Label3.Text = result;
            }
            if (e.Error != null)
            {
                Console.WriteLine(e.Error.Message);
            }   

        }

1.5    webService的验证方式及安全性

1.5.1   使用SOAP头来验证

服务端代码

代码
 public class SOAPWebService : System.Web.Services.WebService
    {

        [WebMethod]
        public string HelloWorld()
        {
            return "Hello World";
        }

        public MySoapHeader header;
        [SoapHeader("header", Direction = SoapHeaderDirection.In)]
        [WebMethod]
        public string CheckHeader()
        {
            if (header == null)
            {
                throw new SoapHeaderException("认证失败", SoapException.ClientFaultCode);
            }
            else
            {
                if (header.Name != "admin" || header.PassWord != "admin")
                {
                    throw new SoapHeaderException("认证失败", SoapException.ClientFaultCode);
                }
            }
            //业务逻辑.
            return "Something done";
        }

    }

    public class MySoapHeader : SoapHeader
    {
        string _name;
        string _passWord;

        public string Name
        {
            get { return _name; }
            set { _name = value; }
        }
        public string PassWord
        {
            get { return _passWord; }
            set { _passWord = value; }
        }
    }

客户端代码:

代码
        public void TestSoapHeader()
        {
            MySoapHeader h = new MySoapHeader();
            h.Name = "cqs";
            h.PassWord = "123";
            localhost1.SOAPWebService service = new SOAPWebService();
            service.MySoapHeaderValue = h;
            try
            {
                string retval = service.CheckHeader();
                Label1.Text="Return:" + retval;
            }
            catch (SoapHeaderException soapEx)
            {
                Label2.Text="Soap Header Exception:" + soapEx.Message;
            }
            catch (Exception ex)
            {
                Label3.Text="Exception:" + ex.Message;
            }

        }

1.6 Webservice 的动态代理

在程序中需要调用WebService时,都是通过添加Web引用,让VS.NET环境来为我们生成服务代理,然后调用对应的Web服务。这样是使工作简单了,但是却和提供Web服务的URL、方法名、参数绑定在一起了,这是VS.NET自动为我们生成Web服务代理的限制。如果发布Web服务的URL改变了,则我们需要重新让VS.NET生成代理,并重新编译。动态调用WebService就能解决上述难题,比如我们可以把Web服务的URL保存在配置文件中,这样,当服务URL改变时,只需要修改配置文件就可以了。具体的代码参见网上常见的动态代理类:

 

代码
        /// <summary>
        /// 
        /// </summary>
        public void TestDynamicWebService()
        {
            try
            {
                string url = "http://localhost:4640/DynamicWebService.asmx";
                string[] args = new string[1];
                args[0] = "China";
                object result = DynamicWebServiceHelper.InvokeWebService(url, "HelloWorld", args);
                this.Label1.Text = result.ToString();
            }
            catch (Exception ex)
            {
                Label3.Text = "Exception:" + ex.Message;
            }

        }

上述的参数具体可以利用配置文件的方式获取,更增加灵活性,但是通过动态代理的方式将会使性能有所降低。

1.7   扩展SOAP

 

代码

  1.8  Webservice的异常处理

   Webservice客户端使用一个WebMethod时,如果WebMethod内部出现异常,不管异常是系统级异常或者自定义的异常,均会被包装为SoapException类型的异常,返回给客户端。

 

服务端代码:

代码

    public class Service1 : System.Web.Services.WebService
    {

        [WebMethod]
        public string HelloWorld()
        {
            return "Hello World";
        }

        /// <summary>
        /// 根据ID读取人员信息
        /// </summary>
        /// <returns>人员信息类</returns>
        [WebMethod]
        public int Division(int x,int y)
        {
            try
            {
                return  x / y;
            }
            catch (System.Exception ex)
            {
                throw new ExceptionHelper().RaiseException(
                                        "Division",
                                        ex.Message,
                                        "1000",
                                        ex.Source,
                                        FaultCode.Server
                                    );
            }
        }

        [WebMethod]
        public void TestException()
        {
            throw new SoapException("Invalid Operation.", SoapException.ServerFaultCode);
        } 

    }

    /// <summary>
    /// 异常类型
    /// </summary>
    public enum FaultCode
    {
        Client = 0,
        Server = 1
    }

    public class ExceptionHelper
    {
        /// <summary>
        /// 封装异常为SoapException
        /// </summary>
        /// <param name="uri">引发异常的方法uri</param>
        /// <param name="errorMessage">错误信息</param>
        /// <param name="errorNumber">错误号</param>
        /// <param name="errorSource">错误源</param>
        /// <param name="code">异常类型</param>
        /// <returns>封装后的SoapException</returns>
        public SoapException RaiseException(string uri, string errorMessage, string errorNumber, string errorSource, FaultCode code)
        {
            //初始化限定名
            XmlQualifiedName faultCodeLocation = null;

            //异常类型代码转换
            switch (code)
            {
                case FaultCode.Client:
                    faultCodeLocation = SoapException.ClientFaultCode;
                    break;
                case FaultCode.Server:
                    faultCodeLocation = SoapException.ServerFaultCode;
                    break;
            }

            //构建异常信息结构体
            string strXmlOut = @"<detail>"
                             + "<Error>"
                             + "<ErrorNumber>" + errorNumber + "</ErrorNumber>"
                             + "<ErrorMessage>" + errorMessage + "</ErrorMessage>"
                             + "<ErrorSource>" + errorSource + "</ErrorSource>"
                             + "</Error>"
                             + "</detail>";

            //装载为Xml文档
            XmlDocument xmlDoc = new XmlDocument();
            xmlDoc.LoadXml(strXmlOut);

            //实例化SoapException
            SoapException soapEx = new SoapException(errorMessage, faultCodeLocation, uri, xmlDoc.DocumentElement);

            //返回SoapException
            return soapEx;
        }

 

 
通过扩展SOAP可以针对消息做日志
 
 
 
在学习WebService之前,我们首先来了解在没有WebService之前我们是怎么实现跨服务器,跨平台的调用的。我现在项目中就是没有用WebService,我们是通过实现接口调用来实现的。定义一个接口,然后通过发起http请求来调用接口。这样也是可以实现我们的跨服务和跨平台。但是这样的做法是有缺点的。为了使http接口能被访问到,在WebForm情况下,我们需要定义一个页面来作为被调用的接口。在MVC下我们需要定义一个Action来作为被调用的接口,因为http调用是需要一个url的,我们不同说直接在BLL定义一个方法提供http调用。这就意味着当我们要定义接口就必须在表现层上添加页面或者Action,然后他们再来调用BLL层的方法,这样繁琐,而且无意中添加了许多不是用来显示的页面。

      因此我们再想能不能直接在BLL层定义方法,或者独立出一个层但是不用到表现层添加页面,就能实现像接口一样被访问到。这个需求就催生了WebService,其就是用来实现前面那一句所说的。Webservice主要由以下这几个部分组成:

      (1)SOAP:一个基于XML的可扩展消息信封格式,需同时绑定一个传输用协议。这个协议通常是HTTP或HTTPS,但也可能是SMTP或XMPP。
      (2)WSDL:一个XML格式文档,用以描述服务端口访问方式和使用协议的细节。通常用来辅助生成服务器和客户端代码及配置信息。
      (3)UDDI:一个用来发布和搜索WEB服务的协议,应用程序可借由此协议在设计或运行时找到目标WEB服务。

      由于不同平台对于数据的表示形式是不一致的,因此我们就需要一个第三方协议来描述不同平台之间的数据表示,这个就是xml,有了xml来进行数据的表示,就需要一个协议来进行不同平台的传输,这个可以是htpp,https也可能是SMTP或XMPP。一个数据表示格式绑定上一个传输协议这就是SOAP。

      在进行接口调用的时候我们是通过统一的url来实现的,对于WebService所发布的服务,我们也需要一个标识来定位,接下来进行访问。这就是UDDI.

      WebService是实现Web服务的一个技术。有了上面对于WebService技术的了解,接下来阐述WebService就更加容易了。

      Web服务有两层含义:1、是指封装成单个实体并发布到网络上的功能集合体;2、是指功能集合体被调用后所提供的服务。简单地讲,Web服务是一个URL资源,客户端可以通过编程方式请求得到它的服务,而不需要知道所请求的服务是怎样实现的,这一点与传统的分布式组件对象模型不同。

      Web服务的体系结构是基于Web服务提供者、Web服务请求者、Web服务中介者三个角色和发布、发现、绑定三个动作构建的。简单地说,Web服务提供者就是Web服务的拥有者,它耐心等待为其他服务和用户提供自己已有的功能;Web服务请求者就是Web服务功能的使用者,它利用SOAP消息向Web服务提供者发送请求以获得服务;Web服务中介者的作用是把一个Web服务请求者与合适的Web服务提供者联系在一起,它充当管理者的角色,一般是UDDI。这三个角色是根据逻辑关系划分的,在实际应用中,角色之间很可能有交叉:一个Web服务既可以是Web服务提供者,也可以是Web服务请求者,或者二者兼而有之。显示了Web服务角色之间的关系:其中,“发布”是为了让用户或其他服务知道某个Web服务的存在和相关信息;“查找(发现)”是为了找到合适的Web服务;“绑定”则是在提供者与请求者之间建立某种联系。

 

图2-1 Web service的体系结构

    实现一个完整的Web服务包括以下步骤:

 Web服务提供者设计实现Web服务,并将调试正确后的Web服务通过Web服务中介者发布,并在UDDI注册中心注册 (发布)

  Web服务请求者向Web服务中介者请求特定的服务,中介者根据请求查询UDDI注册中心,为请求者寻找满足请求的服务; (发现)

 Web服务中介者向Web服务请求者返回满足条件的Web服务描述信息,该描述信息用WSDL写成,各种支持Web服务的机器都能阅读;(发现)

 ◆ 利用从Web服务中介者返回的描述信息生成相应的SOAP消息,发送给Web服务提供者,以实现Web服务的调用;(绑定)

 Web服务提供者按SOAP消息执行相应的Web服务,并将服务结果返回给Web服务请求者。(绑定)

这面Web服务这部分转载自:

http://www.cnblogs.com/lingfengtian/archive/2009/04/25/1443545.html

 

【IT168 技术文档】Web Service是可操作的分布式应用程序。它以SOAP作为基本通信协议,使用HTTP和XML进行可以穿越防火墙的自由通信。

  错误提示:

  ·出现 访问 IIS 元数据库失败

  ·iis 无法显示XML

  解决:开始->程序->Microsoft Visual Studio 2005->Visual StudioTools中打开命令行,输入命令: aspnet_regiis -i 这样就会重新注册.net

  另还需在虚拟目录上打开属性对话框,点击ASP.NET属性页在“Asp.net version”项选择相应的Asp.net版本(1.1或者2.0)

  ·无权限问题

  因为我们现在用的都是NTFS格式的硬盘,把Everyone用户选择上或者在IIS中把允许匿名访问勾上

  ·把Window系统集成用户去掉勾选

  1.首先添加新项---Web服务---*.asmx

  同时在App_Code文件夹下增加了一个*.cs文件

  WebMethod] public string[] GetHotSearchByKeywords (string keyword) { return SearchKeywordManager.GetHotSearchByKeywords (keyword); } [WebMethod]是Web Service为我们提供的特性, 它表示下面的方法是 Web 方法,允许Web使用SOAP调用该方法 一个Web Service文件中可以有多个[WebMethod], 一个[WebMethod]只能对它下面的方法有效

  写完以后,可以直接打开这个文件进行测试,成功后,即可发布

  2.C# webService发布

  C# webService发布网站---创建虚拟目录---浏览WebService页面---测试WebService方法

  在发布的时候有可能会出现一点小问题,上面是出错的状况

  打开WebService的那个网址,就是要发布的WebService的URL

  3.C# WebService调用

  添加Web引用---实例化WebService类---执行WebService方法

  WebService可能在本项目、非本项目、甚至在异地被调用

  ·添加WebService引用

  ·在URL处填写发布的WebService网址,单击前往,就会看到我们发布的WebService方法

  ·可以改一下WebService的引用名

  C# WebService调用这个方法

  引用名.类名s=new引用名.类名();

  ·添加完引用后,同时会看到App_WebReferences文件夹下已经添加了WebService的相关文件

  ·.disco

  ·.discomap

  ·.wsdl

 

 

1.1、Web Service基本概念


Web Service也叫XML Web Service WebService是一种可以接收从Internet或者Intranet上的其它系统中传递过来的请求,轻量级的独立的通讯技术。是:通过SOAP在Web上提供的软件服务,使用WSDL文件进行说明,并通过UDDI进行注册。

XML:(Extensible Markup Language)扩展型可标记语言。面向短期的临时数据处理、面向万维网络,是Soap的基础。

Soap:(Simple Object Access Protocol)简单对象存取协议。是XML Web Service 的通信协议。当用户通过UDDI找到你的WSDL描述文档后,他通过可以SOAP调用你建立的Web服务中的一个或多个操作。SOAP是XML文档形式的调用方法的规范,它可以支持不同的底层接口,像HTTP(S)或者SMTP。

WSDL:(Web Services Description Language) WSDL 文件是一个 XML 文档,用于说明一组 SOAP 消息以及如何交换这些消息。大多数情况下由软件自动生成和使用。

UDDI (Universal Description, Discovery, and Integration) 是一个主要针对Web服务供应商和使用者的新项目。在用户能够调用Web服务之前,必须确定这个服务内包含哪些商务方法,找到被调用的接口定义,还要在服务端来编制软件,UDDI是一种根据描述文档来引导系统查找相应服务的机制。UDDI利用SOAP消息机制(标准的XML/HTTP)来发布,编辑,浏览以及查找注册信息。它采用XML格式来封装各种不同类型的数据,并且发送到注册中心或者由注册中心来返回需要的数据。

1.2、XML Web Service的特点

Web Service的主要目标是跨平台的可互操作性。为了实现这一目标,Web Service 完全基于XML(可扩展标记语言)、XSD(XML Schema)等独立于平台、独立于软件供应商的标准,是创建可互操作的、分布式应用程序的新平台。因此使用Web Service有许多优点:

1、跨防火墙的通信

如果应用程序有成千上万的用户,而且分布在世界各地,那么客户端和服务器之间的通信将是一个棘手的问题。因为客户端和服务器之间通常会有防火墙或者代理服务器。传统的做法是,选择用浏览器作为客户端,写下一大堆ASP页面,把应用程序的中间层暴露给最终用户。这样做的结果是开发难度大,程序很难维护。 要是客户端代码不再如此依赖于HTML表单,客户端的编程就简单多了。如果中间层组件换成Web Service的话,就可以从用户界面直接调用中间层组件,从而省掉建立ASP页面的那一步。要调用Web Service,可以直接使用Microsoft SOAP Toolkit或.net这样的SOAP客户端,也可以使用自己开发的SOAP客户端,然后把它和应用程序连接起来。不仅缩短了开发周期,还减少了代码复杂度,并能够增强应用程序的可维护性。同时,应用程序也不再需要在每次调用中间层组件时,都跳转到相应的"结果页"。

2、应用程序集成

企业级的应用程序开发者都知道,企业里经常都要把用不同语言写成的、在不同平台上运行的各种程序集成起来,而这种集成将花费很大的开发力量。应用程序经常需要从运行的一台主机上的程序中获取数据;或者把数据发送到主机或其它平台应用程序中去。即使在同一个平台上,不同软件厂商生产的各种软件也常常需要集成起来。通过Web Service,应用程序可以用标准的方法把功能和数据"暴露"出来,供其它应用程序使用。

XML Web services 提供了在松耦合环境中使用标准协议(HTTP、XML、SOAP 和 WSDL)交换消息的能力。消息可以是结构化的、带类型的,也可以是松散定义的。

3、B2B的集成

B2B 指的是Business to Business,as in businesses doing business with other businesses,商家(泛指企业)对商家的电子商务,即企业与企业之间通过互联网进行产品、服务及信息的交换。通俗的说法是指进行电子商务交易的供需双方都是商家(或企业、公司),她们使用了Internet的技术或各种商务网络平台,完成商务交易的过程。

Web Service是B2B集成成功的关键。通过Web Service,公司可以只需把关键的商务应用"暴露"给指定的供应商和客户,就可以了,Web Service运行在Internet上,在世界任何地方都可轻易实现,其运行成本就相对较低。Web Service只是B2B集成的一个关键部分,还需要许多其它的部分才能实现集成。 用Web Service来实现B2B集成的最大好处在于可以轻易实现互操作性。只要把商务逻辑"暴露"出来,成为Web Service,就可以让任何指定的合作伙伴调用这些商务逻辑,而不管他们的系统在什么平台上运行,使用什么开发语言。这样就大大减少了花在B2B集成上的时间和成本。

4、软件和数据重用

Web Service在允许重用代码的同时,可以重用代码背后的数据。使用Web Service,再也不必像以前那样,要先从第三方购买、安装软件组件,再从应用程序中调用这些组件;只需要直接调用远端的Web Service就可以了。另一种软件重用的情况是,把好几个应用程序的功能集成起来,通过Web Service "暴露"出来,就可以非常容易地把所有这些功能都集成到你的门户站点中,为用户提供一个统一的、友好的界面。 可以在应用程序中使用第三方的Web Service 提供的功能,也可以把自己的应用程序功能通过Web Service 提供给别人。两种情况下,都可以重用代码和代码背后的数据。

从以上论述可以看出,Web Service 在通过Web进行互操作或远程调用的时候是最有用的。不过,也有一些情况,Web Service根本不能带来任何好处,Web Service有一下缺点:

1、 单机应用程序

目前,企业和个人还使用着很多桌面应用程序。其中一些只需要与本机上的其它程序通信。在这种情况下,最好就不要用Web Service,只要用本地的API就可以了。COM非常适合于在这种情况下工作,因为它既小又快。运行在同一台服务器上的服务器软件也是这样。当然Web Service 也能用在这些场合,但那样不仅消耗太大,而且不会带来任何好处。

2、 局域网的一些应用程序

在许多应用中,所有的程序都是在Windows平台下使用COM,都运行在同一个局域网上。在这些程序里,使用DCOM会比SOAP/HTTP有效得多。与此相类似,如果一个.net程序要连接到局域网上的另一个.net程序,应该使用.net Remoting。其实在.net Remoting中,也可以指定使用SOAP/HTTP来进行Web Service 调用。不过最好还是直接通过TCP进行RPC调用,那样会有效得多。

1.3、XML Web Service的应用

1.最初的 XML Web Service 通常是可以方便地并入应用程序的信息来源,如股票价格、天气预报、体育成绩等等。

2.以 XML Web Service 方式提供现有应用程序,可以构建新的、更强大的应用程序,并利用 XML Web Service 作为构造块。

例如,用户可以开发一个采购应用程序,以自动获取来自不同供应商的价格信息,从而使用户可以选择供应商,提交订单,然后跟踪货物的运输,直至收到货物。而供应商的应用程序除了在Web上提供服务外,还可以使用XML Web Service检查客户的信用、收取货款,并与货运公司办理货运手续。

二、Web Service开发

.net平台内建了对Web Service的支持,包括Web Service的构建和使用。与其它开发平台不同,使用.net平台,你不需要其他的工具或者SDK就可以完成Web Service的开发了。.net Framework本身就全面支持Web Service,包括服务器端的请求处理器和对客户端发送和接受SOAP消息的支持。下来我们就一步一步的用Microsoft Visual Studio .net 20058(后面简称VS.Net 2008)创建和使用一个简单的Web Service。

2.1、用创建一个最简单的Web Service

首先,打开VS2005,打开"文件-新建-网站",选择"ASP.NET Web服务"

 

查看Service.cs代码,你会发现VS.Net 2005已经为Web Service文件建立了缺省的框架。原始代码为:

view plaincopy to clipboardprint?
using System;   
using System.Linq;   
using System.Web;   
using System.Web.Services;   
using System.Web.Services.Protocols;   
using System.Xml.Linq;   
[WebService(Namespace = "http://tempuri.org/")]   
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]   
// 若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务,请取消对下行的注释。   
// [System.Web.Script.Services.ScriptService]   
public class Service : System.Web.Services.WebService   
{   
    public Service () {   
        //如果使用设计的组件,请取消注释以下行    
        //InitializeComponent();    
    }   
    [WebMethod]   
    public string HelloWorld()   
    {   
        return "Hello World";   
    }   
}  
using System;
using System.Linq;
using System.Web;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Xml.Linq;
[WebService(Namespace = "http://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
// 若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务,请取消对下行的注释。
// [System.Web.Script.Services.ScriptService]
public class Service : System.Web.Services.WebService
{
    public Service () {
        //如果使用设计的组件,请取消注释以下行 
        //InitializeComponent(); 
    }
    [WebMethod]
    public string HelloWorld()
    {
        return "Hello World";
    }
}

默认工程里面已经有一个Hello World的方法了,直接运行看看效果,

 

点击显示页面上图中的"HelloWorld"超链接,跳转到下一页面:

 

点击"调用"按钮,就可以看到用XML格式返回的Web Service结果下图。说明我们的Web Service环境没有问题,而且还初步接触了一下最简单的Web Service。

2.2、创建一个简单带有功能的Web Service

上面我们宏观的了解了webservice,其实它就是个对外的接口,里面有函数可供外部客户调用(注意:里面同样有客户不可调用的函数).假若我们是服务端,我们写好了个webservice,然后把它给了客户(同时我们给了他们调用规则),客户就可以在从服务端获取信息时处于一个相对透明的状态.即是客户不了解(也不需要)其过程,他们只获取数据.在代码文件里,如果我们写了一个函数后,希望此函数成为外部可调用的接口函数,我们必须在函数上面添上一行代码[WebMethod(Description="函数的描述信息")],如果你的函数没有这个申明,它将不能被用户引用.下来我们开始编写一个简单的Web Service 的例子。

先把默认的HelloWorld方法注释掉,简单的写了求加减乘除运算的四个方法;

view plaincopy to clipboardprint?
using System;   
using System.Linq;   
using System.Web;   
using System.Web.Services;   
using System.Web.Services.Protocols;   
using System.Xml.Linq;   
[WebService(Namespace = "http://tempuri.org/")]   
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]   
// 若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务,请取消对下行的注释。   
// [System.Web.Script.Services.ScriptService]   
public class Service : System.Web.Services.WebService   
{   
    public Service () {   
        //如果使用设计的组件,请取消注释以下行    
        //InitializeComponent();    
    }   
    //[WebMethod]   
    //public string HelloWorld()   
    //{   
    //    return "Hello World";   
    //}   
    [WebMethod(Description = "求和的方法")]   
    public double addition(double i, double j)   
    {   
        return i + j;   
    }   
    [WebMethod(Description = "求差的方法")]   
    public double subtract(double i, double j)   
    {   
        return i - j;   
    }   
    [WebMethod(Description = "求积的方法")]   
    public double multiplication(double i, double j)   
    {   
        return i * j;   
    }   
    [WebMethod(Description = "求商的方法")]   
    public double division(double i, double j)   
    {   
        if (j != 0)   
            return i / j;   
        else  
            return 0;   
    }   
}  
using System;
using System.Linq;
using System.Web;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.Xml.Linq;
[WebService(Namespace = "http://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
// 若要允许使用 ASP.NET AJAX 从脚本中调用此 Web 服务,请取消对下行的注释。
// [System.Web.Script.Services.ScriptService]
public class Service : System.Web.Services.WebService
{
    public Service () {
        //如果使用设计的组件,请取消注释以下行 
        //InitializeComponent(); 
    }
    //[WebMethod]
    //public string HelloWorld()
    //{
    //    return "Hello World";
    //}
    [WebMethod(Description = "求和的方法")]
    public double addition(double i, double j)
    {
        return i + j;
    }
    [WebMethod(Description = "求差的方法")]
    public double subtract(double i, double j)
    {
        return i - j;
    }
    [WebMethod(Description = "求积的方法")]
    public double multiplication(double i, double j)
    {
        return i * j;
    }
    [WebMethod(Description = "求商的方法")]
    public double division(double i, double j)
    {
        if (j != 0)
            return i / j;
        else
            return 0;
    }
}
 

运行可以看到我们自己写的可以被调用的方法,如下图:

 

同样点击addition方法,进入addition方法的调用页。

 

在参数上面输入参数i=3,j=3,如上图,点击调用,就可以看到用XML格式返回的Web Service结果(i与j相加的结果)下图

 到这里,我们会发现,其实webservice并不是那么的神秘,它也不过只是个接口,对我们而言,侧重点就是是接口函数的编写.

2.3、用ASP.NET调用Web Service
首先,打开VS2005,打开"文件-新建-网站",选择"ASP.NET网站"。

 

选好存储位置,语言后点击确定,进入默认页面。然后先添加Web引用,把WebService引到当前的工程里面。方法是:在资源管理器中点击右键,选择添加Web 引用,调出对话框:

 

在URL中填入,前面写好的WebService运行后浏览器上面显示的地址(即:WebService发布后的访问地址 ),点击"前往"按钮,如上图,就会显示出所引用的WebService中可以调用的方法,然后点击"添加引用",就将webservice引用到了当前的工程里面 ,如下图,解决方案中会出现引进来的WebService文件

 

我们在这就练习调用webservice的四个方法,做一个简单的调用的例子,先在网站的前台添加几个控件,代码如下:

view plaincopy to clipboardprint?
<%@ Page Language="C#" AutoEventWireup="true"  CodeFile="Default.aspx.cs" Inherits="_Default" %>   
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">   
<html xmlns="http://www.w3.org/1999/xhtml">   
<head runat="server">   
    <title>无标题页</title>   
</head>   
<body>   
    <form id="form1" runat="server">   
    <div>   
        <asp:TextBox ID="Num1" runat="server"></asp:TextBox>   
             <select id="selectOper" runat = "server">   
                 <option>+</option>   
                 <option>-</option>   
                 <option>*</option>   
                 <option>/</option>   
             </select>   
             <asp:TextBox ID="Num2" runat="server"></asp:TextBox>   
        <asp:Button ID="Button1" runat="server" Text="=" onclick="Button1_Click" />   
             <asp:TextBox ID="Result" runat="server"></asp:TextBox>   
    </div>   
    </form>   
</body>   
</html>  
<%@ Page Language="C#" AutoEventWireup="true"  CodeFile="Default.aspx.cs" Inherits="_Default" %>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
<head runat="server">
    <title>无标题页</title>
</head>
<body>
    <form id="form1" runat="server">
    <div>
        <asp:TextBox ID="Num1" runat="server"></asp:TextBox>
             <select id="selectOper" runat = "server">
                 <option>+</option>
                 <option>-</option>
                 <option>*</option>
                 <option>/</option>
             </select>
             <asp:TextBox ID="Num2" runat="server"></asp:TextBox>
        <asp:Button ID="Button1" runat="server" Text="=" onclick="Button1_Click" />
             <asp:TextBox ID="Result" runat="server"></asp:TextBox>
    </div>
    </form>
</body>
</html>
 

然后在后台写调用的代码,调用之前和使用其它的对象一样,要先实例化,实例化的方法是localhost.Service a = new localhost.Service();然后就可以通过a来访问WebService里面提供的方法了。在这个例子里面,动态的创建了一个button控件来触发WebService的调用,后台代码如下:
运行后可以看到效果,如下图所示,在前面两个Textbox里面输入两个操作数,在中间的下拉列表中选择操作符,然后点击"="号,将计算的结果输出到第三个Textbox里面。

 

而整个计算并不是在本地进行的,是在Web服务端进行计算的然后将结果通过XML返还给了调用方的,所以,在运行该程序的时候,WebService程序还必须启动,否则会报无法连接远程服务器的异常,如下图:

 

后台代码如下:

view plaincopy to clipboardprint?
using System;   
using System.Configuration;   
using System.Data;   
using System.Linq;   
using System.Web;   
using System.Web.Security;   
using System.Web.UI;   
using System.Web.UI.HtmlControls;   
using System.Web.UI.WebControls;   
using System.Web.UI.WebControls.WebParts;   
using System.Xml.Linq;   
public partial class _Default : System.Web.UI.Page    
{   
    protected void Page_Load(object sender, EventArgs e)   
    {   
    }   
    protected void Button1_Click(object sender, EventArgs e)   
    {   
        string selectFlag = selectOper.Value;   
        localhost.Service web = new localhost.Service();   
        if (selectFlag.Equals("+"))   
        {   
            Result.Text =(web.addition(double.Parse(Num1.Text),double.Parse(Num2.Text))).ToString();   
        }   
        else if (selectFlag.Equals("-"))   
        {   
            Result.Text = (web.subtract(double.Parse(Num1.Text), double.Parse(Num2.Text))).ToString();   
        }   
        else if (selectFlag.Equals("*"))   
        {   
            Result.Text = (web.multiplication(double.Parse(Num1.Text), double.Parse(Num2.Text))).ToString();   
        }   
        else if (selectFlag.Equals("/"))   
        {   
            Result.Text = (web.division(double.Parse(Num1.Text), double.Parse(Num2.Text))).ToString();   
        }   
    }   
}  
using System;
using System.Configuration;
using System.Data;
using System.Linq;
using System.Web;
using System.Web.Security;
using System.Web.UI;
using System.Web.UI.HtmlControls;
using System.Web.UI.WebControls;
using System.Web.UI.WebControls.WebParts;
using System.Xml.Linq;
public partial class _Default : System.Web.UI.Page 
{
    protected void Page_Load(object sender, EventArgs e)
    {
    }
    protected void Button1_Click(object sender, EventArgs e)
    {
        string selectFlag = selectOper.Value;
        localhost.Service web = new localhost.Service();
        if (selectFlag.Equals("+"))
        {
            Result.Text =(web.addition(double.Parse(Num1.Text),double.Parse(Num2.Text))).ToString();
        }
        else if (selectFlag.Equals("-"))
        {
            Result.Text = (web.subtract(double.Parse(Num1.Text), double.Parse(Num2.Text))).ToString();
        }
        else if (selectFlag.Equals("*"))
        {
            Result.Text = (web.multiplication(double.Parse(Num1.Text), double.Parse(Num2.Text))).ToString();
        }
        else if (selectFlag.Equals("/"))
        {
            Result.Text = (web.division(double.Parse(Num1.Text), double.Parse(Num2.Text))).ToString();
        }
    }
}
 

到此一个一个简单的WebService的开发和调用就已经完成了,在实际应用中可以根据自己的需要,写一些功能强大的,复杂的WebService,不管多么复杂,整个流程都是这样的。

原文地址:https://www.cnblogs.com/soundcode/p/3106508.html