学会使用Web Service上（服务器端访问）

关于什么是Web Service，相信在很多地方都会有介绍。简单的讲，Web Service就是为Web应用程序之间彼此共享资源提供了一种可能。采取的方式是将相应的类及其中的方法暴露出来，然后调用者就可以直接调用这些类中的方法，达到访问远程资源的目的。本文只是想告诉，如果去使用Web Service。我主要从服务器端访问Web Service、客户端访问Web Service两方面来介绍。如果你还不会使用Web Service，希望对你有所帮助。

一、服务器端访问Web Service

这也是Web Service最适宜的调用环境。我们只需知道一个远程Web Service的URL，然后我们就可以直接使用Wsdl工具或更方便的添加Web 引用的方法，将远程Web Service（指.asmx文件）中对应类生成一个强类型的本地化代理。通过这个代理，我们就可以像使用本地方法一样，去调用这个远程类中的方法。使用的过程是非常的简单。下面让我们看看具体的操作。

1、新建一个Web Service



选择asp.net Web服务模板，然后你会看到VS已经自动为我们生成了一个Web Service的示例代码。


复制

保存

using[/b] System;
using[/b] System.Web;
using[/b] System.Web.Services;
using[/b] System.Web.Services.Protocols;
[WebService(Namespace = "http://tempuri.org/")]
[/b][WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
public[/b] class[/b] Service : System.Web.Services.WebService
{
public[/b] Service()
{
//如果使用设计的组件，请取消注释以下行
[/b]        //InitializeComponent();
[/b]    }
[WebMethod]
public[/b] string[/b] HelloWorld()
{
return[/b] "Hello World"[/b];
}
}

一个Web Service的主要部分VS已经帮我们写好了。这里有几个地方，我大概说一下。[WebService(Namespace = http://tempuri.org/)]特性部分，它声明了Web Service所对应的XMl文件的命名空间，如果你直接浏览Web Service文件，它会出现在XML文件的命名空间声明中。还是建议修改一下Namespace，虽然它只是一个URI。比如你可以把它改为Namespace=http://ruihua.cnblogs.com/。[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]特性声称的是本Web Service所应符合的Web服务互操作性规范，一般情况下我们无需考虑这个，只有某些操作与这个规范不相符的时候，我们就需要修改ConformsTo = WsiProfiles.None。（比如BasicProfile1_1规范并不支持方法的重载，如果你有重载方法的话，就需要修改它。）需要特别说明的是，通常一个web Service文件对应的只有一个类，当然并不是说你不可以在一个.asmx文件中写多个类，但只有与WebService指令中的className值对应的那个类才会被公开。而对于类中的方法，我们必须显式加上[WebMthod]特性，才能被公开，这点与类不同。让我们看一下WebMethod特性的一些其它属性：

属性	功能	示例
BufferResponse	设置为True时，XML Web服务的响应就保存在内存中，并发送为一个完整的包。如果该属性设置为False，则响应在服务器上构造的同时，会发送给客户机。	[WebMethod(BufferResponse=true)]
CacheDuration	指定响应在系统的高速缓存中的保存时间（秒），默认值为0，表示禁用高速缓存。把XML Web服务的响应放在高速缓存中，会提高Web服务的性能。	[WebMethod(BufferResponse=true,CacheDuration=30)]
Description	对在XML Web服务的测试页面上显示的Web Method应用文本的描述。	[WebMethod(Description="该方法用于获取一个简单的字符串")]
EnableSession	设置为True时，会激活Web Method的会话状态，其默认值为False。	[WebMethod(EnableSession=true)]
MessageName	给Method指定一个唯一的名称，如果要使用重载的Web Method，则必须指定。	[WebMethod(MessageName="Method1")]
TransactionOption	为Web Method指定事务的支持，其默认值为Disbled。如果Web Method是启动事务的根对象，Web服务就可以用另一个需要事务处理的WebMethod参与事务处理。其值可以是NotSupported、Supported、Required和RequiresNew。	[WebMethod(TransactionOption=System.EnterpriseServices.TransactionOption.Supported)]

我们修改一下上述代码。


复制

保存

using[/b] System;
using[/b] System.Web;
using[/b] System.Web.Services;
using[/b] System.Web.Services.Protocols;
[WebService(Namespace = "http://tempuri.org/")]
[/b][WebServiceBinding(ConformsTo = WsiProfiles.None)]
public[/b] class[/b] Service : System.Web.Services.WebService
{
public[/b] Service()
{
}
[WebMethod]
public[/b] string[/b] Hello(string[/b] name)
{
return[/b] string[/b].Format("Hello,{0}!Current Time is :{1}"[/b], name, DateTime.Now.ToString());
}
}

程序很简单，传进去一个姓名，返回一串提供信息，下面我们来看一下如何使用这个Web Service.

2、访问Web Service

首先需要说明一下，为何我们能够在本地服务器上访问到远程服务器的Web Service？无论是使用添加Web引用的方式还是使用Wsdl工具，最终的结果都是生成了一个远程Web Service中类的强类型化本地代理。然后我们是通过这个代理来实现访问远程资源访问的。下面我们看看怎么通过这两种方式来实现。

首先我们新建一个新的Web应用程序

方式一：使用添加Web 引用。在解决方案资源管理器中单击右键，选择添加Web 引用...，如下所示：



在URL部分你可以直接输入远程Web Service的URL，当然如果引用的Web Service来自本地，你可以单击相应的链接，然后进行选择。在Web引用名中，填入你自定义的名称。注意，这个名称就代指Web Service的命名空间。在访问的时候，我们必须通过这个名称才能引用到Web Service中的类。填好后，单击添加引用即可。



为了保证本地测试方便，请将Web Service所在网站设为Web 共享，这样我们就不必考虑在Web引用中加入端口号才能访问的问题。添加Web引用对话框中查找的实际是WSDL文件，Microsoft的XML Web服务会根据.asmx文件自动生成wdsl文件。当然，我们也可以根据.asmx文件在浏览器中打开wsdl文件，按如下路径：
http://localhost/WebService/Service.asmx?wsdl
接下来，你会看到VS已经为我们添加好了Web 引用。



同时在Web.Config文件中也包含了对Web服务的引用，如下所示：


复制

保存

<[/b]appSettings[/b]>[/b]
<[/b]add[/b] key=[/b]"ServiceNamespace.Service"[/b] value=[/b]"http://localhost/WebService/Service.asmx"[/b]/>[/b]
</[/b]appSettings[/b]>[/b]

<appSettings>
<add key="ServiceNamespace.Service" value="http://localhost/WebService/Service.asmx"/>
</appSettings>
接下来，让我们看一下如何使用这个Web Service,请看代码：


复制

保存

public[/b] partial[/b] class[/b] _Default : System.Web.UI.Page
{
protected[/b] void[/b] Page_Load(object[/b] sender, EventArgs e)
{
ServiceNamespace.Service ws = new[/b] ServiceNamespace.Service();
Response.Write(ws.Hello("Ruihua"[/b]));
}
}

你会看到，使用远程方法就像使用本地方法一样简单，下面是运行结果：



原因是：Web Service不允许我们以匿名的方式访问。你可以在IIS信息服务中Web Service所在站点开启这项功能。然后，你就可以看到正确结果了：



方式二：使用WSDL工具。

我们也可以使用VS自带的wsdl工具来实现相同的功能，这个工具可以将wsdl文件生成在本地生成一个强类型的类文件，然后我们可以就可以直接在项目中使用这个类文件，来访问远程资源。打开VS命令提供，输入以下命令，如下图所示：



同时在C:\Program Files\Microsoft Visual Studio 8\VC下会自动生成一个Service.cs的文件。我们将这个文件置于我们的项目中，就可以直接使用了。


复制

保存
Microsoft(R) Web Services 描述语言实用工具
[Microsoft (R) .NET Framework, Version 2.0.50727.42]
Copyright (C) Microsoft Corporation. All rights reserv

wsdl.exe -
使用 ASP.NET，根据 WSDL 协定文件、XSD 架构和 .disc
发现文档，为 Xml Web Services 客户端和 Xml Web Ser
代码的实用工具。此工具可以与 disco.exe 一起使用。

wsdl.exe <选项> <URL 或路径> <URL 或路径>

- 选项 -

<URL 或路径> -
指向 WSDL 协定、XSD 架构或 .discomap 文档的 URL 或

/nologo
取消显示版权标志。

/language:<language>
用于生成的代理类的语言。请从“CS”、“VB”、“JS”
“CPP”中选择，或者为实现 System.CodeDom.Compiler.
的类提供一个完全限定的名称。默认语言为“CS”(CShar
缩写形式为“/l:”。

/sharetypes
打开类型共享功能。此功能针对不同服务之间共享
的相同类型(命名空间、名称和网络签名必须相同)
创建一个具有单一类型定义的代码文件。
请使用 http:// URLs 作为命令行参数来引用
服务，或为本地文件创建一个 discomap 文档。

/verbose
指定 /sharetypes 开关时显示额外信息。
缩写形式为“/v”。

/fields
生成字段而非属性。缩写形式为“/f”。

/order
为粒子成员生成显式顺序标识符。

/enableDataBinding
在所有生成的类型上实现 INotifyPropertyChanged 接口
以启用数据绑定。缩写形式为“/edb”。

/namespace:<namespace>
生成的代理或模板的命名空间。默认命名空间
为全局命名空间。缩写形式为“/n:”。

/out:<fileName|directoryPath>
生成的代理代码的文件名或目录路径。默认文件名是从
服务名派生的。缩写形式为“/o:”。

/protocol:<protocol>
重写要实现的默认协议。请从“SOAP”、“SOAP12”、
“HttpGet”、“HttpPost”中选择。

/username:<username>
/password:<password>
/domain:<domain>
连接到要求身份验证的服务器时使用的凭据。
缩写形式为“/u:”、“/p:”和“/d:”。

/proxy:<url>
用来处理 HTTP 请求的代理服务器的 URL。
默认为使用系统代理服务器设置。

/proxyusername:<username>
/proxypassword:<password>
/proxydomain:<domain>
连接到要求身份验证的代理服务器时使用的凭据。
缩写形式为“/pu:”、“/pp:”和“/pd:”。

/appsettingurlkey:<key>
在代码生成中用来读取 URL 属性的
默认值的配置项。默认为不从配置
文件中读取。缩写形式为“/urlkey:”。

/appsettingbaseurl:<baseurl>
计算 URL 段时使用的基 URL。
还必须指定 appsettingurlkey 选项。URL 段是
从 appsettingbaseurl 计算
WSDL 文档中的 URL 的相对 URL 的结果。缩写形式为“

/parsableerrors
输出错误，其格式与编译器报告的格式类似。

- 高级 -

/server
服务器开关已被否决。请改用 /serverInterface。
使用基于协定的 ASP.NET，为 Xml Web Services 实现生成抽象类。默认情况下，生成
客户端代理类。

/serverInterface
为 ASP.Net Web 服务的服务器端实现生成接口。将为 wsdl 文档中的每个绑定生成
一个接口。wsdl 单独实现 wsdl 协定(实现接口的类在类方法上不应包括下列任意一项:
更改 wsdl 协定的 Web 服务属性或序列化属性)。缩写形式为“/si”。

/parameters:<file>
从指定的 xml 文件读取命令行选项。这样可以指定命令行中无法使用的选项，例如选择
生成的异步编程模型类型。有关详细信息，请参阅工具文档。缩写形式为“/par:”。


复制

保存

//------------------------------------------------------------------------------
[/b]// <auto-generated>
[/b]//     此代码由工具生成。
[/b]//     运行库版本:2.0.50727.42
[/b]//
[/b]//     对此文件的更改可能会导致不正确的行为，并且如果
[/b]//     重新生成代码，这些更改将会丢失。
[/b]// </auto-generated>
[/b]//------------------------------------------------------------------------------
[/b]
using[/b] System;
using[/b] System.ComponentModel;
using[/b] System.Diagnostics;
using[/b] System.Web.Services;
using[/b] System.Web.Services.Protocols;
using[/b] System.Xml.Serialization;
//
[/b]// 此源代码由 wsdl 自动生成, Version=2.0.50727.42。
[/b]//
[/b]
/// <remarks/>
[/b][System.CodeDom.Compiler.GeneratedCodeAttribute("wsdl"[/b], "2.0.50727.42"[/b])]
[System.Diagnostics.DebuggerStepThroughAttribute()]
[System.ComponentModel.DesignerCategoryAttribute("code"[/b])]
[System.Web.Services.WebServiceBindingAttribute(Name = "ServiceSoap"[/b], Namespace = "http://ruihua.cnblogs.com/")]
[/b]public[/b] partial[/b] class[/b] Service : System.Web.Services.Protocols.SoapHttpClientProtocol
{
private[/b] System.Threading.SendOrPostCallback HelloOperationCompleted;
/// <remarks/>
[/b]    public[/b] Service()
{
this[/b].Url = "http://localhost/WebService/Service.asmx";
[/b]    }
/// <remarks/>
[/b]    public[/b] event[/b] HelloCompletedEventHandler HelloCompleted;
/// <remarks/>
[/b]    [System.Web.Services.Protocols.SoapDocumentMethodAttribute("http://ruihua.cnblogs.com/Hello", RequestNamespace = "http://ruihua.cnblogs.com/", ResponseNamespace = "http://ruihua.cnblogs.com/", Use = System.Web.Services.Description.SoapBindingUse.Literal, ParameterStyle = System.Web.Services.Protocols.SoapParameterStyle.Wrapped)]
[/b]    public[/b] string[/b] Hello(string[/b] name)
{
object[/b][] results = this[/b].Invoke("Hello"[/b], new[/b] object[/b][] {
name});
return[/b] ((string[/b]) (results[0]));
}
/// <remarks/>
[/b]    public[/b] System.IAsyncResult BeginHello(string[/b] name, System.AsyncCallback callback, object[/b] asyncState)
{
return[/b] this[/b].BeginInvoke("Hello"[/b], new[/b] object[/b][] {
name}, callback, asyncState);
}
/// <remarks/>
[/b]    public[/b] string[/b] EndHello(System.IAsyncResult asyncResult)
{
object[/b][] results = this[/b].EndInvoke(asyncResult);
return[/b] ((string[/b]) (results[0]));
}
/// <remarks/>
[/b]    public[/b] void[/b] HelloAsync(string[/b] name)
{
this[/b].HelloAsync(name, null[/b]);
}
/// <remarks/>
[/b]    public[/b] void[/b] HelloAsync(string[/b] name, object[/b] userState)
{
if[/b] ((this[/b].HelloOperationCompleted == null[/b]))
{
this[/b].HelloOperationCompleted = new[/b] System.Threading.SendOrPostCallback(this[/b].OnHelloOperationCompleted);
}
this[/b].InvokeAsync("Hello"[/b], new[/b] object[/b][] {
name}, this[/b].HelloOperationCompleted, userState);
}
private[/b] void[/b] OnHelloOperationCompleted(object[/b] arg)
{
if[/b] ((this[/b].HelloCompleted != null[/b]))
{
System.Web.Services.Protocols.InvokeCompletedEventArgs invokeArgs = ((System.Web.Services.Protocols.InvokeCompletedEventArgs) (arg));
this[/b].HelloCompleted(this[/b], new[/b] HelloCompletedEventArgs(invokeArgs.Results, invokeArgs.Error, invokeArgs.Cancelled, invokeArgs.UserState));
}
}
/// <remarks/>
[/b]    public[/b] new[/b] void[/b] CancelAsync(object[/b] userState)
{
base[/b].CancelAsync(userState);
}
}
/**/[/b]
/// <remarks/>
[/b][System.CodeDom.Compiler.GeneratedCodeAttribute("wsdl"[/b], "2.0.50727.42"[/b])]
public[/b] delegate[/b] void[/b] HelloCompletedEventHandler(object[/b] sender, HelloCompletedEventArgs e);
/// <remarks/>
[/b][System.CodeDom.Compiler.GeneratedCodeAttribute("wsdl"[/b], "2.0.50727.42"[/b])]
[System.Diagnostics.DebuggerStepThroughAttribute()]
[System.ComponentModel.DesignerCategoryAttribute("code"[/b])]
public[/b] partial[/b] class[/b] HelloCompletedEventArgs : System.ComponentModel.AsyncCompletedEventArgs
{
private[/b] object[/b][] results;
internal[/b] HelloCompletedEventArgs(object[/b][] results, System.Exception exception, bool[/b] cancelled, object[/b] userState)
:
base[/b](exception, cancelled, userState)
{
this[/b].results = results;
}
/// <remarks/>
[/b]    public[/b] string[/b] Result
{
get[/b]
{
this[/b].RaiseExceptionIfNecessary();
return[/b] ((string[/b]) (this[/b].results[0]));
}
}
}

至此，服务器端访问Web Service就到这里，下面让我们来看看客户端如何该问Web Service。