ASP.NET创建XML Web服务全接触(5)
声明XML Web服务(2)
从WebService类衍生
使用ASP.NET创建的实现一个XML Web服务的类可以选择性地衍生于WebService类来获得访问公共的ASP.NET对象,例如Application、Session、User和Context的权限。Application和Session属性提供保存和接收Web应用程序的生命周期或一个特定的会话的状态的权限。想获得关于状态的更多的信息,请看在使用ASP.NET创建的XML Web服务中管理状态一节。User属性包含了XML Web服务调用者的身份。XML Web服务可以使用调用者身份来判定请求是否被授权。有关验证的更多信息,请看加强XML Web服务安全一节。Context属性提供了取得XML Web服务客户端请求的所有特定HTTP信息的权限。
下面的代码示例使用Context属性来获得服务器上的请求时间。
[C#] <%@ WebService Language="C#" Class="Util" %> using System; using System.Web.Services; public class Util: WebService { [ WebMethod(Description="Returns the time as stored on the Server",EnableSession=false)] public string Time() { return Context.Timestamp.TimeOfDay.ToString(); } } [Visual Basic] <%@ WebService Language="VB" Class="Util" %> Imports System Imports System.Web.Services Public Class Util Inherits WebService <WebMethod(Description := "Returns the time as stored on the Server", _ EnableSession := False)> _ Public Function Time() As String Return Context.Timestamp.TimeOfDay.ToString() End Function End Class |
定义XML Web服务方法
用来实现XML Web服务的类的方法不能自动通过Web与之通讯,但是有了使用ASP.NET创建的XML Web服务,就能够很容易的天家这种能力。为了添加这种功能,需要应用一个WebMethod属性到公共方法中。能够通过Web与之通讯的XML Web服务的方法被称为XML Web服务方法。
XML Web服务方法是XML Web服务使用的消息传递基础结构的关键组成部分。说得更精确些,一个客户端和一个XML Web服务使用消息,尤其是SOAP消息进行通讯。客户端发送一个SOAP请求到XML Web服务中,而一个XML Web服务方法返回一个SOAP响应。XML Web服务定义了它使用操作接受的消息类型,正如Web服务描述语言中定义的那样。这些操作与一个XML Web服务中的每个XML Web服务方法关联。 即使这些XML Web服务方法中的每一个都是在ASP.NET使用一个类的方法定义的,但要实现通过网络传送的数据,必须把数据序列化为XML。同样地,重要的是要记得XML Web服务并不能取代DCOM,我们应该说XML Web服务是跨越使用行业标准的平台通信的一种消息传递基础结构。
声明一个XML Web服务方法
声明一个XML Web服务,添加@_WebService指令。更多信息,请看声明一个XML Web服务一节。
添加公共方法到实现XML Web服务的类中。
应用WebMethod属性到你想要映射到操作的公共方法。
下面的代码示例有两个公共方法,其一是一个XML Web服务方法。Multiply方法是一个XML Web服务方法,因为它有一个应用到它上的WebMethod属性。
[C#] <%@ WebService Language="C#" Class="Util" %> using System; using System.Web.Services; public class Util: WebService { public int Add(int a, int b) { return a + b; } [ WebMethod] public long Multiply(int a, int b) { return a * b; } } [Visual Basic] <%@ WebService Language="VB" Class="Util" %> Imports System Imports System.Web.Services Public Class Util Inherits WebService Public Function Add(a As Integer, b As Integer) As Integer Return a + b End Function < WebMethod()> _ Public Function Multiply(a As Integer, b As Integer) As Long Return a * b End Function End Class |
补充:Web开发 , ASP.Net ,