SharePoint Web Service系列：编写自定义SharePoint Web Services之一
原文地址：http://msdn.microsoft.com/library/default.asp?url=/library/en-us/odc_sp2003_ta/html/odc_writingcustomwebservicesforsppt.asp
摘要： 学习创建自定义SharePoint Web services ,并建立基于SharePoint 的文档上载Web servicefor用来实现外部应用程序远程访问文档库中的文档。
代码下载： ODC_WritingCustomWebServicesSampleSPPT.EXE.
我们可以基于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的服务器上安装该示例
- 下载ODC_WritingCustomWebServicesSampleSPPT.EXE并解压到WSS前端服务器的本地路径。Local_drive:\CreatingaCustomWebServiceSample
- 双击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、进入代码编辑，移除下面的行的注释后编译该项目。现在，我们可以将我们的服务部署到WSS网站中。
// publicstringHelloWorld()
// {
// return"HelloWorld";
// }
3、
要想将自定义的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文件并定位到下面的行：
将其替换成:
< %Response .ContentType ="text/xml" ;% >
以 Service1disco.aspx保存该文件。
对Service1.wsdl也进行同样的修改并保存为Service1wsdl.aspx。
修改 Service1disco.aspx和Service1wsdl.aspx使其支持服务虚拟化机制
打开Service1disco.aspx文件并定位到下面的行：
<
contractRef
ref
="http://server_name:New_Port/Project_Name/Service1.asmx?wsdl"
docRef
="http://server_name:New_Port/Project_Name/Service1.asmx"
xmlns
="http://schemas.xmlsoap.org/disco/scl/"
/>
对标签<contractRef>进行如下修改:
<
contractRef
ref
=<%
SPEncode.WriteHtmlEncodeWithQuote(Response,SPWeb.OriginalBaseUrl(Request)+"?wsdl",'"');%
>
docRef=
<
%SPEncode
.WriteHtmlEncodeWithQuote(Response,SPWeb.OriginalBaseUrl(Request),'"');%
>
xmlns="http://schemas.xmlsoap.org/disco/scl/"/>
定位到下面的行：
<
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> 标签为：
<
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文件并定位到下面的行：
<
soap:address
location
="http://server_name:New_Port/Project_Name/Service1.asmx"
/>
修改soap:address行为：
<
soap:address
location
=<%
SPEncode.WriteHtmlEncodeWithQuote(Response,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