使用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; }}

以上是描述一个简单的客户信息，不过想要这个接口生自动生成对应的实体类需要安装一个插件，详细查看Smark.Data.I2MGenerator,最终生成的实体类是接口缺少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<Modules.Employee>(); 

自定义对象查询

之前的查询是把表中所有信息填充到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<Employee, EmpNames>()){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<Modules.OrderView>();

描述关联查询其实很简单,只需要在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<CustOrderGroupByCity>();

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