深入Atlas系列：Web Sevices Access in Atlas示例（3） - 在Web Services方法中使用多态
2006-10-18 11:06 by 老赵, 2564 visits
多态是OOP的重要特性，我这里指的多态是其中的一小部分。
在Web Services方法中，我们往往使用的都是一个具体类型的参数。这个参数一般就是一个数据对象，所有的功能基本上只是为了存放数据。虽然这对于应用来说一般已经足够，我们大量使用了这样的Web Services，不也过得好好的吗？但是，在这一点上实在太不够面向对象了。
不过，我们到底如何在Web Services方法中运用多态呢？似乎最容易想到的办法就是在Web Services方法里使用接口或者抽象类型的参数，只要将不同的实现或者子类对象作为参数传递给Web Services方法就可以了。作为示例，我们希望看到最简单的东西，那么就使用这个方法吧。
首先，我们定义一个Employee抽象类：
Employee抽象类
1 public abstract class Employee
2 {
3 private int _Years;
4 public int Years
5 {
6 get
7 {
8 return this._Years;
9 }
10 set
11 {
12 this._Years = value;
13 }
14 }
15
16 public string RealStatus
17 {
18 get
19 {
20 return this.GetType().Name;
21 }
22 }
23
24 public abstract int CalculateSalary();
25 }
Employee抽象类存放了一个员工的工龄，RealStatus属性返回了当前实例真正的类名，并且定义了一个CalculateSalary方法，可以让子类提供不同的实现。
我们又写了一个Web Services方法CalculateSalary，用于计算一个员工的薪水，并将信息返回。代码如下：
CalculateSalary方法
1 [WebMethod]
2 public string CalculateSalary(Employee employee)
3 {
4 return "I'm " + employee.RealStatus + ", my salary is " + employee.CalculateSalary() + ".";
5 }
这样，我们只要传入不同的Employee子类的实例，就能获得不同的信息了。那么我们现在开始分配薪水吧（以下数据纯属虚构，如有雷同，实属巧合）！
首先是实习生。可怜的实习生，不管干多少年永远只有2000元：
Intern类代码
1 public class Intern : Employee
2 {
3 public override int CalculateSalary()
4 {
5 return 2000;
6 }
7 }
接下来是签第三方公司的合同工，底薪5000，每年增加1000：
Vendor类代码
1 public class Vendor : Employee
2 {
3 public override int CalculateSalary()
4 {
5 return 5000 + 1000 * (Years - 1);
6 }
7 }
最后是正式员工（全职工），底薪12000，每年增加2000：
FulltimeEmployee类代码
1 public class FulltimeEmployee : Employee
2 {
3 public override int CalculateSalary()
4 {
5 return 12000 + 2000 * (Years - 1);
6 }
7 }
然后我们应该如何告诉Atlas将不同类型的实例传递给Web Services方法的参数呢？答案便是使用“__serverType”指定类型。我们通过示例代码查看这一点：
首先我们还是来看简单的HTML代码：
HTML代码
1 <atlas:ScriptManager ID="ScriptManager" runat="server" />
2
3 <div>Years:<input type="text" id="txtYears" /></div>
4 <div>
5 Status:
6 <select id="comboStatus" style="width:150px;">
7 <option value="Jeffz.PolymorphismInWSTypes.Intern">Intern</option>
8 <option value="Jeffz.PolymorphismInWSTypes.Vendor">Vendor</option>
9 <option value="Jeffz.PolymorphismInWSTypes.FulltimeEmployee">FTE</option>
10 </select>
11 </div>
12 <input type="button" onclick="calculateSalary()" value="Calculate!" />
13 <h1>Result:</h1>
14 <div id="result"></div>
有一个文本框，在里面输入年份。还有一个下拉框，可以选择想要传递给Web Services方法的参数类型。点击“Calculate!”按钮则会调用Web Services方法，并将结果显示在最后的DIV上。
下面是所用到的Javascript代码：
Javascript代码
1 <script language="javascript">
2 function calculateSalary()
3 {
4 var emp = new Object();
5 emp.Years = parseInt($("txtYears").value, 10);
6 emp.__serverType = $("comboStatus").value;
7
8 Sys.Net.ServiceMethod.invoke(
9 "EmployeeService.asmx",
10 "CalculateSalary",
11 null,
12 { employee : emp },
13 onComplete
14 );
15 }
16
17 function onComplete(result)
18 {
19 $("result").innerHTML = result;
20 }
21 </script>
calculateSalary函数会构造一个Object作为Web Services方法的参数，设置它的“Years”之后，还会将下拉框选择的那项赋值给“__serverType”。这样，“__serverType”的值就是一个类的FullName了，于是也就告诉了Atlas在服务器端需要构造哪个类的实例。
打开页面：
在文本框内填入工龄，选择Status，并点击“Calculate!”按钮。咦？怎么出错了？
为什么会出现这个错误？因为Atlas的服务器端Web Services运行环境没有在其上下文的字典里找到Jeffz.PolymorphismInWSTypes.Vendor这个类，于是抛出了KeyNotFoundException。那么我们该如何解决这个问题呢？这时候XmlIncludeAttribute就登场了，它原本是配合XmlSerializer使用，而现在也大有用武之地。
我们只需使用XmlIncludeAttribute为CalculateSalary这个Web Services方法作标记就可以了，例如：
应用了XmlIncludeAttribute的CalculateSalary方法
1 [XmlInclude(typeof(Intern))]
2 [XmlInclude(typeof(Vendor))]
3 [XmlInclude(typeof(FulltimeEmployee))]
4 [WebMethod]
5 public string CalculateSalary(Employee employee)
6 {
7 return "I'm " + employee.RealStatus + ", my salary is " + employee.CalculateSalary() + ".";
8 }
我们再运行一下页面，先选择Intern，输入工龄为2，点击“Calculate!”按钮：
再选择FTE，输入工龄为5，点击“Calculate!”按钮：
可以发现，我们在客户端告诉了Atlas应该使用哪个类，而Atlas也老老实实地构造了相应的类。如果能够合理地使用这一点，我们能够做的事情何止这个示例写的这么简单！
从这里我们可以看出，虽然Atlas打着“使用Web Services”的名号，但是它事实上使用一套特别的运行环境。如果利用好这个运行环境的特性，我们的Atlas开发生活会变得更加美好。:)
注一：如果一个Web Service类有多个Web Service方法，只需在一个方法上使用XmlInclude来标注类A，则所有该类的方法都能够使用类A，因为那些方法都在同一个Web Service上下文中。不过，不同的Web Services类使用了不同的上下文。
注二：对于Atlas有关这部分功能的实现方式以及代码分析感兴趣的朋友，可参考本人之前的文章《深入Atlas系列：Web Sevices Access in Atlas（6） - 对于复杂数据类型的支持（下）》，可能您会得到比我更深的理解。:)
点击这里下载示例源代码。
在Web Services方法中，我们往往使用的都是一个具体类型的参数。这个参数一般就是一个数据对象，所有的功能基本上只是为了存放数据。虽然这对于应用来说一般已经足够，我们大量使用了这样的Web Services，不也过得好好的吗？但是，在这一点上实在太不够面向对象了。
不过，我们到底如何在Web Services方法中运用多态呢？似乎最容易想到的办法就是在Web Services方法里使用接口或者抽象类型的参数，只要将不同的实现或者子类对象作为参数传递给Web Services方法就可以了。作为示例，我们希望看到最简单的东西，那么就使用这个方法吧。
首先，我们定义一个Employee抽象类：
Employee抽象类 1 public abstract class Employee
2 {
3 private int _Years;
4 public int Years
5 {
6 get
7 {
8 return this._Years;
9 }
10 set
11 {
12 this._Years = value;
13 }
14 }
15
16 public string RealStatus
17 {
18 get
19 {
20 return this.GetType().Name;
21 }
22 }
23
24 public abstract int CalculateSalary();
25 }
Employee抽象类存放了一个员工的工龄，RealStatus属性返回了当前实例真正的类名，并且定义了一个CalculateSalary方法，可以让子类提供不同的实现。
我们又写了一个Web Services方法CalculateSalary，用于计算一个员工的薪水，并将信息返回。代码如下：
CalculateSalary方法 1 [WebMethod]
2 public string CalculateSalary(Employee employee)
3 {
4 return "I'm " + employee.RealStatus + ", my salary is " + employee.CalculateSalary() + ".";
5 }
这样，我们只要传入不同的Employee子类的实例，就能获得不同的信息了。那么我们现在开始分配薪水吧（以下数据纯属虚构，如有雷同，实属巧合）！
首先是实习生。可怜的实习生，不管干多少年永远只有2000元：
Intern类代码 1 public class Intern : Employee
2 {
3 public override int CalculateSalary()
4 {
5 return 2000;
6 }
7 }
接下来是签第三方公司的合同工，底薪5000，每年增加1000：
Vendor类代码 1 public class Vendor : Employee
2 {
3 public override int CalculateSalary()
4 {
5 return 5000 + 1000 * (Years - 1);
6 }
7 }
最后是正式员工（全职工），底薪12000，每年增加2000：
FulltimeEmployee类代码 1 public class FulltimeEmployee : Employee
2 {
3 public override int CalculateSalary()
4 {
5 return 12000 + 2000 * (Years - 1);
6 }
7 }
然后我们应该如何告诉Atlas将不同类型的实例传递给Web Services方法的参数呢？答案便是使用“__serverType”指定类型。我们通过示例代码查看这一点：
首先我们还是来看简单的HTML代码：
HTML代码 1 <atlas:ScriptManager ID="ScriptManager" runat="server" />
2
3 <div>Years:<input type="text" id="txtYears" /></div>
4 <div>
5 Status:
6 <select id="comboStatus" style="width:150px;">
7 <option value="Jeffz.PolymorphismInWSTypes.Intern">Intern</option>
8 <option value="Jeffz.PolymorphismInWSTypes.Vendor">Vendor</option>
9 <option value="Jeffz.PolymorphismInWSTypes.FulltimeEmployee">FTE</option>
10 </select>
11 </div>
12 <input type="button" onclick="calculateSalary()" value="Calculate!" />
13 <h1>Result:</h1>
14 <div id="result"></div>
有一个文本框，在里面输入年份。还有一个下拉框，可以选择想要传递给Web Services方法的参数类型。点击“Calculate!”按钮则会调用Web Services方法，并将结果显示在最后的DIV上。
下面是所用到的Javascript代码：
Javascript代码 1 <script language="javascript">
2 function calculateSalary()
3 {
4 var emp = new Object();
5 emp.Years = parseInt($("txtYears").value, 10);
6 emp.__serverType = $("comboStatus").value;
7
8 Sys.Net.ServiceMethod.invoke(
9 "EmployeeService.asmx",
10 "CalculateSalary",
11 null,
12 { employee : emp },
13 onComplete
14 );
15 }
16
17 function onComplete(result)
18 {
19 $("result").innerHTML = result;
20 }
21 </script>
calculateSalary函数会构造一个Object作为Web Services方法的参数，设置它的“Years”之后，还会将下拉框选择的那项赋值给“__serverType”。这样，“__serverType”的值就是一个类的FullName了，于是也就告诉了Atlas在服务器端需要构造哪个类的实例。
打开页面：
在文本框内填入工龄，选择Status，并点击“Calculate!”按钮。咦？怎么出错了？
为什么会出现这个错误？因为Atlas的服务器端Web Services运行环境没有在其上下文的字典里找到Jeffz.PolymorphismInWSTypes.Vendor这个类，于是抛出了KeyNotFoundException。那么我们该如何解决这个问题呢？这时候XmlIncludeAttribute就登场了，它原本是配合XmlSerializer使用，而现在也大有用武之地。
我们只需使用XmlIncludeAttribute为CalculateSalary这个Web Services方法作标记就可以了，例如：
应用了XmlIncludeAttribute的CalculateSalary方法 1 [XmlInclude(typeof(Intern))]
2 [XmlInclude(typeof(Vendor))]
3 [XmlInclude(typeof(FulltimeEmployee))]
4 [WebMethod]
5 public string CalculateSalary(Employee employee)
6 {
7 return "I'm " + employee.RealStatus + ", my salary is " + employee.CalculateSalary() + ".";
8 }
我们再运行一下页面，先选择Intern，输入工龄为2，点击“Calculate!”按钮：
再选择FTE，输入工龄为5，点击“Calculate!”按钮：
可以发现，我们在客户端告诉了Atlas应该使用哪个类，而Atlas也老老实实地构造了相应的类。如果能够合理地使用这一点，我们能够做的事情何止这个示例写的这么简单！
从这里我们可以看出，虽然Atlas打着“使用Web Services”的名号，但是它事实上使用一套特别的运行环境。如果利用好这个运行环境的特性，我们的Atlas开发生活会变得更加美好。:)
注一：如果一个Web Service类有多个Web Service方法，只需在一个方法上使用XmlInclude来标注类A，则所有该类的方法都能够使用类A，因为那些方法都在同一个Web Service上下文中。不过，不同的Web Services类使用了不同的上下文。
注二：对于Atlas有关这部分功能的实现方式以及代码分析感兴趣的朋友，可参考本人之前的文章《深入Atlas系列：Web Sevices Access in Atlas（6） - 对于复杂数据类型的支持（下）》，可能您会得到比我更深的理解。:)
点击这里下载示例源代码。
![mill[未注册用户]](http://www.gravatar.com/avatar/d6f82e1c0b4bd7b9828e796186c7938b.jpg?d=http%3a%2f%2fblog.zhaojie.me%2fimages%2fprofile.gif&s=50)
嗯，这个例子比较简单但是我觉得这个特性很好用……