.NET中的Web service的开发
.NET中的Web service的开发
.NET平台内建了对Web service的支持,包括Web service的构建和使用。
与其它开发平台不同,使用.NET平台,你不需要其他的工具或者SDK就可以完成Web service的开发了。.NET Framework本身就全面支持Web
service,包括服务器端的请求处理器和对客户端发送和接受SOAP消息的支持。本节将带你用.NET创建和使用一个简单的Web
service。
要在.NET中创建Web
service,你只需建立一个.asmx文件。这个文件中有一个WebService标签,包含Language和class两个属性,分别用于指定编程语言和Web
service中暴露出的类。然后你就可以像平常一样编写你的类了。最后,在每个你想要暴露出的方法前面加一个System.Web.Services.WebMethodAttribute属性就可以了。最终代码类似于下面的程序清单。
'a
WebService in VB.NET (calc_vb.asmx)
<%@WebService Language="VB"class="Calc"
%>
Imports System.Web.Services
Public Class Calc
<WebMethod()>
_
Public Function Add(ByVal a As Double, _
ByVal b As Double) As
Double
Return a + b
End Function
End Class
用浏览器来浏览这个.asmx文件,你可以得到一张测试这个Web service的页面。例如,你把calc_vb.asmx
文件放到了Web服务器的myService目录下,那么相应的URL就是:
http://localhost/myService/calc_vb.asmx
测试页如下图所示。这一页是自动生成的。它显示了Web
service 的名字并列出了可以调用的方法。列表后面有一段文字,意思是你正在使用缺省的命名空间http://tempuri.org/,如果你想要发布这个Web
service的话,最好换一个你自己的命名空间,以避免名字上的冲突。本书后面的部分将会讨论Web service
命名空间的问题。在第六章中,我还会介绍怎样使用.NET的属性来指定命名空间和其他一些东西。
自动生成的Web service测试页
在测试页里点击Add方法,你会得到一个HTML表单,用来测试这个方法(见下图)。在这个表单里,Add方法所接受的所有参数都有一个相应的文本框。填好所有的参数,点击"Invoke"按钮,这个表单就会被提交到Web服务器。实际上,这就是通过HTTP
GET的形式在调用Web service。得到的结果是一个如下的简单XML文档:
<double xmlns="158http://tempuri.org/">158</double>
浏览下面这个URL,可以直接调用Add方法:
http://localhost/myService/calc_vb.asmx/Add?a=123&b=35
如你所见,方法的名字是你所请求的资源(注意,这里是区分大小写的),而函数中的每个参数都映射为查询字符串中的一个参数。这种形式对快速测试一个Web
service 是非常方便的。不过,因为这种方式使用的是HTTP
GET,所以它在数据类型和参数传递方向等方面都有一些局限。我们将在第六章中详细讨论这些局限。
自动生成的Add方法测试页
回到前面的Web service测试页,我们还可以看到页面的顶部有一个Service Description链接。点击过去你就可以得到描述这个Web
service的WSDL文档,如下图。在Web service的URL后面加上一个"WSDL"查询字符串,你也可以直接浏览到这一页:
http://localhost/myService/calc_vb.asmx?wsdl
Calc Web service的WSDL文档。注意,为了显示更多内容,所有的XML元素都已折叠起来。
Calc Web
service的WSDL文档。注意,为了显示更多内容,所有的XML元素都已折叠起来。
要在.NET中调用一个Web service
,你需要先运行wsdl.exe工具。这个工具会从Web service中读出它的WSDL描述文档,生成一个可以调用这个Web
service的代理类。例如,在命令行中执行下面的命令,可以生成Calc Web service的代理类:
wsdl.exe
/language:VB http://localhost/myService/calc_vb.asmx?wsdl
程序清单1-2截取自生成的VB代理类源码。这个代理类继承自System.Web.Services.Protocols.SoapHttpClientProtocol类,并且暴露出一个Add方法,这个方法接收两个double型浮点数,返回一个double型浮点数。
程序清单1
2 截取自wsdl.exe 生成的Web service代理类源代码
Imports
System.Web.Services.Protocols
'省略其他代码
Public Class Calc
Inherits
SoapHttpClientProtocol
'省略其他代码
<System.Diagnostics.DebuggerStepThroughAttribute(),_
SoapDocumentMethodAttribute(
_
"http://tempuri.org/Add",
_
Use:=System.Web.Services.Description.SoapBindingUse.Literal,_
ParameterStyle:=
SoapParameterStyle.Wrapped)>_
Public Function Add(ByVal a As Double,
ByValb As Double) As Double
Dim results() As Object =
Me.Invoke("Add",_
New Object() {a, b})
Return CType(results(0),
Double)
End Function
'省略其他代码
End Class
此后的工作就非常简单了。要调用CalculatorWeb
service,只需实例化一个Calc的代理对象,再调用它的Add方法:
Dim ws As New Calc()
Dim result As
Double = ws.Add(20.5, 10.9)
MessageBox.Show("结果是:" &result.ToString)
实际上,代理类中的Add方法仅仅是通过.NET Framework的SoapHttpClientProtocol类来调用Web
service,然后再把Web service 的返回值返回给调用者。
当然,除了上面的这些演示之外,.NET Web
service的创建和调用还有很多的内容。不过,在深入这些细节之前,我们需要先理解Webservice里面的几个关键技术:XSD、SOAP和WSDL。
- 1重庆OA客户
- 2重庆OA行业资讯
- 3西安OA行业资讯
- 4北京OA行业资讯
- 5合肥OA软件行业资讯
- 6郑州OA行业资讯
- 7济南OA行业资讯
- 8上海OA软件行业资讯
- 9石家庄OA行业资讯
- 10天津OA行业资讯
- 11沈阳OA行业资讯
- 12哈尔滨OA软件行业资讯
- 1杨波:IT治理是CIO重要任务
- 2供应链管理在公司中应该排老几?
- 3[原创]做ITSM咨询话ITIL系列之一:内部市场化
- 4[原创]亡羊补牢,为时已晚
- 5IT治理的利器之一:COBIT(上)
- 6[原创]ITIL系列专题(一)-IT服务管理从哪里开始?
- 7铁路信息化呼唤“IT自动管理”
- 8领导IT治理(一)(AMT研究院 黄庆扬 编译)
- 9重庆部分汽车行业公司名录
- 10如何有效防止IT监理延期?
- 11实战剖析:13步设计出一个ITSM系统
- 12[原创]ITIL系列专题(九)—流程的管理流程
- 13基于RFID的物料跟踪管理系统设计
- 14实用才是硬道理
- 15加快推进统计信息化建设
- 16四大管理软件厂商显露疲态
- 17IP智能视频分析系统的易用性和优势
- 18IT治理中CEO的角色
- 19ITIL不是“灭火器”
- 20[原创]ITIL之IT服务支持
- 21企业信息化规划过程的分解与应用
- 22网络普及率对政务信息化的重要性
- 23中国铁路物资总公司:提升绩效之旅
- 24ITIL V3中Service Design对业务的价值
- 25微软公开基于Web服务未来计算环境宏伟发展蓝图
- 26刚性的OA办公软件客户群市场,还没有被真正的激活
- 27战略咨询:通过报表之外了解企业
- 28重庆部分生产型企业优秀名录
- 29金融信息化有序发展必经之道
- 30ITSM的秋收与冬耕
成都公司:成都市成华区建设南路160号1层9号
重庆公司:重庆市江北区红旗河沟华创商务大厦18楼