在本节,我们将进行一个演练。我们创建一个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的解决方案
- 在VS中,创建一个新的RIA Services项目,选择 File->New->Project。此时出现新项目对话框。
- 选择Silverlight应用程序模板,并命名为RIAServicesExample.
- 点击OK。出现New Silverlight Application对话框出现。
- 选择Enable WCF RIA Services选项框。现在将会在客户端和服务端之间创建连接。
- 点击OK来创建解决方案。这个方案包含两个项目:客户端和服务端。客户端被命名为RIAServicesExample,其中有用来创建表示层的SL代码。服务端被命名为RIAServicesExample.Web,其中包含中间层的代码。
创建数据模型 Data Models
在这部分,创建表示来自AdventureWorksLT数据库的数据的ADO.NET实体类。RIA Services与各种各样的数据模型类和数据源一起工作。
(注:在VS2010中使用实体数据模型时,应该选择Include foreign key columns in the model选项。当用实体数据模型向导时,这个选项是默认选择的。还应该使用在程序集内嵌入的实体数据模型映射信息的默认行为。)
---使数据在中间层可利用
- 在解决方案资源管理器中,右键点击服务端项目(RIAServicesExample.Web),选择添加->新项目, 添加新项目对话框将出现。
- 在类别列表中,选择数据并选择ADO.NET Entity Data Model模板。
- 命名为AdventureWorksModel.edmx并点击添加。 出现实体数据模型向导。
- 在 选择模型内容 中,选择 从数据库生成 ,然后点击下一步。
- 在 选择数据连接 中,创建到数据库的数据连接并点击下一步。
- 在 选择数据库对象 里,选择 Address, Customer, CustomerAddress表。
- 点击 完成 ,就为表生成了实体模型。
- 生成解决方案
创建域服务Domain Service
在这节中,将添加一个对中间层的domain service。domain service 把服务端的数据实体和操作
向客户端公开。可以在数据服务中加入商业逻辑来管理客户端如何与数据交互。
---创建domain service
- 右键点击服务端项目,选择 添加->新项目。
- 在列表中选择 Web, 然后选择 Domain Service Class 模型。
- 命名类为CustomerDomainService.cs(或 CustomerDomainService.vb)。
- 点击 添加。 出现 添加新域服务类 对话框。
- 选择自定义实体。
- 确定选了,Enable client access选项, 选择对应 自定义 的 Enable Editing选项。
- 点击 OK,就生成了domain service 类。
- 打开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,当生成解决方案时就会产生客户代理类。这个代理类允许我们从客户端访问数据。
--- 查看产生的客户端代理类
- 生成解决方案
- 在解决方案资源管理器中,在客户端项目中点击显示所有文件。注意到在Generated_Code文件夹中包含了一个代码文件。
3. 打开这个代码文件。注意到文件有下面的属性:
- 生成一个派生于WebContextBase类的WebContext类。
- 生成一个派生于DomainContext类的CustomerDomianContext类。这个类中有一个叫做GetCustomersQuery(在VS2008中是GetCustomerQuery)方法,它对应于在domain service中创建的查询方法。
- 生成一个派生于Entity类的Customer类,此类对应着domain service公开的实体。这个客户端的Customer实体类对应于服务端的Customer实体。