使用Smark.Data进行数据查询时必须通过对象来描述，其主要描述信息包括查询来源于那些表和需要那些信息等,即使平常的最常面对的关联查询,数据汇总查询等都可以通过实体描述来完成.因此实体描述在组件中起到一个非常重要的作用,可以说所有数据处理都必须经过实体描述.以下是简单地介绍Smark.Data的实体描述能完成那些数据查询工作.

[Table]    interface ICustomers    {        [ID]        [IDENTITY]        string CustomerID { get; set; }        [Column]        string CompanyName { get; set; }        [Column]        string ContactName { get; set; }        [Column]        string ContactTitle { get; set; }        [Column]        string Address { get; set; }        [Column]        string City { get; set; }        [Column]        string Country { get; set; }        [Column]        string Phone { get; set; }        [Column]        string Region { get; set; }    }

以上是描述一个简单的客户信息，不过想要这个接口生自动生成对应的实体类需要安装一个插件，详细查看 ,最终生成的实体类是接口缺少I的名称。定义后就可以针对这个实体查询

Expression exp = new Expression();    if (!string.IsNullOrEmpty(FirstName))        exp &= Modules.Employee.firstName.Like(FirstName + "%");    if (!string.IsNullOrEmpty(LastName))        exp &= Modules.Employee.lastName.Like(LastName + "%");    if (!string.IsNullOrEmpty(City))        exp &= Modules.Employee.city == City;    if (!string.IsNullOrEmpty(Region))        exp &= Modules.Employee.region == Region;    Records = exp.List
    
     ();
    

自定义对象查询

之前的查询是把表中所有信息填充到Employee对象中,在实际应用很多逻辑处理只是需要获某些信息,如果都获取所有信息显然是不可取的做法.组件虽然不提供填充到匿名对象,但可以针对自定义对象填充.如果只想获取Employee的id,firstname,lastname等字段只需要定义以下对象即可

public class EmpNames    {       public string EmployeeID { get; set; }       public string FirstName { get; set; }       public  string LastName { get; set; }    }

使用的时候调用相关重载版本方法

Expression exp = new Expression();    foreach (EmpNames item in exp.List
    
     ())    {        Console.WriteLine(item.FirstName);    }
    

以上查询虽然是针对Employee对象,但最终生成的SQL只会包括EmpNames描述的字段信息,其他字段并不会生成到select中.

关联查询

在实际应用中关联查询是比较普通的需求,如果只对针对单表查询的话,如果组件不支持那在项目用中使用就失去了他的意义.组件虽然不具备LINQ TO SQL那种关联查询语法,但通过另外的方式来达到相同的目的,组件的实全描述完全具备描述一个关联查询的能力.以下是订单明细信息和产品关联获取相关信息的简单描述:

[Table(" OrderDetails inner join products on OrderDetails.productid= products.productid")]    public interface IOrderDetailView    {        [Column]        string ProductName { get; set; }        [Column("OrderDetails.UnitPrice")]        decimal UnitPrice { get; set; }        [Column]        decimal Quantity { get; set; }        [Column]        decimal Discount { get; set; }    }

可以通过以下查询得到某订单的明细信息:

Record = (Modules.Order.orderID == OrderID).ListFirst
    
     ();
    

描述关联查询其实很简单,只需要在Table描述里定义关联表的信息描述即可,然后实体成员定义需要加载的字段信息,如果存在不明确的情况定义信息具体来源即可.

汇总统计描述

既然实体可以描述关联查询,那汇总统计查询也可以通过实体来描述这样一个查询需求,以下是统计各城市客户订单数量描述

 

[Table("customers inner join orders on customers.customerid=orders.customerid")]    public interface ICustOrderGroupByCity    {        [Column]        string Country { get; set; }        [Column]        string City { get; set; }        [Count]        int Count { get; set; }    }

只需要使用Expression的List方法就能汇总表中的相关信息

Expression exp = new Expression();            var empviews = exp.List
     
      ();
     

实际应用可以通过Expression添加条件来实现基于条件的汇总统计