SmartPersistenceLayer 2.0(4) ---Criteria操作篇

 

SmartPersistenceLayer 2.0 之 Criteria操作篇

概念

       以前一篇文章中，描述了实体Entity的操作，很明显，仅仅实体的操作是远远不够的。如：我们经常会根据查询条件从数据库中获取记录集并绑定到DataGrid上，会根据条件进行批量的Update和Delete，为此，在SPL引进了Criteria(标准)的概念，那么在SPL中设计了三种Criteria：

       RetrieveCriteria（获取标准）

              这个标准是根据查询条件，排序方式来获取满足条件的数据，可以以DataTable 、实体集的方式来返回。此标准会生成”Select * from TB where … order …”语句执行

       UpdateCriteria (更新标准)

              这个标准是根据条件对一个表进行批量更新，最终会生成”Update TB set … where ..”语句执行

       DeleteCriteria(删除标准)

              这个标准是根据条件对一个表进行批量删除，最终会生成”Delete from TB where …”语句执行

       这些标准都是针对单一实体，也就是针对一个表的操作，当然对于Update和Delete来说，这些操作已经足够了，可对于Select来说，我们经常会多表查询，所以，关于这种联合查询将会在下一篇的”高级查询篇”中讲解。

 

RetrieveCriteria 获取标准

       这个RetrieveCriteria是针对单一实体的查询，可以定义查询条件，排序方式并以不同的结果返回出来，下面我举一个例子：我们查询二年级的姓刘的学生号p dentEntityria rc=new RetrieveCriteria();,并以学号升序排

       RetrieveCriteria rc=new RetrieveCriteria(typeof(StudentEntity)); //实例化

       Condition c=rc.GetNewCondition();  //实例化一个条件

       c.AddEqualTo(StudentEntity.__GRADE,2);   //二年级条件

       c.AddMatchPrefix(StudentEntity.__Name,’刘’); //匹配’刘’字开头

       c.OrderBy(StudentEntity.__NO);             //按学号排

       DataTable dt=rc.AsDataTable() ;              //以DataTable方式返回

       步骤分析：

1.       实例化一个RetrieveCriteria时要指明是哪个实体类，使用“typeof(实体类名)”

2.       New一个Condition(条件)，可以使用此方法New出多个Condition，多个Condition之间是”OR”的关系

3.       给Condition指定条件，比如使用AddEqualTo（相等）、AddMatchPrefix(前匹配)，关于Condition将会专门进行介绍

4.       使用OrderBy()方法指定排序方式,默认为升序，如果要以降序排序使用：OrderBy(StudentEntity.__NO,false)

5.       最后以AsDataTable的方式返回DataTable,这可以方便进行DataGrid的数据绑定

 多种返回方式

        例子中是采用DataTable进行返回，这也是平时最常用的，SPL中还提供了其他的几种方式：

        EntityContainer 实体集

     这是指返回结果以实体的集合方式体现,对于实体集的操作是非常简单的：

EntityContainer ec=rc.AsEntityContainer();

for(int i=0;i<ec.Count;i++)

{

          StudentEntity student=(StudentEntity)ec[i];

          …..//得到实体后可以进行自己的操作

}

 

     ObjectCursor 游标

     SPL也提供游标的方式返回,这与实体集是差不多的概念,这是对原版本的兼容保留：

     ObjectCursor oc=rc.AsObjectCursor();

     if(oc.HasObject())

     {

          StudentEntity student=(StudentEntity)oc.NextObject();

          …. //得到实体后可以进行自己的操作

}

        在以游标返回后，进行操作前，一定要以HasObject()进行判断，以免抛出异常

 

EntityObject 单实体

SPL在2.0中增加了以EntityObject单实体的返回方式，大家觉得奇怪了，RetrieveCriteria是返回多记录的，这个单实体是何意了。我们有时候会遇到一种情况，通过”侯选主键”来进行查询，所谓”侯选主键”就是非主键，但可以确定也是唯一的，比如学生表中的学号,但在数据表中学号不是主键，不能用Entity自动的Retrieve()方式来获取，而要使用RetrieveCriteria获取，所以可以确信是唯一记录的，可以使用单实体返回：

EntityObject eo=rc.AsEntity();

if(eo!=null)

{

        StudentEntity student=(EntityObject)eo;

        …. //得到实体后可以进行自己的操作

}

其实这种方式是取第一条信息并自动转换成EntityObject方式了，所以如果是多条记录的话，用这种可以取到第一个实体。

 

TOP功能

在SPL2.0中增加了Top功能，我们只要使用：

RetrieveCriteria rc=new RetrieveCriteria(typeof(StudentEntity));

rc.Top=20;

这样就会只返回符合条件的前20条

目前此功能只支持SQL、ACCESS，因为这是使用”Select top n…”的语句，而ORACLE的TOP功能比较麻烦，尤其是在排序后进行前N条返回，由于时间与测试环境问题，一直没有对ORACLE支持。

 

多帐套功能

这也是SPL2.0的新增功能，只要指定数据源名就可以，有两种方式：

RetrieveCriteria rc=new RetrieveCriteria(typeof(StudentEntity),”DB2”);

或者：

RetrieveCriteira rc=new RetrieveCriteria(typeof(StudentEntity)):

rc.DatabaseName=”DB2”;

这样就可以对指定的数据源进行操作，而不是默认数据源。

 

其他

Clear()方法可以清除所有的Condition

SqlString属性可以返回执行的标准SQL语句

同样支持内存存储,这对开发员是透明的,只要实体在XML文件中声明为IsSaveToMemory=true

 

 

UpdateCriteria 更新标准

更新标准是针对单一实体根据条件进行批量更新，下面我举个例子：把所有二年级的学生升级为三年级

UpdateCriteria uc=new UpdateCriteria(typeof(StudentEntity)); //实例化

uc. AddAttributeForUpdate(StudentEntity.__GRADE,3);   //更新为三年级

Condition c=uc.GetNewCondition();    //实例化一个条件

c.AddEqualTo(StudentEntity.__GRADE,2);   //指定二年级的学生

try

{

int re=uc.Perform();                         //执行，返回影响条数

if(re>0)                                 //如果影响了数据库

              Response.Write(“更新影响了”+re.ToString()+”条记录”);

else                              //未影响数据库

              Response.Write(“没有更新记录”);

}carth(PlException exp)                //捕捉异常

{

       if(exp.ErrorType==ErrorTypes.RestrictError)  //如果是级联更新约束异常

              Response.Write(“遇到级联更新约束异常”);  //友好提示

       else

              throw exp;                          //抛出异常

}

步骤分析：

1.       实例化一个UpdateCriteria时也要指明是哪个实体类型的

2.       创建一个Condition，同样可以New多个Condition，Condition之间是“OR”的关系

3.       使用AddAttributeForUpdate(字段名，值)来指定要把某字段更新为某值，可以Add多个，由于时间问题，目前SPL2.0还不支持“字段之间更新”

4.       调用Perform()执行，会返回影响条数，如果没有AddAttributeForUpdate，即没有设定要更新的列，那么返回0

5.       在招待中会抛出级联约束异常，可以捕捉后进行友好提示

 

多帐套功能

更新标准也支持多帐套功能，使用方式与RetrieveCriteria类似：

UpdateCriteria uc=new UpdateCriteria(typeof(StudentEntity),”DB2”);

或者：

UpdateCriteria uc=new UpdateCriteria(typeof(StudentEntity));

uc.DataBaseName=”DB2”;

这样就可以在指定的数据源里更新数据了。

 

SqlString属性可以返回执行的SQL语句，以便调试语句。

支持内存存储，也就是如果实体为内存存储的，那么在执行Update后，会自动更新内存，对开发员透明

支持事务处理

 

DeleteCriteria 删除标准

删除标准是根据条件对数据表进行批量删除，值得提醒的话，这个标准使用要非常谨慎，利用不当误删除数据的。例如：要删除所以四年级的学生

DeleteCriteria dc=new DeleteCriteria(typeof(StudentEntity));

Condition c=dc.GetNewCondition();

c.AddEqualTo(StudentEntity.__GRADE,4);

try

{

       int re=dc.Perform();

       if(re>0)

              Response.Write(“成功删除”+re.ToString()+”条记录”);

       else

              Response.Write(“没有删除记录”);

}catch(PlException exp)

{

       if(exp.ErrorType==ErrorTypes. RestrictError)

              Response.Write(“遇到级联删除约束异常”);

       else

              throw exp;

}

步骤分析：

1.       实例化删除标准，需要指定实体类型

2.       创建删除条件,可以New多个条件，也是“OR”的关系

3.       调用Perform()执行，返回影响条数

4.       捕捉级联删除约束异常，友好提示

 

多帐套功能

这与其他的标准一样，有两种方式：

DeleteCriteria dc=new DeleteCriteria(typeof(StudentEntity),”DB2”);

或者：

DeleteCriteria dc=new DeleteCriteria(typeof(StudentEntity));

dc.DatabaseName=”DB2”;

这样就可以对指定的数据源进行删除

 

SqlString属性可以返回执行的SQL语句，以便调试语句。

支持内存存储，也就是如果实体为内存存储的，那么在执行Delete后，会自动更新内存，对开发员透明

                     支持事务处理

 

总结：

对于这些标准操作都有一个共同点，就是都针对单一实体，都支持多帐套功能，都支持内存存储功能；不同的是RetrieveCriteira可以以多种方式返回，而且这样的单一实体查询对于系统业务来说还是远远不够的，因此对于查询，将后在后面介绍Query类的联合查询功能，而对于UpdateCriteria和DeleteCriteria来说，这些操作已经足够了，当业务比较复杂的情况下，都可以拆解成这些方式来实现。

关于Condition的细节和事务处理将在后面单独进行讲解。

 

 

听棠

2004年11月

MSN：tintown_liu@hotmail.com