Web Service实践篇 (转)

玻璃小屋 — Thu, 17 Feb 2005 01:54:00 GMT

［作者：pie 转贴自：www.cndot.com 点击数：858 更新时间：2003-12-10 文章录入：cya001 ］

无聊到了极点，所以这篇文章就当灌灌水，希望对于那些想了解，学习WebService
的人有所帮助，权当抛砖引玉，不过我担心引来石头就死翘翘了：）,对于WebService
这种技术的理论，网上已经有很多专家写的文章了，都是游说你去学WebService,说
它什么"未来软件的开发模式 ....",什么什么的，看了的人绝对会动心的，动心的话
看看这篇文章，就可能会对WebService是什么样子，怎么发布，怎么调用有一丁点了
解了，废话一大堆，好了，让我们开始吧，我现在讲的是Microsoft WebService，如果
对于用delephi开发WebService感兴趣的人，请看前面gnar大虾的文章<<WebService(下)>>

分两种情况来介绍WebService的，一种是用记事本编写，然后利用wsdl.exe csc.exe来编译
另外一种是借助Microsoft Visual Studio.NET开发工具

一:用记事本编写，然后利用wsdl.exe csc.exe...来编译
你要调用一个WebService，首先你要知道这个WebService的wsdl（Web 服务说明语言）地址，
这个wsdl是用来描述,说明你所要调用的这个WebService的，在.NET平台上它是自动生成的，
它就可以解析出你提供的服务名称、相关的参数、返回值类型以及服务的URI地址。具备这
些信息，客户就可以采用SOAP格式调用你的服务了.
首先我们来发布一个WebService-------helloworld.asmx
用记事本编写后保存成helloworld.asmx放在c:/inetpub/wwwroot/test/目录里面
<%@ WebService Language="C#" Class="test" %>
using System;
using System.Web.Services;
public class test:WebService
{
[WebMethod]
public string helloworld()
{
return "hello,world";
}
}
好了,现在我们通过浏览器来看看我们发布的WebService是什么样子的？
http://localhost/test/helloworld.asmx
看到了没？这就是发布好了的WebService，easy吧？
接着，我们来看看它的wsdl是什么样子的？
http://localhost/test/helloworld.asmx?wsdl
在.net平台上它是自动生成的
一个WebService发布好了，我们要怎么去调用呢？
你调用的Client端可以是控制台程序，也可以是web的形式...等等
无论是什么形式的Client端，一次Web Service的完整调用是这样的（不包含发现过程)
1. 客户请求Server的WSDL文档（你的URL应该是WSDL的地址）。
2. 客户解析WSDL的内容，获得服务的名称、地址、参数类型和返回值类型。
3. 根据以上信息，客户可以选择生成一个Proxy类：
用于将调用的参数包装到SOAP Envelop中，生成调用的XML格式数据，发送HTTP请求。
接受到HTTP请求的回应之后，解析SOAP数据，生成返回值，并返回。
4. 有了上述Proxy，客户代码就可以透明的调用Web Service了（与调用其他本地函数相同的方式）。
我们先学习怎么用控制台程序去调用这个WebService吧
第1，2步我们都已经完成了，我们根据wsdl的信息来生成一个代理类（Proxy类)
我们先得到这个Proxy类的源文件吧！
C:\>cd c:\Program files\microsoft.net\frameworksdk\bin
C:\Program Files\Microsoft.NET\FrameworkSDK\Bin>wsdl /l:cs /n:pie /out:c:\inetpu
b\wwwroot\test\pie.cs http://localhost/test/helloworld.asmx?wsdl
Microsoft (R) Web Services Description Language Utility
[Microsoft (R) .NET Framework, Version 1.0.2914.16]
Copyright (C) Microsoft Corp. 1998-2001. All rights reserved.
Writing file 'c:\inetpub\wwwroot\test\pie.cs'.
这样我们在c:\inetpub\wwwroot\test\就可以得到代理类pie.cs的源代码
它是一个以pie为名字空间,里面有个test类，类里面有个接口helloworld()
接下来呢？我们必须把它编译成中间语言*.dll
C:\>cd C:\WINNT\Microsoft.NET\Framework\v1.0.2914
C:\WINNT\Microsoft.NET\Framework\v1.0.2914>csc /t:library /out:c:\inetpub\wwwroo
t\test\pie.dll /r:System.web.services.dll c:\inetpub\wwwroot\test\pie.cs
Microsoft (R) Visual C# 编译器版本7.00.9254 [CLR version v1.0.2914]
版权所有 (C) Microsoft Corp 2000-2001。保留所有权利。
这样我们就可以在c:\inetpub\wwwroot\test\找到代理类的中间语言pie.dll
pie.dll也是我们所需要的，Client端就是通过这个代理来访问，调用WebService的
现在我们可以调用了
I:我们先建立调用这个WebService的控制台程序console_pie.cs
放在c:\inetpub\wwwroot\test\下
using pie;
using System;
class hehe
{
static void Main()
{
test ll=new test();
string kk=ll.helloworld();
Console.WriteLine(kk);
}
}
我们现在就可以把他编译成可执行文件*.exe
C:\WINNT\Microsoft.NET\Framework\v1.0.2914>csc.exe /r:c:\inetpub\wwwroot\test\pi
e.dll /out:c:\inetpub\wwwroot\test\console_pie.exe c:\inetpub\wwwroot\test\console_pie.cs
Microsoft (R) Visual C# 编译器版本7.00.9254 [CLR version v1.0.2914]
版权所有 (C) Microsoft Corp 2000-2001。保留所有权利。
现在，整个过程完成了，我们来看看，我们的调用成功了吗？
C:\>cd c:\inetpub\wwwroot\test\
C:\Inetpub\wwwroot\test>console_pie
hello,world
oh,yeah!我们可以看到console_pie.exe通过SOAP来调用http://localhost/test/helloworld.asmx
成功了.
II:Client端为Web的形式
由于微软推荐表现与实现的分离，我们也采用这种方式，建立两个文件
web_pie.aspx和web_pie.aspx.cs
web_pie.aspx的内容：
<%@ Page language="c#" Codebehind="web_pie.aspx.cs" Inherits="web_pie.WebForm1" %>
<HTML>
<HEAD>
<meta name="CODE_LANGUAGE" Content="C#">
</HEAD>
<body MS_POSITIONING="GridLayout">
<form id="Form1" method="post" runat="server">
<FONT face="宋体">
<asp:Label id="Label1" style="Z-INDEX: 101; LEFT: 244px; POSITION: absolute; TOP: 53px" runat="server" Width="101px" Height="13px">Label</asp:Label>
<asp:Button id="Button1" style="Z-INDEX: 102; LEFT: 248px; POSITION: absolute; TOP: 119px" runat="server" Text="Button"></asp:Button>
</FONT>
</form>
</body>
</HTML>
web_pie.aspx.cs的内容:
using System;
using System.Collections;
using System.ComponentModel;
using System.Data;
using System.Drawing;
using System.Web;
using System.Web.SessionState;
using System.Web.UI;
using System.Web.UI.WebControls;
using System.Web.UI.HtmlControls;
namespace web_pie
{
public class WebForm1 : System.Web.UI.Page
{
protected System.Web.UI.WebControls.Label Label1;
protected System.Web.UI.WebControls.Button Button1;

public WebForm1()
{
Page.Init += new System.EventHandler(Page_Init);
}
private void Page_Load(object sender, System.EventArgs e)
{

}
private void Page_Init(object sender, EventArgs e)
{

InitializeComponent();
}
#region Web Form Designer generated code
private void InitializeComponent()
{
this.Button1.Click += new System.EventHandler(this.Button1_Click);
this.Load += new System.EventHandler(this.Page_Load);
}
#endregion
private void Button1_Click(object sender, System.EventArgs e)
{
pie.test kk=new pie.test ();
Label1.Text =kk.helloworld ();
}
}
}
可以看的出来，web_pie.aspx用于存放网页的表现形式，而web_pie.aspx.cs用于存放网页的实现部分
这样对于以后代码的维护就好多了，而不像以前asp3.0的时候是镶入在html代码中的，不易修改:)
使用code behind page的时候（就是独立于.aspx的.aspx.cs文件），需要预先编译.aspx.cs文件为.dll
现在我们来编译
C:\WINNT\Microsoft.NET\Framework\v1.0.2914>csc /t:library /out:c:\inetpub\wwwroo
t\test\web_pie.dll /r:c:\inetpub\wwwroot\test\bin\pie.dll c:\inetpub\wwwroot\test\we
b_pie.aspx.cs
Microsoft (R) Visual C# 编译器版本7.00.9254 [CLR version v1.0.2914]
版权所有 (C) Microsoft Corp 2000-2001。保留所有权利。
编译完成了,这里说一下，如果Client端是Web端的话，默认是在*.aspx的同一个位置上建立一个
bin文件夹，然后把web_pie.dll部署到文件夹里面，这样调用是web会默认自己去bin目录下找
名字空间,好了，我们来看一下调用会出现什么样的结果:
http://localhost/test/web_pie.aspx
好了，出现网页了，我们摁下那个button看看
天啊！出错了!!!!!!!!!
找不到文件或程序集名称“pie”，或找不到它的一个依赖项。

通过ildasm.exe察看一下web_pie.dll可以看出他的确没有名字空间pie,我也不明白
我编译的时候已经加入/r开关了，为什么没有把pie部署到web_pie名字空间底下!
不过无所谓，他没有部署，我们自己来！
把c:\inetpub\wwwroot\test\pie.dll拷贝到bin目录底下！
好了，我们摁F5刷新一下网页，OK，出来了，在Label1上面显示helloworld了
好了，我们讲了Client端的两种形式，其他的形式比如说windows application
web service..的形式，举一返三，只要按照前面讲的四个步骤来就行了
这里就不罗嗦了

II:利用Microsoft Visual Studio.NET开发工具发布，调用，编写WebService
等待VS.NET正式版出来，可真等到花儿也谢了，版本从beta1,beta2,rc1,rc2,rc3,rc4
,rc5,到现在快要来的RTM，由于厦大接触.net的人比较少，讨论气氛没那么浓，所以
厦大里面的ftp上估计都是beta2的，我自己机子也是beta2的，一直想从上海交大拉个
rc5回来，最终还是没有实现,Sigh.....微软的盗版总是走在正版的前面，日前，微软
已经允许MSDN的订户下载正式版的Visual Studio.Net。中国方面的消息：
3月22日，微软中国公司将首先在北京召开VS.Net的发布会，届时估计有3000名开发人
员参加此次盛会。此后会陆续的在上海、广州等10个城市召开相关活动，预计将有100
00名开发人员参加本次活动。微软中国网站已经开始进入倒计时状态，但是相应注册
程序并未开放。大约会等到春节假期以后才会正式开始。
的确振奋人心!!!!!!
又罗嗦一通，好了，开始吧!如果你看明白了前面用记事本编写,调用WebService的例子
那么对于利用VS.net工具来开发WebService的理解就简单多了
事实上，原理还是一样的，只不过编译的过程，微软帮你做了而已，这样你就不用了解
wsdl,csc的参数是干嘛的，也不用那么累了，轻轻松松开发。
现在我们来学习怎么通过VS.net编写一个WebService
打开Microsoft Visual Studio.NET 7.0
文件---〉新建--->项目
项目类型选择Visual C#项目
然后选择ASP.NET web 服务
名称为tool_service
位置为http://localhost/test
确定！
看到了吧:)我们直接进入代码部分，双击设计的窗口
很多东西是默认的，很多代码微软帮我们写好了
看到下面的咚咚没有？
//[WebMethod]
//public string HelloWorld()
//{
//return "Hello World";
//}
把这四行前面的注销符'//'去掉，这样你就写好了一个webservice
Ctrl+F5，看到了没有，出来了，你已经发布了一个具有一个接口
helloworld（）的WebService了
好了，这里我讲一个通过web怎么来调用这个webservice
http://localhost/test/tool_service/service1.asmx
非常简单！
首先你建立一个asp.net web 应用程序
然后引用
添加web引用
URL就写http://localhost/test/tool_service/service1.asmx
好了，在解决方案资源管理器中我们可以发现多了web 引用
底下是名字空间localhost,我们可以改这个名字空间，改为
tool_service吧
现在你可以像处理本地函数一样处理这个tool_service名字空间下面的
类，接口了
我们来试试：
我们通过工具Add一个Label,然后再Add 一个button
编写响应button的函数
函数内容为
tool_service.Service1 pie=new tool_service.Service1 ();
Label1.Text =pie.HelloWorld ();
好了，编译一下吧
Ctrl+F5,看看什么样子？
出现网页了吧，呵呵，摁一下button，Label上显示helloworld了吧
简单吧，跟前面比较起来!!
我也刚刚接触，非常感谢网友qqchen79大虾的大力帮助
好了，就现丑到这里了，上面提到的都是静态调用WebService，如果
你们对于动态调用WebService感兴趣的话，我再贴篇关于动态调用
WebService的文章吧

MFC 写 ISAPI的一些入门级介绍

玻璃小屋 — Tue, 30 Nov 2004 04:18:00 GMT

ISAPI 应用

Web Service实践篇 (转)

MFC 写 ISAPI的一些入门级介绍