跳至正文

SQL Artisan 1.3功能使用介绍

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

       接下来介绍SQL Artisan1.3的功能使用,主要包括以下几个方面:数据修改操作,数据查询操作(包括复杂的关联查询),聚合统计。通过介绍组件使用的过程你会体会组件在数据操作上的方便性,其效果相信不会令你失望;当然更希望得到的是你宝贵的意见。本篇文章发表于www.xker.com(小新)


       数据修改:


              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”)


              );

#p#副标题#e#


              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”) &

#p#副标题#e#


                       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: 在此处添加构造函数逻辑


              //


          }

#p#副标题#e#


         #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

#p#副标题#e#


              {


                   return mEmployeeName;


              }


              set


              {


                   mEmployeeName = value;


              }


         }


     }


        


       聚合统计:


组件只提供一个默认的聚合统计就是基于条件Count操作,此操作并不支持分组功能。但对于其他聚合统计可以通过视图对象的方式来完成,视图对象可以完成数据分组、字段运算等复杂的统计描述。本篇文章发表于www.xker.com(小新)


统计查询例程:


              //获取所有订单数


              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());

#p#副标题#e#


 


制定统计描述对象:


     /// <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>

#p#副标题#e#


     [TableMap(“”,TableType.View)]


     public class SumPriceByGroup:SumPrice


     {


         private int mEmployeeID;


         [ViewColumn(“Employees.EmployeeID”)]


         public int EmployeeID


         {


              get


              {


                   return mEmployeeID;


              }


              set


              {


                   mEmployeeID = value;


              }


         }


     }