微软.NET 战略的一个比较重要的部分就是 webservice,利用 webservice 我们可以创建真正有效的分布式应
用程序。
下面,我们对 webservice 做一些说明。
假设 A 是客户端,B 是 webservice 服务端,用户通过 http 协议向服务器发送 soap 请求,webservice 返回
客户端 XML 格式的数据。
现在我们看一看创建一个 webservice 的大致过程:
服务端的 webservice 是必须要建的。中间的 soap,xml 我们不用去关心,在客户端这边,比较重要的是如
何从 webservice 取得对象?答案是用的是 proxy 对象。客户端由代理对象(proxy)负责与 webservice 的通
信。所以在客户端使用 webservice,完全和使用一个本地对象是一样的。
我们现在以一个简单的实例来说明。
打开 vs.net,新建工程(asp.net web 服务),在位置中键入 http://localhost/webserver,其中 webserver 就是
工程的名字。确定后,出现一个 Service1.asmx.cx,双击,出现代码窗口,
using System;
using System.Collections;
using System.ComponentModel;
using System.Data;
using System.Diagnostics;
using System.Web;
using System.Web.Services;
namespace webserver
{
///
/// Service1 的摘要说明。
///
(1)
public class Service1 : System.Web.Services.WebService
{
public Service1()
{
//CODEGEN:该调用是 ASP.NET Web 服务设计器所必需的
InitializeComponent();
}
#region Component Designer generated code
//Web 服务设计器所必需的
private IContainer components = null;
///
/// 设计器支持所需的方法 - 不要使用代码编辑器修改
/// 此方法的内容。
///
private void InitializeComponent()
{
}
///
/// 清理所有正在使用的资源。
///
protected override void Dispose( bool disposing )
{
if(disposing && components != null)
{
components.Dispose();
}
base.Dispose(disposing);
}
#endregion
// WEB 服务示例
// HelloWorld() 示例服务返回字符串 Hello World
// 若要生成,请取消注释下列行,然后保存并生成项目
// 若要测试此 Web 服务,请按 F5 键
// [WebMethod]
// public string HelloWorld()
// {
// return "Hello World";
// }
}
}
下面在(1)处加入
[WebService(Namespace="http://localhost/webserver/")]
这是因为 soap 是基于 http 协议上的,客户端无法知道 webservice 位于那个服务器上。在实际应用中,比
如 http://www.ourfly.com 上放置这个 webservice,则 Namespace 改为 http://www.ourfly.com/webserver.
下面我们给这个 webservice 添加一个方法。
// [WebMethod]
// public string HelloWorld()
// {
// return "Hello World";
// }
微软帮我们写好了一个,接着添加一个方法。方法名称叫 show.
[WebMethod]
public string show(string yourname)
{
return “http://www.ourfly.com”+”欢迎”+yourname;
}
现在,就可以运行了,按 F5,点击 show,输入你的名字,然后点击 invote
看到了吧。
http://www.ourfly.com 欢迎 yyg
成功了。打开 bin 目录,Vs.net 已经将 proxy 做好了.webserver.dll.
现在我们在不同的环境下测试:
1. 打开 vs.net,新建”windows 应用程序”工程,命名为 Client,增加按钮,文本框。
现在要用到代理了,右键单击右边的 reference(引用),选择”添加引用”,选择浏览,找到 webserver 目录下的
bin 目录下的 webserver.dll
再加入一个 system.web.webservices 的引用,在列表中有。
在 form1.cs 里,加入
using System.Web.Services;
using webserver;
然后在
private System.Windows.Forms.Button button1;
private System.Windows.Forms.TextBox textBox1;
后面,插入
private webserver.service1 Client
建立一个 service1 的实例。双击按钮,代码如下:
private void button1_Click(object sender, System.EventArgs e)
{
Client =new Service1();
string name;
name=Client.show("龙卷风.NET");
textBox1.Text=name;
}
按 F5,运行工程,点击按钮,文本框中显示
http://www.ourfly.com 欢迎龙卷风.NET
2. Asp.NET web 窗口的测试
方法与上面的一模一样,添加引用,建立 service1 的实例
在此不在细说。
3.在 VB 中测试
这个就要相对来说复杂一些
首先在 vb 中建立一个”标准 EXE”的工程。添加引用:Microsoft Soap Type library。注意:如果没有安装
Microsoft Soap Toolkit,是没有这个类型库的。
可以在 http://www.ourfly.com 中下载。
添加一个 text
Private Sub Form_Load()
Text1.Text = add()
End Sub
Public Function Add() As String
Dim objSoapClient As New SoapClient
objSoapClient.ClientProperty("ServerHTTPRequest") = True
Call objSoapClient.mssoapinit("http://localhost/webserver/service1.asmx?WSDL", "Service1", "Service
1Soap")
这句也可以
objSoapClient.mssoapinit("http://localhost/webserver/service1.asmx?WSDL")
Add = objSoapClient.Show("龙卷风.NET")
End Function
调试成功需要注意的:
运行服务端 webservice 的程序,出现下面时
支持下列操作。有关正式定义,请查看服务说明。
点击服务说明,会得到完整的 wsdl 文件
http://localhost/webserver/Service1.asmx?WSDL
我们就要使用这个文件,其中包含了我们定义的方法等等。
Mssoapinit(bstrWSDLFile as string,[bStrServiceName as string ],[bStrport as string ] ,[bstrWSMLDi
le as string])的用法:
其中第二个,第三个参数在 wsdl 文件中可以找到。也可以省略。
后续:还有从 COM 中生成 wsdl 文件等等,我会陆续推出的。