C#学习到一定程度会涉及到C#创建WebService的一些高阶知识,本文试图对此做一个简单的介绍。
假设A是客户端,B是webservice服务端,用户通过http协议向服务器发送soap请求,webservice返回客户端Xml格式的数据。
现在我们看一看创建一个C#创建WebService的大致过程:
服务端的webservice是必须要建的。中间的soap,Xml我们不用去关心,在客户端这边,比较重要的是如何从webservice取得对象?答案是用的是proxy对象。客户端由代理对象(proxy)负责与webservice的通信。所以在客户端使用webservice,完全和使用一个本地对象是一样的。
我们现在以一个简单的C#创建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 看到了吧。 〈 ?Xml version="1.0" encoding="utf-8" ?〉 〈 string Xmlns="http。//tempuri。org/"〉 http。//www。ourfly。com欢迎yyg〈 /string〉 成功了。打开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,是没有这个类型库的。
webservice.就概念上来说,可能比较复杂,不过我们可以有个宏观的了解:webservice就是个对外的接口,里面有函数可供外部客户调用(注意:里面同样有客户不可调用的函数)。假若服务端,写好了个webservice,然后把它给了客户(同时我们给了他们调用规则),客户就可以在从服务端获取信息时处于一个相对透明的状态。即使客户不了解(也不需要)其过程,他们只获取数据。
webservice传递的数据只能是序列化的数据,典型的就是xml数据。
下面以一个简单例子为例:
(一)新建——-项目---Visual C#---web---ASP.NET Web 服务应用程序,命名为TestWebService
修改Service1.asmx的名字为:MyService.asmx
同时修改文件中的class名
public class MyService: System.Web.Services.WebService
{
[WebMethod]
public string HelloWorld()
{
return "Hello World";
}
}
同时修改文件MyService.asmx(右击--查看标记;如果在vs环境下双击打开的是.cs文件)
<%@ WebService Language="C#" CodeBehind="MyService.asmx.cs" Class="TestWebService.Service1" %>改为
<%@ WebService Language="C#" CodeBehind="MyService.asmx.cs" Class="TestWebService.MyService" %>
(二)重新生成项目,右击MyService.asmx,选择“在浏览器中查看”,即可检查本项目是否有语法错误
(三)在MyService.asmx添加指定方法
using System;
using System.Data;
using System.Web;
using System.Collections;
using System.Web.Services;
using System.Web.Services.Protocols;
using System.ComponentModel;
namespace TestWebService
{
///
/// Service1 的摘要说明
///
[WebService(Namespace = "http://tempuri.org/")]
[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]
[ToolboxItem(false)]
public class MyService: System.Web.Services.WebService
{
[WebMethod]//必须要有的,为了说明,其下是一个方法,每一个方法前面都需要有。
public string getName()
{
return "Hope";
}
[WebMethod]
public string getAge()
{
return "25";
}
}
}
重新生成项目,右击MyService.asmx,选择“在浏览器中查看”
(四)发布在外网上
这里在本机上测试的,所以没有必要发布。如果要发布到外网上,可以通过:
把bin文件下的文件以及与bin(包括.dll和.pdb文件)同级目录的asmx文件上传到外网即可。
(五)使用web service接口。
新建一个普通的windows应用程序,右击,添加web引用----
改一下web引用名为:HopeWebService
此时,可以使用webservice中的方法了。通过HopeWebService可以访问其中的两个方法。
(六)使用方法:
HopeWebService.MyService obj = new HopeWebService.MyService();
MessageBox.Show("name is:" + obj.getName()+";age is:" + obj.getAge());
在你的项目上右键->添加->新建项->Web服务