2009年10月14日

ASP.NET AJAX客户端编程之旅（三）——让JavaScript和C#无障碍沟通：数据类型自动转换&序列化

摘要

      通过前两篇文章，我们知道使用了ASP.NET AJAX框架后，在JavaScript中调用后台WebService方法非常方便，几乎可以看做是“直接调用”。那么，这里引出了一个问题：调用方法就牵扯到参数的传递，而JavaScript和C#毕竟是两种不同的语言，数据类型怎么沟通？简单型数据类型还好说，如果我们需要的参数是个复杂类型呢？如分层架构中经常用到实体类做参数，我们在后台定义实体类类型，但是JavaScript可不知道这种定义，也没有相应数据类型，那么要如何解决这个问题呢？再进一步，如果需要的参数是个泛型集合呢？在JavaScript中又要如何表示这种类型？这一篇将解决这些问题。

 

先来看ASP.NET AJAX给你变个魔术

      我们都知道，使用分层架构开发系统时，使用实体类作为参数很很普遍的。那么如果我们需要调用的某个后台方法中需要实体类做参数，应该如何进行呢？毕竟C#中定义的实体类在JavaScript中可不认识啊。先不要着急，跟我做以下几步，我们一起来看个魔术。

      1.新建一个ASP.NET AJAX Enabled Web Site工程，并添加系统文件夹App_Code。

 

      2.我们在App_Code里新建一个C#类文件StudentInfo.cs，其内容如下：

StudentInfo.cs:

 1using System;

 2

 3[Serializable]

 4public class StudentInfo

 5{

 6    private string _name;

 7    private int _age;

 8    private string _college;

 9

10    public StudentInfo() { }

11

12    public string Name

13    {

14        get { return this._name; }

15        set { this._name = value; }

16    }

17

18    public int Age

19    {

20        get { return this._age; }

21        set { this._age = value; }

22    }

23

24    public string College

25    {

26        get { return this._college; }

27        set { this._college = value; }

28    }

29}

 

      这是一个典型的实体类，相信做过分层架构的朋友一定经常使用到类似的代码。这里要特别注意两点：一是这个类上面有一个[Serializeable]属性，这表明此类可以被序列化，另外就是这个类有一个空的构造函数。

 

      3.接着，我们在网站根目录下添加一个WebService：StudentService.asmx，其代码如下：

StudentService.cs:

 1using System;

 2using System.Web;

 3using System.Collections;

 4using System.Web.Services;

 5using System.Web.Services.Protocols;

 6using System.Web.Script.Services;

 7

 8[WebService(Namespace = "http://tempuri.org/")]

 9[WebServiceBinding(ConformsTo = WsiProfiles.BasicProfile1_1)]

10[ScriptService]

11[GenerateScriptType(typeof(StudentInfo))]

12public class StudentService : System.Web.Services.WebService

13{

14    public StudentService() { }

15

16    [WebMethod]

17    public string ShowStudentInfo(StudentInfo student)

18    {

19        return "学生姓名：" + student.Name + "
年龄：" + student.Age + "
所在院系：" + student.College;

20    }

21}

 

      ShowStudentInfo这个方法接收一个StudentInfo类型的参数，并根据这个实体类的信息组合成一段字符串返回。

 

      4.接着，在网站根目录下新建一个ajax.js文件，内容如下：

ajax.js:

 1function btnShowStudentInfo_onClick()

 2{

 3    var student=new StudentInfo();

 4    student.Name="张无忌";

 5    student.Age="20";

 6    student.College="计算机学院";

 7    

 8    StudentService.ShowStudentInfo(student,CallBackFunction);

 9}

10

11function CallBackFunction(responseText)

12{

13    $get("result").innerHTML=responseText;

14}

 

      这里我们大胆的直接初始化了一个StudentInfo，为什么说大胆呢？不要忘了，我们的StudentInfo类型可是在C#中定义的，JavaScript里可压根没有这个类型，当时我们这里却好像在写C#似的，不但初始化了这个类，还给其中成员赋值，并且当作参数传给了后台方法。这样能成功吗？我们接着看看吧。

 

      5.Default.aspx作为主页，我们添加如下内容：

Default.aspx:

 1< IMG title="2009年10月14日 - cruelchen - 好好做人" alt="2009年10月14日 - cruelchen - 好好做人" src="https://i-blog.csdnimg.cn/blog_migrate/b854634c0904529d4018c4c3336be836.gif" border="0" >@ Page Language="C#" AutoEventWireup="true" CodeFile="Default.aspx.cs" Inherits="_Default" %<

 2

 3

 4

 5

 6    

 7

 8

 9    

10        

11            

14            

15                

16            

17        

18        

19            

20            

21        

22    

23

24

 

      这里就不用做过多解释了，看过前两篇的朋友肯定很容易就明白这段代码是什么意思。运行后，我们单击按钮，得到如下效果：

 

 

 

      可以看到，不仅程序运行没有报错，而且我们在JavaScript中定义的实体类被传到后台，并神奇的变成了C#实体类，作为参数完成了数据传递工作。运行结果非常令人满意。

 

魔术揭秘

      在上面的例子中，我们没有在JavaScript定义StudentInfo，更没有写代码把JavaScript实体类转换成C#实体类，但是程序正确执行了。很显然，有人替我们做了这一切，那是谁呢？当然是我们亲爱的ASP.NET AJAX。这就是这个框架另一项神奇的功能：前后台间数据类型自动转换，这个转换可不仅包括简单类型，还包括像实体类这样的复杂类型。那么，其工作原理是什么呢？

      仔细看StudentService.cs的代码，在类定义的上面，有一个[GenerateScriptTyep(typeof(StudentInfo))] 属性，秘诀就在这里。当我们给WebService类加上这条属性时，ASP.NET AJAX会在运行时自动为我们生成一个JavaScript版本的StudentInfo类，这个类的所有属性都和C#版的一模一样。所以，我们在JavaScript中实例化并赋值的其实是一个JavaScript版的StudentInfo。而后，当我们调用ShowStudentInfo方法时，ASP.NET AJAX框架会自动将JavaScript版的StudentInfo序列化成JOSN字符串，然后传到后台，后台再将这段字符串反序列化成C#版的StudentInfo，并作为参数传递给ShowStudentInfo，从而顺利完成工作。

      当然，如果某个后台方法返回一个StudentInfo类型的返回值，它也可以准确无误从C#传到JavaScript中。也就是说，序列化和反序列化都是双向的。

 

自动转换的条件

      知道了上述原理，那么如何才能自动转换呢？或者说具备什么条件的复杂类型才可以自动转换呢？大约有以下几点：

      1.需要在WebService中使用[GenerateScriptTyep()]属性指明要自动生成的复杂数据类型。

      2.该复杂类型必须有一个无参数的构造函数。

      3.该复杂类型的所有公有属性必须有get和set方法。

      另外值得注意的是，生成的JavaScript版本类只包含原类的公有属性，而私有属性和方法是不会映射过来的。应该说，这个技术对使用分层架构的应用特别有用，因为可以直接在客户端使用服务器端的实体类进行数据传输。

 

ASP.NET AJAX到底能自动转换哪些数据类型？

      1.基本类型将被转换为基本类型。如整形、浮点型、字符串、布尔型、DateTime等。（全自动转换）

      2.枚举类型将被转换为枚举类型。（全自动转换）

      3.复杂类型将转换为同名复杂类型，但只保留公有属性。（需要使用[GenerateScriptTyep(typeof(TypeName))]属性声明）

      4.数组、泛型集合将转换为数组。（全自动转换）

      5.DataTable将转换为JavaScript版的DataTable，但是需要ASP.NET Futures CTP的支持。

 

结束语

      这一篇中介绍了ASP.NET AJAX中非常有用的一个特性：数据类型自动转换。通过这个功能，使得前台可以更方便的调用后台程序。尤其是使用实体类传递数据会变得非常方便。在下一篇中，将介绍客户端组件的概念、使用客户端组件思想进行JavaScript开发以及简化的DOM操作。

      本文用到的实例可以在这里下载：AutoConvertionTest.rar

 

主要参考文献

      [1] 陈黎夫，ASP.NET AJAX程序设计-第II卷：客户端，人民邮电出版社，2007年10月

0

0

0

(请您对文章做出评价)