(转http://tech.ddvip.com/2008-10/122527111786701.html,更详细见msdn:http://msdn.microsoft.com/zh-cn/library/ms464040.aspx)
MOSS中已经提供的webservice都放在虚拟目录_vti_bin中,对应的物理目录为c:Program FilesCommon FilesMicrosoft SharedWeb Server Extensions12ISAPI。可能你会觉得这个目录_vti_bin名有点怪,这个名字来自该公司Vermeer Technologies Incorporated。这个公司唯一的产品就是FrontPage,该公司在1996年被微软收购。
下面我们就自己实现一个webservice,需要以下几步:
一:建立Webservice项目
1.使用vs2005建立一个webserivce项目来实现我们的webservice,然后我在填加一个类库用于实现webservice的逻辑部分。项目结构如下图:
为MOSSLibrary2类库签名,项目“右键---属性---签名---为程序集签名",不使用密码。Service.cs是现实Webservice逻辑的地方,代码如下:
using System;
using System.Web;
using System.Web.Services;
using System.Web.Services.Protocols;
using Microsoft.SharePoint;
using Microsoft.SharePoint.Utilities;
[WebService(Namespace = "http://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
public class Service : System.Web.Services.WebService
{
public Service ()
{ }
[WebMethod]
public string HelloWorld()
{
return "Hello World";
}
[WebMethod]
public string GetSiteListCount()
{
SPWeb myWeb=SPContext.Current.Web;
SPListCollection lists=myWeb.Lists;
return (myWeb.Title + " contains " + lists.Count.ToString() + " Web sites.");
}
}
二:将MOSSLibrary2类库添加到GAC中 (如果放在bin下就省略以下操作)
有两种方法:
1. 将bin目录下的MOSSLibrary2.dll拖到%windows%assembly文件夹下即可。
2. 打开VS2005的命令行工具,用GACUI.exe工具,命令如下:
gacutil.exe -iF "<Full file system path to DLL>".
三:修改service.asmx文件
<%@ WebService Language="C#" Class="MyServiceClass, MyServiceAssembly, Version=1.0.0.0,
Culture=neutral, PublicKeyToken=8f2dca3c0f2d0131" %>
其中的相关信息可以到%windows%assembly文件夹下找到MOSSLibrary2.dll,右键查看其属性获得,该修改主要指定service.asmx的逻辑文件使用的是MOSSLibrary2项目中的service.cs中的代码。
四:生成静态发现文件service.disco和Webservice的描述文件service.wsdl
1.将service.asmx拷贝到c:Program FilesCommon FilesMicrosoft SharedWeb Server Extensions12templatelayouts目录下,然后打开VS2005的命令行工具,使用如下命令:
disco http://carysun/_layouts/Service.asmx
完成后会生成service.disco和service.wsdl文件
2.将service.disco和service.wsdl文件中的<?xml version="1.0" encoding="utf-8"?>该语句替换为以下语句: (这些语句在isapi目录下的页面也可以找到)
<%@ Page Language="C#" Inherits="System.Web.UI.Page" %>
<%@ Assembly Name="Microsoft.SharePoint, Version=12.0.0.0, Culture=neutral,
PublicKeyToken=71e9bce111e9429c" %>
<%@ Import Namespace="Microsoft.SharePoint.Utilities" %>
<%@ Import Namespace="Microsoft.SharePoint" %>
<% Response.ContentType = "text/xml"; %>
实际上就是把原来的纯xml变换成为一个page来解析。并且这个页面的解析是通过moss处理的。
3.将service.disco中的
<contractRef ref=http://carysun/_layouts/service.asmx?wsdl
docRef="http://carysun/_layouts/service.asmx" xmlns="http://schemas.xmlsoap.org/disco/scl/" />
<soap address="http://carysun/_layouts/service.asmx" xmlns:q1=http://tempuri.org/
binding="q1:ServiceSoap" xmlns="http://schemas.xmlsoap.org/disco/soap/" />
<soap address="http://carysun/_layouts/service.asmx" xmlns:q2=http://tempuri.org/
binding="q2:ServiceSoap12" xmlns="http://schemas.xmlsoap.org/disco/soap/" />
替换为:
<contractRef ref=<% SPHttpUtility.AddQuote(SPHttpUtility.HtmlEncode(SPWeb.OriginalBaseUrl
4.将service.wsdl中的
(Request) + "?wsdl"),Response.Output); %>
docRef=<% SPHttpUtility.AddQuote(SPHttpUtility.HtmlEncode(SPWeb.OriginalBaseUrl(Request)),
Response.Output); %> xmlns="http://schemas.xmlsoap.org/disco/scl/" />
<soap address=<% SPHttpUtility.AddQuote(SPHttpUtility.HtmlEncode(SPWeb.OriginalBaseUrl(Request)),
Response.Output); %> xmlns:q1="http://tempuri.org/" binding="q1:HelloWorld"
xmlns="http://schemas.xmlsoap.org/disco/soap/" />
<soap address=<% SPHttpUtility.AddQuote(SPHttpUtility.HtmlEncode(SPWeb.OriginalBaseUrl(Request)),
Response.Output); %> xmlns:q2="http://tempuri.org/" binding="q2:ServiceSoap12"
xmlns="http://schemas.xmlsoap.org/disco/soap/" />
<soap:address location="http://carysun/_layouts/service.asmx" />和
<soap12:address location="http://carysun/_layouts/service.asmx" />
替换为:
<soap:address location=<% SPHttpUtility.AddQuote(SPHttpUtility.HtmlEncode(SPWeb.OriginalBaseUrl
(Request)),Response.Output); %> />
和<soap12:address location=<%SPHttpUtility.AddQuote(SPHttpUtility.HtmlEncode(SPWeb.OriginalBaseUrl
(Request)),Response.Output); %> />
对于contractRef 还有soap address这两个节的更改,实际上是在页面里面重新编码了soap的查询url,这样做的目的也
是为了moss托管的web service可以在运行时根据动态的请求来正确定位。
5.将service.disco和service.wsdl改名为servicedisco.aspx和servicewsdl.aspx
五:部署webservice
将servicedisco.aspx,servicewsdl.aspx和service.asmx三个文件拷贝到c:Program FilesCommon FilesMicrosoft SharedWeb Server Extensions12ISAPI目录中,然后我们就可以通过以下地址来检测我们部署是否成功了。http://carysun/_vti_bin/Service.asmx.
如下图:
六:客户端调用 (在最后面我调用服务操作列表库时出现一个“请求因 HTTP 状态 401 失败:Unauthorized”的错误,那是因为IIS没启匿名访问)
我们建立一个web站点,添加该webservice的应用,然后在按钮的单击事件添加如下代码:
carysun.Service se= new WindowsApplication1.carysun.Service();
se.UseDefaultCredentials = true;
MessageBox.Show(se.GetSiteListCount());
se.UseDefaultCredentials = true;这句代码是设置信任的,否则会报没有权限的错误。