SQL Artisan 1.3功能使用介绍

       经过一段时间的修改SQL Artisan1.3功能已经完成，新版本并没引入太多的新功能，主要着手于使用方便性上的改进和完善。在这个版本中你可以看到数据操作变得很方便简洁，包括数据查询和统计；大部分的操作方式都是基于条件的驱动，让使用者在数据查询和统计中只关心条件，从而达到简单快捷地实现相关数据操作功能。由于这个版对基础的修改比较多因此并不稳定，在这里发表组件使用功能的主要目的是想得到大家意见。

       接下来介绍SQL Artisan1.3的功能使用，主要包括以下几个方面：数据修改操作，数据查询操作（包括复杂的关联查询），聚合统计。通过介绍组件使用的过程你会体会组件在数据操作上的方便性，其效果相信不会令你失望；当然更希望得到的是你宝贵的意见。

       数据修改：

              1)数据添加：

基于对象方式添加数据和其他持久化组件没多大区别，实例化相应实体对象后进行Add操作。

              Employees item = new Employees();

              if((DBMapping.Employees.FirstName =="fan" & DBMapping.Employees.LastName =="henry").Count()>0)

              {

                   Console.WriteLine("雇员信息已经存在!");

              }

              else

              {

                   item.FirstName ="Fan";

                   item.LastName ="Henry";

                   item.HireDate = DateTime.Parse("2001-12-25");

                   item.BirthDate = DateTime.Parse("1992-1-28");

                   item.Photo = new byte[0];

                   item.ReportsTo=1;

                   DAOContext.Add(item);

              }

组件除了添加对象方式添加数据以外，可以通过直接操作相关Table映射模型进行数据添加操作；通过这种方式可以灵活地控制在添加数据时操作那个字段模型。

              DBMapping.Employees.Insert(

              DBMapping.Employees.FirstName.Set("He"),

              DBMapping.Employees.LastName.Set("LiQing")

              );

              2)数据修改：

数据修改同样也提供两种方式，基于对象和字段模型。

//以对象方式更新

              Employees item =(Employees)DAOContext.Load(typeof(Employees),1);

              item.City ="GuangZhou";

              DAOContext.Edit(item);

              //以字段模型更新

              (DBMapping.Employees.EmployeeID == 1).Update(

                   DBMapping.Employees.City.Set("GuangZhou")

                   );

              3)数据删除：

组件数据删除完成可以基于条件驱动的方式来进行操作。

              //删除索引是1000 的雇员信息

              (DBMapping.Employees.EmployeeID ==1000).Delete();

              //删除索引是101,102和103的雇员信息

              DBMapping.Employees.EmployeeID.In(101,102,103).Delete();

              //删除FirstName是Fan或He的雇员信息

              (DBMapping.Employees.FirstName=="Fan" | DBMapping.Employees.FirstName =="He").Delete();

       数据查询：

组件的数据查询主要有几种方式，通过DAOContext对象、Table模型对象和条件驱动方式。条件驱动是最简化的一种使用方式,因为下面描述的例程都是基于条件驱动的查询.

              对象查询：

              //获取所有雇员信息

              Expression exp = new Expression(DBMapping.Employees);

              System.Collections.IList list = exp.List();

              //获取国家是USA的所有雇员信息

              list = (DBMapping.Employees.Country=="USA").List();

              //获取订单日期在1997-7-1和1997-8-1之间订单记录

              list =(DBMapping.Orders.OrderDate>= DateTime.Parse("1997-7-1") &

                       DBMapping.Orders.OrderDate < DateTime.Parse("1997-8-1")).List();

              //获取USA国家雇员的所有订单

              list =(DBMapping.Orders.Employee==(DBMapping.Employees.Country =="USA")).List();

              //获取SP地区客户的所有订单

              list=(DBMapping.Orders.Customer ==(DBMapping.Customers.Region=="SP")).List();

              视图对象查询：

组件是通过视图对象的方式来体现关联查询的，视图对象主要用于描述对象信息来源于那些表，通过那种方式进行关联和加载那些信息。这样可以集中统一地描述查询需求，从而达到一个比较好的代码重用效果，也简化在查询时一些烦琐信息的编写。

对象视查询例程：

              //获取国家是USA所有雇员的订单信息

              list=(DBMapping.Orders.Employee ==(DBMapping.Employees.Country=="USA")).ListTo(new OrderV());

              //获取SP地区在1997-7-1到1997-8-1销售的订单

              list =(DBMapping.Orders.Customer ==(DBMapping.Customers.Region=="SP")

                       & DBMapping.Orders.OrderDate >= DateTime.Parse("1997-7-1")

                       & DBMapping.Orders.OrderDate < DateTime.Parse("1997-8-1")

                       ).ListTo(new OrderV());

制定视图对象：

     /// <summary>

     /// 订单关联查询描述实体类

     /// 相关表：Orders,Employees,Customers;

     /// </summary>

     [TableMap("",TableType.View)]

     public class OrderV:Orders,HFSoft.Data.ITableView

     {

         public OrderV()

         {

              //

              // TODO: 在此处添加构造函数逻辑

              //

          }

         #region ITableView 成员

         /// <summary>

         /// 获以关联表对象

         /// </summary>

         /// <returns>Table</returns>

         public HFSoft.Data.Mapping.Table GetTable()

         {

              // TODO:  添加 OrderV.GetTable 实现

              return DBMapping.Orders.INNER(DBMapping.Employees,DBMapping.Employees.EmployeeID) &

                   DBMapping.Orders.INNER(DBMapping.Customers,DBMapping.Customers.CustomerID);

         }

         #endregion

         private string mCustomerName;

         /// <summary>

         /// 客户名称

         /// </summary>

         [ViewColumn("CompanyName")]

         public string CustomerName

          {

              get

              {

                   return mCustomerName;

              }

              set

              {

                   mCustomerName = value;

              }

         }

         private string mEmployeeName;

         /// <summary>

         /// 雇员姓名

         /// </summary>

         [ViewColumn("FirstName+LastName")]

         public string EmployeeName

         {

              get

              {

                   return mEmployeeName;

              }

              set

              {

                   mEmployeeName = value;

              }

         }

     }

       聚合统计：

组件只提供一个默认的聚合统计就是基于条件Count操作，此操作并不支持分组功能。但对于其他聚合统计可以通过视图对象的方式来完成，视图对象可以完成数据分组、字段运算等复杂的统计描述。

统计查询例程：

              //获取所有订单数

              Expression exp = new Expression(DBMapping.Orders);

              int count = exp.Count();

              //获取国家是USA所有雇员的订单数据

              count=(DBMapping.Orders.Employee ==(DBMapping.Employees.Country=="USA")).Count();

              //统计所有订单的销售金额

              SumPrice price =(SumPrice)exp.ListTo(new SumPrice())[0];

              //统计1997-7-1到1997-8-1销售金额

              price =(SumPrice)(DBMapping.Orders.OrderDate >= DateTime.Parse("1997-7-1")

                                 & DBMapping.Orders.OrderDate < DateTime.Parse("1997-8-1")).ListTo(new SumPrice())[0];

              //汇总雇员销售金额

              System.Collections.IList list = exp.ListTo(new SumPriceByGroup());

              //汇总某个国家的雇员销售金额

              list = (DBMapping.Orders.Employee ==(DBMapping.Employees.Country =="USA")).ListTo(new SumPriceByGroup());

制定统计描述对象：

     /// <summary>

     /// 订单销售统计描述对象

     /// </summary>

     [TableMap("",TableType.View)]

     public class SumPrice:ITableView

     {

         public SumPrice()

         {

              //

              // TODO: 在此处添加构造函数逻辑

              //

         }

         #region ITableView 成员

         public Table GetTable()

         {

              // TODO:  添加 OrderV.GetTable 实现

              return DBMapping.Orders.INNER(DBMapping.Employees,DBMapping.Employees.EmployeeID)

                   &DBMapping.Orders.INNER(DBMapping.Customers,DBMapping.Customers.CustomerID)

                   & DBMapping.Orders.INNER(DBMapping.OrderDetails,DBMapping.Orders.OrderID);

         }

         private Double mPrice;

         [StatColumn("Quantity*UnitPrice*(1-Discount)",StatType.Sum)]

         public Double Price

         {

              get

              {

                   return mPrice;

              }

              set

              {

                   mPrice = value;

              }

         }

         #endregion

     }

     /// <summary>

     /// 按雇员分组销售统计描述对象

     /// </summary>

     [TableMap("",TableType.View)]

     public class SumPriceByGroup:SumPrice

     {

         private int mEmployeeID;

         [ViewColumn("Employees.EmployeeID")]

         public int EmployeeID

         {

              get

              {

                   return mEmployeeID;

              }

              set

              {

                   mEmployeeID = value;

              }

         }

     }

http://www.cnblogs.com/henryfan/archive/2006/09/10/500210.html