开发部署Sharepoint自定义webservice

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,比较老的项目了,不过可以使用。

你可能感兴趣的:(webservice)