开发部署Sharepoint自定义webservice

142536a

　　    Sharepoint内置了很多开箱即用的webservice，其物理路径位于%ProgramFiles%\Common Files\Microsoft Shared\Web Server Extensions\14\ISAPI目录下，关于这些Webservice的应用，可以参考MSDNhttp://msdn.microsoft.com/zh-cn/library/ee705814.aspx。然而，如果内置的Webservice无法满足需求，那就得自己动手开发Webservice了。  
　　     在.NET中，有两套支持SOAP的Webservice实现，一套是较经典的ASP.NET Webservice，另一套则是较晚推出的WCF（关于两者的区别，不在本文讨论范围内，暂且不提），虽然微软推荐在所有用到webservice的地方都使用WCF，但是直到Sharepoint 2010版本才支持WCF，如果希望能够兼容2007版本，那么ASP.NET Webservice仍然是唯一的选择。这里主要介绍怎么开发部署ASP.NET Webservice。  
　　      开发ASP.NET Webservice：这里的Webservice的开发与普通Webservice没有区别，需要用到Sharepoint服务器端对象模型的地方只要添加相应的程序集引用就可以了。需要注意的是，生成的程序集必须是带签名的强命名程序集，因为稍后此程序集会被部署到全局程序集缓存（GAC）中。  
　　    部署ASP.NET Webservice: 普通Webservice的部署只要把程序集拷贝到bin目录，然后把asmx文件拷贝到站点目录下就可以了，站点内的文件路径即Webservice的访问url，十分简单；但是到了Sharepoint里面，情况就变得有点复杂了。首先，Sharepoint的站点资源是多个站点共享的，不存在私有的bin目录，所以WebService生成的程序集必须被部署到全局程序集缓存（GAC）中，当然强名称是必须的了。其次，由于WebService的访问路径的动态的，所以Sharepoint不能为Webservice生成正确的静态wsdl文件，所以就需要让Sharepoint能够动态的生成wsdl文件(包括disco文件)。详细的操作步骤可以参考MSDN的帮助文档：  
　　演练：创建自定义 ASP.NET Web 服务  
　　http://msdn.microsoft.com/zh-cn/library/ms464040(v=office.14).aspx  
　　    主要的操作步骤包括：  
　　1. 把ASP.NET Webservice的程序集部署到GAC中  
　　2. 把ASP.NET Webservice的asmx文件拷贝到%ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\LAYOUTS目录  
　　3. 通过disco命令，生成.wsdl文件和.disco文件  
　　4. 修改.wsdl和.disco，把这两个文件转换为xxxwsdl.aspx和xxxdisco.aspx, 这里需要手动修改，容易出错。  
　　5. 把xxx.asmx, xxxwsdl.aspx和xxxdisco.aspx一起拷贝部署到%ProgramFiles%\Common Files\Microsoft Shared\Web Server Extensions\14\ISAPI目录下。  
　　     这里有几点需要注意的地方：  
　　1. Sharepoint2010缺省关闭了ASP.NET Webservice的访问支持，在访问以前需要把asmx文件类型的阻塞过滤删掉。操作方法Central Administration→Security→Define blocked file types→删除asmx文件类型→保存。  
　　2. 把wsdl文件和disco文件转换为aspx文件需要手动修改，容易出错，这里介绍一个自动修改工具，可以自动完成此步骤，项目地址在http://www.codeproject.com/Articles/10728/WSS-Web-Service-DISCO-and-WSDL-Generator-Helper，比较老的项目了，不过可以使用。