当前位置: 主页 > Office办公 > 其他专区 > SharePoint > 如何编写自定义SharePoint Web Services

如何编写自定义SharePoint Web Services

  • 2021-09-18
  • 来源/作者: 菜鸟图库/ 菜鸟图库
  • 405 次浏览

我们可以基于WSS构建强大的项目。做为开发人员,我们有时需要创建基于WSS的自定义 Web服务来满足特定的开发要求。

注意:由于WSS增强的安全性,我们需要一些特殊的步骤来创建自定义Web服务。当我们使用VS.NET提供的ASP.NET Web service模板来创建我们的SharePoint Web service时,我们必须将Web service创建到单独的IIS网站中,而不能和WSS处于同一个IIS网站(不能使用相同的端口)。同时,我们还必须是运行WSS的机器上本地管理员组的成员。

下面列出了开发自定义SharePoint Web 服务的简要步骤:

1、如果我们的WSS位于默认网站(端口80),那么我们需要创建一个新的网站并配置不同的端口。新的网站作为开发用网站,而WSS所在的默认网站作为生产环境的部署网站。

2、在开发网站上创建一个Web Service项目

3、生成并修改静态发现(.disco)文件和 .wsdl文件,并保存成 .aspx页面。在页面内容顶部注册Microsoft.SharePoint命名空间。

4、修改.disco和.wsdl文件,使其支持服务虚拟化机制。

5、当我们开发完成Web service后,将相关的文件部署到WSS网站的_vti_bin和_vti_bin\bin虚拟目录下。

实例ODC_WritingCustomWebServicesSampleSPPT.EXE 提供了一个远程访问文档的Web服务示例。项目中实现了一些Microsoft.SharePoint命名空间中暴露出来的文档访问方法,如SPFile.CheckIn, SPFile.CheckOut, SPFile.UndoCheckOut, 和 SPFileCollection.Add。在没有这些自定义的Web service时,我们必须使用WebDAV或FrontPage RPC来实现类似的文档访问。

在WSS的服务器上安装该示例

  1. 下载ODC_WritingCustomWebServicesSampleSPPT.EXE并解压到WSS前端服务器的本地路径。Local_drive:\CreatingaCustomWebServiceSample
  2. 双击build.bat文件来执行编译和安装。

如下文件被拷贝到Local_drive:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\60\isapi\ 目录:

    • SPFiles.asmx
    • spfilesdisco.aspx
    • spfileswsdl.aspx

    如下文件被拷贝到Local_drive:\Program Files\Common Files\Microsoft Shared\Web Server Extensions\60\isapi\BIN\目录:

      • WSCheckOut.dll
      • WSCheckOut.pdb

      编写一个自定义Web服务

      1、 在开发用网站上使用VS.NET利用其提供的模板创建一个空的 ASP.Net Web Service项目,其中将包括一个Service1.asmx 文件。

      2、 进入代码编辑,移除下面的行的注释后编译该项目。

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

      3、 现在,我们可以将我们的服务部署到WSS网站中。

       要想将自定义的Web服务绑到WSS上,VS .NET需要一些特定的基于.disco和.wsdl文件的.aspx文件。首先使用VS .NET命令行工具生成我们需要的.disco和.wsdl文件。

      创建并编辑.disco和.wsdl文件

      使用VS .NET命令行工具在当前目录中生成Service1.disco 和 Service1.wsdl,命令如下:

      Disco http://server_name:New_Port/Project_Name/Service_1.asmx

      打开Service1.disco文件并定位到下面的行:

      <?xml version="1.0" encoding="utf-8"?>

      将其替换成:

       

      <%@ Page Language="C#" Inherits="System.Web.UI.Page"%> <%@ Assembly Name="Microsoft.SharePoint, Microsoft.SharePoint, Version=11.0.0.0, Culture=neutral, PublicKeyToken=71e9bce111e9429c" %> <%@ Import Namespace="Microsoft.SharePoint.Utilities" %> <%@ Import Namespace="Microsoft.SharePoint" %>
      <% Response.ContentType = "text/xml"; %>

      以 Service1disco.aspx保存该文件。

      对Service1.wsdl也进行同样的修改并保存为Service1wsdl.aspx。

      修改 Service1disco.aspx和Service1wsdl.aspx使其支持服务虚拟化机制

      打开Service1disco.aspx文件并定位到下面的行:

       

      如何编写自定义SharePoint Web Services<contractRef  ref="http://server_name:New_Port/Project_Name/Service1.asmx?wsdl" docRef=
      如何编写自定义SharePoint Web Services"http://server_name:New_Port/Project_Name/Service1.asmx" xmlns="http://schemas.xmlsoap.org/disco/scl/" />

      对标签<contractRef>进行如下修改:

       

      如何编写自定义SharePoint Web Services<contractRef ref=<% SPEncode.WriteHtmlEncodeWithQuote(Response, SPWeb.OriginalBaseUrl(Request)
      如何编写自定义SharePoint Web Services + "?wsdl", '"'); %> docRef=<% SPEncode.WriteHtmlEncodeWithQuote(Response,
      如何编写自定义SharePoint Web Services SPWeb.OriginalBaseUrl(Request), '"'); %>  xmlns="http://schemas.xmlsoap.org/disco/scl/" />

      定位到下面的行:

       

      如何编写自定义SharePoint Web Services<soap address="http://server_name:New_Port/Project_Name/Service1.asmx" xmlns:q1="http://tempuri.org/" binding="q1:Service1Soap" xmlns="http://schemas.xmlsoap.org/disco/soap/" />

      修改<soap address> 标签为:

      如何编写自定义SharePoint Web Services<soap address=<% SPEncode.WriteHtmlEncodeWithQuote(Response, SPWeb.OriginalBaseUrl(Request), '"'); %> xmlns:q1="http://tempuri.org/" binding="q1:Service1Soap" xmlns="http://schemas.xmlsoap.org/disco/soap/" />

       

      保存所有更改。

      打开Service1wsdl.aspx文件并定位到下面的行:

      如何编写自定义SharePoint Web Services<soap:address location="http://server_name:New_Port/Project_Name/Service1.asmx" />

      修改soap:address行为:

      如何编写自定义SharePoint Web Services<soap:address location=<% SPEncode.WriteHtmlEncodeWithQuote(Response,
      如何编写自定义SharePoint Web Services SPWeb.OriginalBaseUrl(Request), '"'); %> />

      保存所有更改。

      将Web service相关文件拷贝到_vti_bin虚拟目录

      拷贝Service1wsdl.aspx,Service1disco.aspx和Service1.asmx到_vti_bin虚拟目录。该目录是默认的Web服务存放目录。

      拷贝对应的.dll文件到_vti_bin/bin虚拟目录。

      注意:_vti_bin/bin虚拟目录映射到物理路径\\Server_Name\Program Files\Common Files\Microsoft Shared\Web Server Extensions\ISAPI\bin

      下面,我们要将我们的Web服务添加到WSS的Web服务列表中,这样就可以在VS.NET中添加该Web服务的引用了。