基础拾遗------webservice详解

前言

　　工作当中常用的服务接口有三个wcf,webservice和webapi.首先第一个接触的就是webservice,今天大致总结一下。

1.webservice概念相关

1.1.Web Service也叫XML Web Service WebService

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

1.2.XML：(Extensible Markup Language)扩展型可标记语言。

　　面向短期的临时数据处理、面向万维网络，是Soap的基础。它被设计的宗旨是描述数据（XML），而非显示数据（HTML）。后面单独博客进行详细介绍。

1.3.Soap：(Simple Object Access Protocol)简单对象存取协议。

　　是XML Web Service 的通信协议。其指导理念是“唯一一个没有发明任何新技术的技术”。当用户通过UDDI找到你的WSDL描述文档后，他通过可以SOAP调用你建立的Web服务中的一个或多个操作。SOAP是XML文档形式的 调用方法的规范，它可以支持不同的底层接口，像HTTP(S)或者SMTP。

<?xml version="1.0"?>
<soap:Envelope
xmlns:soap="http://www.w3.org/2001/12/soap-envelope"
soap:encodingStyle="http://www.w3.org/2001/12/soap-encoding">
 
<soap:Header>
  <m:Trans xmlns:m="http://www.w3schools.com/transaction/"
  soap:mustUnderstand="1">234
  </m:Trans>
</soap:Header>
 
 
<soap:Body>
  <m:GetPrice xmlns:m="http://www.w3schools.com/prices">
    <m:Item>Apples</m:Item>
  </m:GetPrice>
</soap:Body>
</soap:Envelope>

 

1.4.WSDL：(Web Services Description Language) Web服务描述语言

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

  • Types - 数据类型定义的容器，它使用某种类型系统(一般地使用XML Schema中的类型系统)。
  • Message - 通信消息的数据结构的抽象类型化定义。使用Types所定义的类型来定义整个消息的数据结构。
  • Operation - 对服务中所支持的操作的抽象描述，一般单个Operation描述了一个访问入口的请求/响应消息对。
  • PortType - 对于某个访问入口点类型所支持的操作的抽象集合，这些操作可以由一个或多个服务访问点来支持。
  • Binding - 特定端口类型的具体协议和数据格式规范的绑定。
  • Port - 定义为协议/数据格式绑定与具体Web访问地址组合的单个服务访问点。
  • Service- 相关服务访问点的集合。WSDL文档元素的结构图

  • WSDL 描述了 Web服务的三个基本属性：

    （1）服务所提供的操作

    （2）如何访问服务

    （3）服务位于何处（通过 URL 来确定就 OK 了）

1.5.UDDI (Universal Description, Discovery, and Integration)

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

2. .net webservice

　　上面的理论知识就算您不清楚，想要使用webservice还是没有任何难度的，不信您往下看。

2.1.创建webservice(vs2013)

　　2.1.1.新建一个webservice项目(文件->新建->项目->C#->Web服务应用程序)

　　建完这个工程,我们将看到一个叫ServiceDome.asmx的文件,就先常见webfrom一样它类似与aspx,我们直接打开cs代码文件即可，asmx文件至今没考虑过他有什么用.如果你什么都还没做的话,将看见一个被注释掉的helloworld的WebMethod,把注释去掉,在运行,你就可以得 到最简单的webservice运行实例了.点击"helloworld"将执行其方法.显然,这个函数对我们的意义只在于宏观的了解了下web服务的写 法.

　　2.1.2.WebMethodAttribute详解

[WebMethod(Description="备注信息")]   
  public string HelloWorld()   
  {   
   return "Hello World";   
  }

　　如上，WebMethodAttribute此特性是表示可以从远程 Web 客户端调用该方法。

　　其中WebMethod包括以下6个属性

　　(1)Description: 

　　　　是对webservice方法描述的信息。就像webservice方法的功能注释，可以让调用者看见的注释。

　　(2).EnableSession:

　　　　指示webservice否启动session标志，主要通过cookie完成的，默认false。

 

public static int i=0;
[WebMethod(EnableSession=true)]
public int Count()
{
i=i+1;

return i;
}

　　如上Count()回和保存的session类似把信息保留下来。

　　(3)MessageName:

　　　　主要实现方法重载后的重命名.

[WebMethod]
public int Add(int i, int j) {
return i + j;
}
[WebMethod(MessageName="Add2")]
public int Add(int i, int j, int k) {
return i + j + k;
}
}

　　(4).TransactionOption:

　　　　指示 XML Web services 方法的事务支持。

　　(5).CacheDuration:

　　　　Web支持输出高速缓存，这样webservice就不需要执行多遍，可以提高访问效率，而CacheDuration就是指定缓存时间的属性。

public static int i=0;
[WebMethod(EnableSession=true,CacheDuration=30)]
public int Count()
{
i=i+1;
return i;
}

　　(6).BufferResponse:

　　　　配置WebService方法是否等到响应被完全缓冲完，才发送信息给请求端。普通应用要等完全被缓冲完才被发送的！只有当已知 XML Web services 方法将大量数据返回到客户端时，才需要将 BufferResponse 设置为 false。对于少量数据，将 BufferResponse 设置为 true 可提高 XML Web services 的性能。当 BufferResponse 为 false 时，将对 XML Web services 方法禁用 SOAP 扩展名。

2.2.实现webservice

　　特性说完就要说我们的webserviece服务接口的实现了，其实对于他的实现和我们实现一个类没有太大的区别。、

        [WebMethod]
        public string SynCardToDreams(int start, int end)
        {
            try
            {
                DateTime begin = DateTime.Now;
                UserSignService userService = new UserSignService();
                bool ret = userService.SynChroCardToDreams(start, end);
                DateTime endTime = DateTime.Now;
                double total = (endTime - begin).TotalMinutes;
                string retmsg = ret ? "同步成功" : "同步失败";
                return "本次同步用时 " + total + "分钟；" + retmsg;

            }
            catch (Exception ex)
            {
                return "同步失败：" + ex.ToString();
            }

        }

2.3.调用webservice

在要使用服务的项目处右击添加服务引用

然后在程序当中直接实例化调用此方法即可：

　　//调用方法
    TestServiceReference.TestServiceSoapClient testService = new TestServiceReference.TestServiceSoapClient();
    int result = testService.Add(1, 2);

前端调用

<script type="text/javascript">
    $(function () {
        $.ajax({
            type: 'POST',
            url: 'TestService.asmx/ADD',
            data: '{ A: 4,B:4}',
            dataType: 'json',
            contentType: "application/json",
            success: function (data) {
                alert(data.d);
            }
        });
    });
</script>

 3.修改webservice服务地址：

3.1修改配置文件

<?xml version="1.0" encoding="utf-8" ?>  
<configuration>  
    <configSections>  
    </configSections>  
    <system.serviceModel>  
        <bindings>  
            <basicHttpBinding>  
                <binding name="PointStoreServiceSoap" />  
            </basicHttpBinding>  
        </bindings>  
        <client>  
            <endpoint address="http://localhost:25548/WebServiceDom.asmx"  
                binding="basicHttpBinding" bindingConfiguration="PointStoreServiceSoap"  
                contract="PointStoreService.PointStoreServiceSoap" name="PointStoreServiceSoap" />  
        </client>  
    </system.serviceModel>  
</configuration>
posted @ 2016-09-08 13:34  王延领  阅读(2436)  评论(2)  编辑  收藏  举报