SQL Artisan组件之Query对象

概要

       SQL Artisan.NET基于SQL语句的数据访问组件,它目的是在.NET环境下快速的创建SQL语句并执行,从而让开发人员更有效率地创建数据库访问代码。SQL Artisan除在生成和运行的是标准SQL语句外,在生SQL语句过程中所有值都是通过参数方式进行传递从而解决SQL注入的安全问题。组件的运算符和比较运算符是基于.NET的实现,所以在编译过程中就可以检测语法的合法性,大大减少了开发过程编写SQL 语句拼写错误的问题。组件除了对标准SQL的支持外,还对数据库函进行扩展,让开发人员更灵活地创建数据库操作代码。

Query对象是SQL Artisan组件的主要成员之一,它是SELECT语句基于.NET对象化的实现;最终的目的是通过Query对象来解决全部SELECT查询语句的编写。

Query对象现在所支持的功能

      1)支持单表和多表查询;包括INNER JOIN,LEFT JOIN,RIGHT JOIN等操作。

      2)支持字段的运算符;包括:+-*/

3)支持字段的比较运算符;包括:=,<>,>,>=,<,<=,in,ont in,like, BETWEEN,

not BETWEEN等。

       4)支持聚合函数:Sum,Count,Avg,Max,Min

       5)支持数据库的扩展函数:Year,Month,Len,Left,SubString等。

       6)支持数据分组。

       7)支持数据排序。

Query的处理对象

       Select语句中主要处理的对象就是表和字段,同样Query中主要处理的对象也是一样。只是表和字段都在.NET中定义相应的类型;分别是HFSoft.Data.Expressions.Table和HFSoft.Data.Expressions.TableField。

        HFSoft.Data.Expressions.Table

     表描述对象,它用于提供Query需要查询的表信息。

    可以通过以下方式来定义一个表对象:

     private HFSoft.Data.Expressions.Table TBL= new  HFSoft.Data.Expressions.Table("Orders");

 

     表对象提供关联方法用于生关联的表对象:

          .INNER JOIN建立两个表的关联表

               1)创建Employees,Orders的关联表对象:

IQuery query = session.CreateQuery(Employees.TBL.INNER(Orders.TBL,Employees.F_EmployeeID))

 

              2)创建Employees,Orders,Customers的关联表对象:

IQuery query = session.CreateQuery(Employees.TBL.INNER(Orders.TBL,Employees.F_EmployeeID)&Orders.TBL.INNER(Customers.TBL,Orders.F_CustomerID));

 

          .LEFT JOIN建立两个表的左连接关联表

IQuery query = session.CreateQuery(Employees.TBL.LEFT(Orders.TBL,Employees.F_EmployeeID));

 

          .RIGHT JOIN建立两个表的右连接关联表

IQuery query = session.CreateQuery(Employees.TBL.RIGHT(Orders.TBL,Employees.F_EmployeeID));

 

   HFSoft.Data.Expressions.TableField

字段描述对象,它用于提供Query需要查询的字段信息

可以通过以下方式定义一个字段对象:

private HFSoft.Data.Expressions.TableField F_mOrderID = new HFSoft.Data.Expressions.TableField("OrderID");

 

字段对象提供丰富的运算功能,包括比较运算和数据库函数等。

运算功能:+,-,*,/

比较功能:==,!=,>,>=,<,<=,Like,In,NotIn, Match, Between, NotBetween

聚合函数:Max,Min,Count,Sum,Avg

组合运算:&,|

              数据库扩展函数:

                     MSSQL: CAST, ABS, FLOOR, DATEADD,YEAR,MONTH,DAY等。

                     其它数据暂时没提供。

Query组成部分

    Table属性

获取或设置需要查询的表对象,可以通过表的关联方法创建关联表对象。些属性不能为null

    Selects属性

获取或设置查询的字段对象集,此属可以为null。当为null时如果查询的表是单表则表示返回表的所有字段否则回基础表的所有字段。

可以通过字段的相关组合来产生新的查询字段;如:字段+-*/运算,还可以套用聚合函数和数据库函数等。

1IQuery query = session.CreateQuery(OrderDetails.TBL);

query.Selects = new TableField[]{SqlMath.Count(OrderDetails.ALL).As("CountValue"),OrderDetails.F_OrderID};

 

    2)IQuery query = session.CreateQuery(Employees.TBL);

query.Selects = new TableField[]{(Employees.F_LastName +Employees.F_LastName).As("Name"),Employees.ALL};

 

Expreesion属性

       获取或设置条表达式,此属可以为null。当为null时查询获取表的所有记录。

       条件表达式可以通过字段对象的比较运算和组合运算符产生,比较过程中字段可以调用运算符或数据库函数。

 

1  IQuery query = session.CreateQuery(Orders.TBL);

        query.Expreesion = Orders.F_EmployeeID ==3 & (Orders.F_OrderDate.Between("1996-6-1", "1996-8-1")|Orders.F_OrderDate.Between("1997-6-1", "1997-8-1"));

 

OrderBy属性

获取或设置排序字段对象集,此属性可以为null。当为null时查询过程不对任何字段进行排序。

1  IQuery query = session.CreateQuery(Orders.TBL);

query.OrderBy = new TableField[]{Orders.F_EmployeeID.DESC,Orders.F_OrderDate.ASC};

GroupBy属性

获取或设置分组字段对象集,些属性可以为null。当为null时查询过程不进行分组。

1) IQuery query = session.CreateQuery(OrderDetails.TBL);

query.Selects = new TableField[]{SqlMath.Max(OrderDetails.F_Quantity).As("MaxValue"),OrderDetails.F_OrderID};

query.GroupBy = new TableField[]{OrderDetails.F_OrderID};

 

System.Data.DataSet ExecuteDataSet()

该方法是生成并执行相关的SQL语句,把获取的数据填充到DataSet对象中并返回。

Query用例

       SQL

              select *  from orders where orderid>10300 and orderid<10500;

       SQL Artisan

           using(IDataSession session = MappingContainer.ConfigContainer.OpenSession())

         {

              session.Open();

              IQuery query = session.CreateQuery(Orders.TBL);

              query.Expreesion = (Orders.F_OrderID > 10300 & Orders.F_OrderID < 10500);

              this.dataGrid1.DataSource = query.ExecuteDataSet().Tables[0];

         }

 

     SQL

              select orders.*,employees.* from orders inner join employees on orders.employeeid=employees.employeeid;

     SQL Artisan

           using(IDataSession session = MappingContainer.ConfigContainer.OpenSession())

         {

              session.Open();

              IQuery query = session.CreateQuery(Orders.TBL.INNER(Employees.TBL,Orders.F_EmployeeID));

              query.Selects = new TableField[]{Orders.ALL.At(Orders.TBL),Employees.ALL.At(Employees.TBL)};

                   this.dataGrid1.DataSource = query.ExecuteDataSet().Tables[0];

                  

         }

 

SQL

     SELECT * FROM Orders  where ( EmployeeID = 3  And ( (OrderDate BETWEEN  '1996-6-1' And '1996-8-1' )  Or (OrderDate BETWEEN  '1997-6-1' And '1997-8-1' ) ) )

     SQL Artisan

           using(IDataSession session = MappingContainer.ConfigContainer.OpenSession())

         {

              session.Open();

              IQuery query = session.CreateQuery(Orders.TBL);

              query.Expreesion = Orders.F_EmployeeID ==3 & (Orders.F_OrderDate.Between( "1996-6-1", "1996-8-1")|Orders.F_OrderDate.Between("1997-6-1", "1997-8-1"));

                   this.dataGrid1.DataSource = query.ExecuteDataSet().Tables[0];

                  

         }

 

SQL

     SELECT Orders.* FROM Orders INNER JOIN [Order Details] ON Orders.OrderID=[Order Details].OrderID INNER JOIN Products ON [Order Details].ProductID=Products.ProductID INNER JOIN Categories ON Products.CategoryID=Categories.CategoryID  where Categories.CategoryName like '%con%'

     SQL Artisan

           using(IDataSession session = MappingContainer.ConfigContainer.OpenSession())

         {

              session.Open();

              IQuery query = session.CreateQuery(Orders.TBL.INNER(OrderDetails.TBL,Orders.F_OrderID)

                                     &OrderDetails.TBL.INNER(Products.TBL,OrderDetails.F_ProductID)

                                     &Products.TBL.INNER(Categories.TBL,Products.F_CategoryID));

              query.Selects = new TableField[]{Orders.ALL.At(Orders.TBL)};

              query.Expreesion = Categories.F_CategoryName.At(Categories.TBL).Match("con");

              this.dataGrid1.DataSource = query.ExecuteDataSet().Tables[0];

                  

         }

 

SQL

     SELECT Orders.* FROM Orders INNER JOIN [Order Details] ON Orders.OrderID=[Order Details].OrderID INNER JOIN Products ON [Order Details].ProductID=Products.ProductID INNER JOIN Categories ON Products.CategoryID=Categories.CategoryID  where ( Categories.CategoryID = 3  And (Orders.OrderDate BETWEEN  '1996-1-1' And '1996-12-31' ) )

     SQL Artisan

           using(IDataSession session = MappingContainer.ConfigContainer.OpenSession())

         {

              session.Open();

              IQuery query = session.CreateQuery(Orders.TBL.INNER(OrderDetails.TBL,Orders.F_OrderID)&

                                                             OrderDetails.TBL.INNER(Products.TBL,OrderDetails.F_ProductID)&

                                                             Products.TBL.INNER(Categories.TBL,Products.F_CategoryID));

              query.Selects = new TableField[]{Orders.ALL.At(Orders.TBL)};

              query.Expreesion = Categories.F_CategoryID.At(Categories.TBL) ==3 &

                                        Orders.F_OrderDate.At(Orders.TBL).Between("1996-1-1","1996-12-31");

              this.dataGrid1.DataSource = query.ExecuteDataSet().Tables[0];

         }

 

SQL ArtisanSQL参照表

SQL

SQL Artisan

语句

Select语句

Query对象

 

Delete语句

DeleteCommand对象

Update语句

UpdateCommand对象

Insert Into语句

InsertCommand对象

 

运行符

+

+

 

-

-

*

*

/

/

 

逻辑运算符

and

&

 

or

|

 

聚合函数

Sum

SqlMath.Sum

 

Max

SqlMath.Max

Min

SqlMath.Min

Count

SqlMath.Count

Avg

SqlMath.Avg

 

比较运算符

=

==

 

<>

!=

>

>

>=

>=

<

<

<=

<=

In

In

Not In

NotIn

Like

Like

Between

Between

Not Between

NotBetween

 

Match

 

其他

ASC

ASC

 

DESC

DESC

 

 

 

 

 

 

MSSQL支持的函数

CAST

MSSqlMath.CAST

 

ABS

MSSqlMath.ABS

FLOOR

MSSqlMath.FLOOR

CEILING

MSSqlMath.CEILING

DATEADD

MSSqlMath.DATEADD

DATEDIFF

MSSqlMath.DATEDIFF

DATENAME

MSSqlMath.DATENAME

DAY

MSSqlMath.DAY

MONTH

MSSqlMath.MONTH

YEAR

MSSqlMath.YEAR

LEFT

MSSqlMath.LEFT

LEN

MSSqlMath.LEN

REPLACE

MSSqlMath.REPLACE

RIGHT

MSSqlMath.RIGHT

STR

MSSqlMath.STR

SUBSTRING

MSSqlMath.SUBSTRING

 

 

 

 

 

 

 --用例代码下载--

posted on 2006-02-19 19:27 henry 阅读(...) 评论(...) 编辑 收藏

导航

统计