WCF RIA 服务 （九）- Domain Service 2

演练：添加查询方法
查询数据源的方法有时被叫做查询方法。在WCF RIA Services中，查询方法必须以框架承认的方式来定义。此外，只返回一个实体的查询和有可能返回多个实体的查询定义是不同的。
当我们建立一个新的domain service类并在Add New Domain Service Class 对话框中指定实体时，RIA Services框架会自动为每一个服务端公开的实体创建一个简单的查询。这个简单的查询方法检索实体的所有数据。这个演练将描述如何添加一个用参数值来过滤结果的复杂查询方法。还描述了如何添加一个返回单个实体和一个实体集合的查询。
添加一个接受参数并返回单一实体的查询方法

1. 打开我们第三节中创建的RIAServicesExample解决方案。


2. 在服务端，打开从Customer表公开数据的domain Services 类。这个类应该叫做CustmerDomainService。


3. 添加一个查询方法，这个方法接受一个整数类型的参数并返回符合Customer ID的Customer实体。 如果返回单一实体的方法包含Query属性，必须设置IsComposable为false. 用户不能从客户端指定其他的查询操作。如果这个查询方法满足了作为查询所期望的签名，我们就不必使用[Query]属性。返回值必须是任何实体对象的单一实例。
   

   
   [Query(IsComposable=false)]
   
   
   
   public Customer GetCustomersByID(int customerID)
   
   
   
   {
   
   
   
       return this.ObjectContext.Customers.FirstOrDefault(c => c.CustomerID == customerID);
   
   
   
   }
   
   
   
   

   
   

添加一个接受一个参数并返回一个实体集合的查询方法

1. 打开从Customer表公开数据的domain service类。名字应为CustomerDomainService。


2. 添加一个方法，这个方法接受一个字符型参数并返回所有名字以参数开始的客户。这个方法可以返回一个IQueryable<>对象，因为用户可能想从客户端提供额外的查询。
   

   
   public IQueryable GetCustomersByLastNameLetter(string startingLastNameLetter)
   
   
   
   {
   
   
   
       return this.ObjectContext.Customers.Where(c => c.LastName.StartsWith(startingLastNameLetter) == true);
   
   
   
   }
   
   
   
   

在客户端显示这些查询的结果

1. 在客户端打开MainPage.xaml文件。


2. 添加两个TextBox控件和两个Button控件，这样用过就可以通过ID或名的首字母来过滤。下面的xaml代码显示了DataGrid的完整布局。
   
   
   



3. 打开MainPage.xaml的代码文件。



4. 添加代码来根据用户的输入来检索数据。
   

   
   public partial class MainPage : UserControl
   
   
   
   {
   
   
   
       private CustomerDomainContext _customerContext = new CustomerDomainContext();
   
   
   
   
   
   
   
       public MainPage()
   
   
   
       {
   
   
   
           InitializeComponent();
   
   
   
       }
   
   
   
   
   
   
   
       private void LetterButton_Click(object sender, RoutedEventArgs e)
   
   
   
       {
   
   
   
           IDButton.IsEnabled = false;
   
   
   
           LetterButton.IsEnabled = false;
   
   
   
           LoadOperation loadOp = this._customerContext.Load(this._customerContext.GetCustomersByLastNameLetterQuery(LetterValue.Text), CustomerLoadedCallback, null);
   
   
   
           CustomerGrid.ItemsSource = loadOp.Entities;
   
   
   
       }
   
   
   
   
   
   
   
       private void IDButton_Click(object sender, RoutedEventArgs e)
   
   
   
       {
   
   
   
           IDButton.IsEnabled = false;
   
   
   
           LetterButton.IsEnabled = false;
   
   
   
           LoadOperation loadOp = this._customerContext.Load(this._customerContext.GetCustomersByIDQuery(int.Parse(IDValue.Text)), CustomerLoadedCallback, null);
   
   
   
           CustomerGrid.ItemsSource = loadOp.Entities;
   
   
   
       }
   
   
   
   
   
   
   
       void CustomerLoadedCallback(LoadOperation loadOperation)
   
   
   
       {
   
   
   
           IDButton.IsEnabled = true;
   
   
   
           LetterButton.IsEnabled = true;
   
   
   
       }
   
   
   
   
   
   
   
   }
   
   
   
   

   
   
   



5. 运行解决方案。将会看到如下结果