WCF RIA 服务 （三）- 创建一个RIA Services Solution

WCF RIA 服务 （三）- 创建一个RIA Services Solution

在本节，我们将进行一个演练。我们创建一个WCF RIA Services 应用，此应用从AdventureWorksLT 数据库中检索数据。我们会用SL来创建表现层的客户端，并创建表现不同数据库表的实体类。

此节需要：

• 
  
• Visual Studio 2008
• Silverlight 3
• WCF RIA Services Beta for visual Studio 2008 SP1

-or-

• Visual Studio 2010 Beta 2
• 
  
• Silverlight 4 Beta
• 
  
• WCF RIA Services Preview for Visual Studio 2010
• 
  
• AdventureWorksLT sample database

创建包含RIA Services Link的解决方案

1. 在 VS中，创建一个新的RIA Services项目，选择 File->New->Project 。此时 出现新项目 对话框。
2. 
   
3. 选择Silverlight应用程序模板，并命名为 RIAServicesExample.
4. 
   
5. 点击OK。出现New Silverlight Application对话框出现。
6. 
   
7. 选 择Enable WCF RIA Services选项框。现在将会在客户端和服务端之间创建连接。
8. 
   
9. 点击OK来创建解决方案。这个方案包含两个项目：客户端和服务端。客户端被命名为 RIAServicesExample,其中有用来创建表示层的SL代码。服务端被命名为RIAServicesExample.Web，其中包含中间层 的代码。

创建数据模型 Data Models

在这部分， 创建表示来自AdventureWorksLT数据库的数据的ADO.NET实体类。RIA Services与各种各样的数据模型类和数据源一起工作。

（注： 在VS2010中使用实体数据模型时，应该选择Include foreign key columns in the model选项。当用实体数据模型向导时，这个选项是默认选择的。还应该使用在程序集内嵌入的实体数据模型映射信息的默认行为。）

---使 数据在中间层可利用

1. 在解决方案资源管理器中，右键点击服务端项目 （RIAServicesExample.Web），选择添加 ->新项目 , 添加新项目对话框将出现。
2. 
   
3. 在类别列表中，选择数据 并选择ADO.NET Entity Data Model 模板。
4. 
   
5. 命名为AdventureWorksModel.edmx 并 点击添加。 出现实体数据模型向导。
6. 
   
7. 在 选择模型内容 中， 选择 从数据库生成 ，然后点击下一步 。
8. 
   
9. 在 选 择数据连接 中，创建到数据库的数据连接并点击下一步 。
10. 
    
11. 在 选 择数据库对象 里，选择 Address, Customer, CustomerAddress 表。
12. 
    
13. 点 击 完成 ，就为表生成了实体模型。
14. 
    
15. 生成解决方案

创 建域服务Domain Service

在这节中，将添加一个对中间层的domain service。domain service 把服务端的数据实体和操作
向客户端公开。可以在数据服务中加入商业逻辑来管理客户端如何与数据交互。

---创 建domain service

1. 右键点击服务端项目，选择 添加-> 新项目 。
2. 
   
3. 在列表中选择 Web , 然后选择 Domain Service Class 模型。
4. 
   
5. 命名类为CustomerDomainService.cs(或 CustomerDomainService.vb)。
6. 
   
7. 点击 添加 。 出现 添加新域服务类 对 话框。
8. 
   
9. 选择自定义 实体。
10. 
    
11. 确定选了，Enable client access选项 ， 选择对应 自定 义 的 Enable Editing选项。
12. 
    
13. 点击 OK，就生成了domain service 类。
14. 
    
15. 打 开CustomerDomainServie.cs文件。会注意到文件有如下属性：

• CustomerDomainService 类派生于LinqToEntitiesDomainService（TContex），这个基类是RIA Services框架内的一个抽象类。由于domain Services公开了ADO.NET 实体数据类，此基类是自动应用的。
• 
  
• 一 个泛型基类被绑定到上一步创建的实体类。
• 
  
• CustomerDomainService类被标记上 EnableClientAccess属性，来指出这个类是可以被客户层访问的。
• 
  
• 生成了一个查询方法。在VS2008中，这个 查询叫做GetCustomer 。在VS2010Beta2中，这个查询方法叫做GetCustomers。这个方法 返回没有过滤和排序的所有项。
• 
  
• 还生成了 InsertCustomer, UpdateCustomer, DeleteCustomer 方法。

创建Silverlight客户端

在 其他的演练中，将在domain service里加入商业逻辑。在本演练中，只是用生成的GetCustomers 方法。

由于在客户 端和服务端存在着一个RIA Services Link，当生成解决方案时就会产生客户代理类。这个代理类允许我们从客户端访问数据。

--- 查看产生的客户端代理类

1. 生成解决方案
2. 
   
3. 在解决方 案资源管理器中，在客户端项目中点击显示所有文件 。注意到在Generated_Code文件夹中包含了一个代码文 件。

3. 打开这个代码文件。注意到文件有下面的属性：

• 生 成一个派生于WebContextBase类的WebContext类。
• 
  
• 生成一个派生于DomainContext类的 CustomerDomianContext类。这个类中有一个叫做GetCustomersQuery(在VS2008中是 GetCustomerQuery)方法，它对应于在domain service中创建的查询方法。
• 
  
• 生成一个派生于 Entity类的Customer类，此类对应着domain service公开的实体。这个客户端的Customer实体类对应于服务端的Customer实体。

在 Silverlight客户端中显示数据

1. 打开 MainPage.xaml。
2. 
   
3. 从 工具箱里，拖拽一个DataGrid控件到Grid里。当从工具箱中拖拽DataGrid控件时，会自动添加一个XML命名空间和一个对数据程序集的引 用。如果你不是从工具箱中拖拽的DataGrid控件，你需要添加一个对System.Windows.Controls.Data程序集的引用和一个 XML命名空间 xmlns:data="clr-namespace:System.Windows.Controls;assembly=System.Windows.Controls.Data"
4. 
   
5. 命 名这个控件为 CustomerGrid，如下面所示：
6. <usercontrol class="RIAServicesExample.MainPage" xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation" designheight="300" designwidth="400" ignorable="d" mc="http://schemas.openxmlformats.org/markup-compatibility/2006" d="http://schemas.microsoft.com/expression/blend/2008" x="http://schemas.microsoft.com/winfx/2006/xaml" data="clr-namespace:System.Windows.Controls;assembly=System.Windows.Controls.Data"> <grid name="LayoutRoot" background="White"> <data:datagrid name="CustomerGrid"></data:datagrid> </grid> </usercontrol>
7. 
   
8. 打 开MainPage.xaml的后台代码文件。
9. 
   
10. 添加RIAServiceExample.Web命名空间和 System.Windows.Ria命名空间。RIAServices.Web命名空间位于客户端的生成代码里。
11. 
    
12. 添加 CustmerDomainContext实例，通过GetCustomerQuery方法来检索信息，并绑定到DataGrid控件，如下代码所示：
    using System; using System.Collections.Generic; using System.Linq; using System.Net; using System.Windows; using System.Windows.Controls; using System.Windows.Documents; using System.Windows.Input; using System.Windows.Media; using System.Windows.Media.Animation; using System.Windows.Shapes; using RIAServicesExample.Web; using System.Windows.Ria; namespace RIAServicesExample { public partial class MainPage : UserControl { private CustomerDomainContext _customerContext = new CustomerDomainContext(); public MainPage() { InitializeComponent(); LoadOperation<customer> loadOp = this._customerContext.Load(this._customerContext.GetCustomersQuery()); CustomerGrid.ItemsSource = loadOp.Entities; } } }</customer>  
13. 
    
14. 运 行应用程序。将会得到一个如下类似的表格：