janneyabc 发表于 2015-9-26 11:37:49

JQuey 调用SharePoint 2010 WCF服务

  本文主要解释如何通过JQuery来调用WCF服务。本文分为两个部分,第一部分:如何在SharePoint 2010 平台上开发WCF服务,第二部分:通过JQuery调用WCF服务。

  在WSS3.0和MOSS2007中,我们可以通过Asp.NET Web 服务来操作SharePoint,在SharePoint 2010 中,我们依然可以通过Asp.NET Web 服务来操作SharePoint, 更为重要的是SharePoint 2010 是基于.Net 3.5框架之上,因此我们也可以通过WCF web 服务来操作SharePoint。

  那么我们如何选择呢?到底是选择ASP.NET web
service 还是WCF web service呢?

首先我们来了解下他们的优缺点:

  ASP .NET web 服务:
  开发简单,部署比较费事,你需要添加.WSDL和.DISCO文件才能使web服务的架构被Microsoft Visual Studio发现。

  WCF web服务:
  看起来更复杂,你需要指定WCF服务端点的完整配置,包括端点地址,服务协议,绑定设置等。但是WCF服务提供了更灵活,强大的绑定,并且通过SharePoint 承载WCF web 服务,降低了配置要求,因为SharePoint 2010 已经默认支持WCF服务,比如SharePoint 2010 中自带的提供的REST接口 List.svc等。
如何来开发SharePoint 2010 的WCF web 服务呢?首先我们来了解一下SharePoint 2010 WCF的动态配置。

  WCF的动态配置
SharePoint 2010 中的WCF动态配置以自定义工厂的形式提供,因此当开发WCF服务时,必须指定SharePoint
2010 提供的工厂,指定之后,就不需要在Web.Config中配置各种参数。这样运行时SharePoint服务工厂会自动为你的服务配置适当的端点。

下表列出了服务类型和已知的服务工厂







服务类型



服务工厂



说明




  SOAP 服务


  MultipleBaseAddressBasicHttpBindingServiceHostFactory


  必须使用基本 HTTP 绑定,其根据基本 HTTP 绑定为服务创建端点。




  REST 服务


  MultipleBaseAddressWebServiceHostFactory


  服务工厂通过 Web 绑定创建端点。




  ADO.NET 数据服务


  MultipleBaseAddressDataServiceHostFactory



可使用的数据服务宿主工厂。






  创建WCF服务 (我们选用其中一种服务工厂来做实例)
  下面我们通过一个实例来具体了解下如何创建WCF服务。


[*]打开VS2010,新建一个空的SharePoint 解决方案,
[*]添加需要的动态链接库的引用,由于我们用到了WCF,因此我们需要添加System.ServiceModel的引用,此外我们需要制定WCF服务的服务工厂,因此我们还需要添加Microsoft.SharePoint.Client.Runtime的引用这个需要从Assembly文件夹内添加(C:\Windows\assembly\GAC_MSIL\Microsoft.SharePoint.Client.ServerRuntime\14.0.0.0__71e9bce111e9429c)。
  



[*]添加一个Mapping 文件夹,mapping到SharePoint的ISAPI,并在ISAPI文件下创建一个新的文件夹SPLover.WCF (要养成良好的编程习惯,要为自己开发的东西创建一个单独的文件夹以区分哪些是系统的,哪些是自定制的文件)。
[*]在新建文件夹下创建一个Text文件,把后缀改为SVC,本实例用的是WCFDemo.SVC。
[*]在新建文件下下添加个WCF服务,



[*]至此,我们已完成了所有的准备工作,接下来就是为WCF服务指定服务工厂和添加代码。

[*]打开Iservice1.cs,把Void方法改为传回字符串,并添加了WebGet属性。代码如下

  




      
      string DoWork();



[*]打开Service1.cs,同样把Void方法改为传回字符串,最重要的是为当前类添加必要的属性。
        




   
   
    public class Service1 : IService1
    {
      public string DoWork()
      {
            return "works!";
      }
    }
  9. 打开SVC文件添加Service assembly信息并制定服务工厂
  



<% @ ServiceHost Language="C#"
Debug="true"
Factory="Microsoft.SharePoint.Client.Services.MultipleBaseAddressWebServiceHostFactory, Microsoft.SharePoint.Client.ServerRuntime, Version=14.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c"
Service="SPWCFAndJQuery.ISAPI.SPLover.WCF.Service1, $SharePoint.Project.AssemblyFullName$"%>
  
  10. 打包部署。

测试


[*]通过Http://ServerName:port/_vti_bin/SPLover.WCF/WCFDemo.svc/,如果你得到以下错误,请不要惊慌,



[*]请尝试使用Http://ServerName:port/_vti_bin/SPLover.WCF/WCFDemo.svc/dowork进行访问。如果能返回“works!”就证明我们的WCF服务已经成功了。




下一篇写一下如何通过JQuery调用WCF web 服务。
页: [1]
查看完整版本: JQuey 调用SharePoint 2010 WCF服务