使用ASP.NET AJAX框架扩展HTML Map控件

　　现在，编写我们的Web方法：

以下是引用片段：
　[WebMethod]
　　[ScriptMethod(UseHttpGet = false, ResponseFormat = ResponseFormat.Json)]
　　public string GetAreaInfo(string area)
　　{
　　return area;
　　}

　　根据权威人士建议，为了安全起见，我们一般要使用HttpPost(或者HttpGet= false)方式访问Web方法。然后，我们把返回的数据格式配置为JSON格式(默认方式即为JSON方式)。

　　为了简化起见，这里的GetAreaInfo方法仅仅返回输入参数的相同值;但在实际开发中，我们应该在此替换以从数据库中检索数据。

　　到目前为止，我们已经成功创建从客户端以AJAX方式加以调用的Web服务。

　　但是，我们还要对页面中的服务器控件ScriptManager进行一些适当的配置，如下所示：

以下是引用片段：
<asp:ScriptManager ID="ScriptManager1" runat="server">
<services>
  <asp:servicereference path="~/LocationService.asmx" />
</services>
</asp:ScriptManager>
 

　　在此，我们仅在节点下加入了一个服务参考，但其作用如何呢?

　　从生成的HTML源码分析，上面的配置将生成如下所示内容：

以下是引用片段：

<script src="LocationService.asmx/jsdebug" type="text/javascript"></script>
 

　　这里的脚本标签引用了一个JavaScript文件LocationService.asmx/jsdebug。其实这是一个Web服务代理类。正是通过此代理类，我们才得以从客户端以异步方式调用服务器端的Web服务。

　　更有意思的是，如果你简单地复制显示在上面的路径到浏览器中，你将看到一个在运行时刻由AJAX环境生成的JavaScript文件—此文件使脚本服务调用可用。有关代理类，我们不再深入讨论。

　　下面，我们来看如何创建一个定制的客户端类。

　　四、 创建客户端定制类

　　我们知道ASP.NET AJAX框架的重大“发明”之一就是，它引入了面向对象的JavaScript编程模型。现在，借助于JavaScript设计模式，我们可以轻松地创建自己的模板或类，加入继承概念，创建接口与枚举等。

　　在本文中，我们将开发一个封装所有本示例中要求功能的客户端类。

　　现在，右击工程，并新添加一个名为ImageMap的JavaScript文件。在此文件中，我们将定义一个新的命名空间MyServices;这个命名空间将包含我们要开发的客户端类。如下所示：

以下是引用片段：
Type.registerNamespace("MyServices");

　　接下来，我们定义要创建的客户端类的构造函数：

以下是引用片段：

MyServices.Location = function (uiElement, uiBody) {
MyServices.Location.initializeBase(this);
this._uiElement = uiElement;
this._uiBody = uiBody;
this._xAxis = 0;
this._yAxis = 0;
}
 

　　一个模板或类的构造函数也只不过是一个普通的JavaScript函数。该构造器共有两个参数：uiElement和uiBody。

　　这两个参数都将用于描述在页面显示的弹出窗口。另外两个私有变量_xAxis和_yAxis用于描述弹出窗口的显示位置。典型情况下，我们最好在构造器中声明所有的私有成员。

　　接下来，我们将使用原型设计模式编写该类中的成员函数和属性：

以下是引用片段：

MyServices.Location.prototype =
{
  get_uiElement: function()
  {
    return this._uiElement;
  },
   set_uiElement: function(value)
  {
    this._uiElement = value;
  },
  get_uiBody: function()
  {
    return this._uiBody;
  },
   set_uiBody: function(value)
  {
    this._uiBody = value;
  },
 

　　注意，这里的UI元素属性方法的定义方式非常类似于.NET中各种语言中的定义形式。

　　下面的成员函数是我们的重点，它负责调用远程的Web服务：

以下是引用片段：
　　ShowPopupinfo: function(event, areaName)
{
  MyServices.LocationService.GetAreaInfo(areaName,
  Function.createDelegate(this, this.OnCompleted),
  this.OnError,  //负责进行错误处理的回叫函数
  this.OnTimeOut); //负责进行超时处理的回叫函数
  this._xAxis = event.clientX;
  this._yAxis = event.clientY;
}

　　上面的代码展示的是非常典型的从客户端调用Web服务的方法：

　　1)形式与调用一个普通的本地方法几乎一样方便;

　　2)Function.createDelegate函数是ASP.NET AJAX客户端开发中的极为重要的全局函数。创建此函数的原始目的之一是解决this关键字的问题。在一个由一个DOM元素引发的事件处理器中，this关键字总是引用此DOM元素而不是类本身。但在此，我们使用这个函数的理由是，使得AJAX环境在与激发Web服务的相同的类实例中调用成功时的回叫函数。当你需要引用客户端类的属性和方法时，这是相当重要的。简言之，使用此函数将使得访问调用Web服务的客户端类的属性和方法安全而准确。否则，进行异步调用的客户端类实例将为null，因为Web服务的响应是在另一个不同的上下文中执行的—这个上下文不再等同于发出异步Web调用请求的那个上下文。

　　3)有意思的是，这里的GetAreaInfo方法并不是我们在前面创建的Web服务中的那个，而是属于在运行时刻创建的Web服务代理类—此代理类作为一个客户端代理访问服务器端的ASMX Web服务。

　　上面ShowPopupInfo函数中的最后两行代码中，使用事件的输入参数设置两个私有变量xAxis和yAxis的值。我们在此的目的是，在与用户点击位置尽可能近的地方显示弹出窗口。

　　下面是调用成功时对应的回叫函数的实现代码：

以下是引用片段：

OnCompleted: function(result, userContext, methodName)
{
  var uiElement = $get(this.get_uiElement());
  var uiBody = $get(this.get_uiBody());
  if (uiBody != null)
  {
    var textNode = uiBody.firstChild;
    if (!textNode)
    {
      textNode = document.createTextNode(result);
      uiBody.appendChild(textNode);
    }
    else
    {
      textNode.nodeValue = result;
    }
    if (uiElement != null)
    {
      uiElement.style.visibility = "visible";
      uiElement.style.display = "inline";
      uiElement.style.left = this._xAxis + "px";
      uiElement.style.top = this._yAxis + "px";
    }
  }
},
 

　　内容相当简单—把从服务器端返回的数据设置为弹出窗口的显示内容并根据情况确保显示此窗口。

　　在创建客户端类的最后，我们还必须告诉AJAX框架在客户端注册之，以便可以从客户端访问它：

以下是引用片段：
MyServices.Location.registerClass("MyServices.Location");

　　至此，客户端类MyServices.Location已经成功创建。那么，如何使用它呢?

　　首先，我们需要在页面加载时定义客户端类的一个新的实例。为此，我们需要在pageLoad函数中编程：

以下是引用片段：
　var location = null;
　　function pageLoad(sender, args) {
　　location = new MyServices.Location("modal", "modalBody");
　　location.HidePopupInfo();
　　}

　　上面的代码简单地创建MyServices.Location类的一个新的实例。然后调用客户端类的成员函数之一来隐藏页面中的弹出窗口。为什么我们在pageLoad函数中创建客户端类的一个实例呢?原因在于，当AJAX环境控制流程到达pageLoad函数时，所有的AJAX客户端和用户定义的JavaScript代码都已经被成功加载。因此，这一时刻我们可以安全地访问任何用户或系统定义的JavaScript代码。

　　其它几个工具函数比较简单，在此不再赘述。

　　五、 总结

　　在本文中，我向你展示了如何通过创建一个AJAX服务和创建自己定制的客户端类来扩展HTML Map控件。在扩展后的控件中，当点击图像中的某个区域时，我们可以通过新型的AJAX方式来给出相关细节信息，而不必刷新整个Web页面。尽管在大部分Web应用中我们较少应用到这种Map控件(也许因此VS2005工具栏中省略之)，但如果开发大量图片、图像及地图操作相关的Web应用时，基于本文AJAX改造后的Map控件一定会让你的Web应用更加绚烂多彩。

　　【附】本文源码调试环境：Windows XP专业版+Visual Studio 2005+ASP.NET AJAX 1.0。