不久前我曾写了一篇有关用VS。NET Beta 2 来完成一个Web Service 的整个过程。这篇文章也是有关Web Service的,不过实现Web Service的整个过程完全是手工方式的,可以不依赖于VS。NET这样的开发工具。VS。NET开发Web Service是非常简便的,同样它也封装了许多底层的信息,它希望开发人员可以把精力集中在主要的逻辑实现和Service本身上。
至于对VS。NET你能否说不,那么要看你自己的理解了,好了言归正转,开始实现这个Web Service吧。
首先你必须已经成功安装Framework SDK Beta 2 ,然后用Notepad、IIS、IE、Dos 的Command Prompt就可以完成了。整个功能还是沿用上次的例子,一个HelloWorld 和Add的例子,如果你Download了两个Zip包,你会发现两者中许多代码是一样的。特别是客户端这边,它根本不关心你是用什么生成的。
整个的过程分为以下几步:
1. 手工生成一个 .asmx文件。
2. 设置一下你的IIS服务器。
3. 在浏览器中测试这个Web Service
4. 生成代理包
5. 编写客户端代码进行测试。
简单的看和上次在VS。NET中没有什么不同,唯一多的是要手工设置一下IIS,在VS。NET中是通过把这页设成Start Page然后F5来完成对IIS的设置的。有关设置的方面,dotnet比以前的ASP或Com有许多不同,全面了引进XML格式,这个不在这里说了。我们不要涉及这些。
||||||具体的说:
1. 手工生成一个 .asmx文件。
在VS。NET中它自动生成一个和Project同名的. asmx文件,同样也会再自动生成一个 .asmx.vb 或 .asmx.cs 文件,其实实现Service你的代码是写在这个文件中的,当然你也可以直接在 .asmx文件中直接写,这样IIS第一次运行时会编译这个.asmx文件,在特定的目录下生成一个DLL文件。不过我喜欢用象VS。NET的方式来实现,这样更有封装性,实际中应用中也更安全。道理就象一开始我们直接在ASP中用ADO访问数据库,以后却自然的是用一个组件来完成这些,然后在ASP中调用这个组件一样。但如果你完全沿用VS。NET的作法,是无法编译通过的。VS。NET中的.asmx文件是这样的:
Class="WebService1.Service1" %
然后是一个.vb 的文件,但如果我们照抄它,编译时需要-r许多库文件。你可以这样做,把这句话改成这样的:
WebService1" %
MyWebService是Namespace , Service1是你实现Service功能的类名,WebService1是你编译.vb成DLL的名字。然后在你的 .asmx.vb 中先加上这两句话:
Namespace MyWebService
End Namespace
然后你会发现我Copy了原来在VS。NET中的所有实现WebService的代码。然后可以存盘,将.asmx和 .asmx.vb放到一个目录中,比如:MyService,然后准备在Dos 的Command中编译这个Web Service了。使用下面的编译的编译命令:
VBC /t:library /r:System.web.Services.dll /r:System.dll
/r:System.XML.dll /out:bin/WebService1.dll Service1.asmx.vb
确认你在MyService目录下打入这个命令,这样会在这个目录下生成的子目录Bin中发现这个DLL文件:WebService1.DLL 。如果这一切都没有问题,那么你过了第一关。
||||||2. 在IIS中设置。
这就比较简单了,点中MyService目录右键选择共享,然后共享这个目录或是在管理工具中一步一步的新增一个虚拟目录都是一样的。但要效验你的Application Name:是否是叫WebService1和你的.asmx中class="MyWebService.Service1, WebService1" 这句对应。具体的你可以看附带的图02SetupIIS.jpg。刚才编译时用的 /out:bin/WebService1会在这里有用,如果我们什么也步配置,那么默认的是去/bin目录中看是否有这个文件,如果你忘了加这个参数,那么编译完成后最好Copy编译的DLL去当前目录的bin子目录
3. 完成IIS的设置后,可以用IE浏览器来测试了。
具体的你可以访问这样的URL:http://localhost/你共享的目录名/你的WebService.asmx 如果正常它会检查被编译的类,并返回一个有关这个Web Service的HTML视图。象附带的图中03IEOpenAsmx.jpg中的一样。其实它是由一个DefaultWsdlHelpGenerator.aspx的模板文件产生的,这个文件在C:\WINNT\Microsoft.NET\Framework\v1.0.2914\CONFIG\ 目录中。一千五多行代码,也许中文版出来以后这个模板也会成中文的。
||||||这部分也轻车熟路了,上篇文档中的我也是手工完成的。具体分为两步:
1. 先生成一个代理类。
wsdl /out:WebServiceProxyClass.cs http://localhost/WebService1/Service1.asmx
2. 然后编译这个代理类。
csc /t:library /out:bin/MyWebServiceProxy.dll WebServiceProxyClass.cs
对于bin的目录不是必须或要求的可以在任何目录,完成这部之后,组件也自动的注册了,也就是说你可以开始调用这个Web Service了。
5. 用客户端代码进行测试。
上一篇中我只用VS。NET简单的建立了一个 ASP Form,上面放两个 Lable显示一下。其实对于客户端来说可以说多种多样的,可以是ASP,Html,dotnet的应用程序,ASP+页面,VB程序、甚至是Java或其它任何语言生成的客户端。这也真正表现了Web Service的意义,只要在Web上,你能找到这个Service,那么你就可以享受这个Service。
Html就很容易了比如:
HelloWorld
你就可以完成测试。如果你要突出编程方式那么你可以象我上次一样用 Service1 ServiceProxy = new Service1() ;
String strReturn = ServiceProxy.HelloWorld() ; 这样的方式来获得结果。在ClientHtml.html中我展现了两种用于Web Service的协议:HTTP-GET和HTTP-POST。不过我想着重说的是CallServiceXML.asp这个文件的作法,从中你可以发现许多不同的东西,到底Web Service是通过什么来返回它提供的Service,它在干什么,结果也许你会发现很耳熟的SOAP。其实代理类是通过SOAP协议和ASP+的Web Service进行通讯。
||||||你可以仔细考察下面的代码:
function btn_click (n1, n2)
{
var xmlObj = new ActiveXObject("Msxml2.DOMDocument") ;
var sXml = "" ;
sXml += "
" ;
sXml += "" ;
sXml += "" ;
sXml = sXml + "" + n1.value + "" ;
sXml = sXml + "" + n2.value + "" ;
sXml += ""
xmlObj.loadXML(sXml) ;
// 完成请求的准备,手工生成一个SOAP的格式包(消息主体)
XmlRequest.innerText = xmlObj.xml ;
// 发出请求 并且得到服务器的回应。
var xmlHTTP = new ActiveXObject("Msxml2.XMLHTTP") ;
xmlHTTP.Open ( "Post", "http://localhost/WebService1/Service1.asmx", false) ;
xmlHTTP.setRequestHeader("SOAPAction", "http://tempuri.org/Add") ;
xmlHTTP.setRequestHeader("Content-Type", "text/xml; charset=utf-8" ) ;
xmlHTTP.Send(xmlObj.xml) ;
MyResult.innerText = xmlHTTP.responseText ;
var xmlResponse = xmlHTTP.responseXML ;
// xmlHTTP.responseXML 中就是服务器回应的结果
answer.innerText = xmlResponse.selectSingleNode
("soap:Envelope/soap:Body/AddResponse/AddResult").text ;
看得出先构造一个SOAP的包然后把请求拿回来(selectSingleNode函数是XML
DOM中的很通用的一个函数)具体的结果可以看09CallServiceXML.jpg
好了,通过上面我们完成了一个Web Service。这是完成一个Web Service的基本框架,剩下的你可以进行扩充实现你需要的功能。在最后我们具体考察了Web Service的协议和客户端的问题,涉及到SOAP和XML的一些概念。尽管VS。NET实现Web Service很方便,但手工实现也是完全可以的,但愿看完这篇文章之后你可以对VS。NET说一次不。