DataRabbit 轻量的数据访问框架（02） －－ IOrmAccesser

   （完全限定类名：DataRabbit.ORM.IOrmAccesser）   

   在DataRabbit框架中，通过IOrmAccesser来对数据库进行ORM访问，只要Entity（即ORM中的“O”）的定义与数据库表的结构完全一致，即可使用IOrmAccesser来对其进行ORM操作。

1.Entity
   Entity除了包括成员变量与属性（这些变量与属性与数据库表的结构完全一致）外，不需要包含任何其它元素。在轻量的数据访问框架 －－序 的例子代码中，我们已经看到了一个Student Entity的示例。

2.Filter
   我们经常需要依据条件来搜索数据，在DataRabbit的ORM框架中，使用Filter来表示一个单独的条件。Filter从ColumnItem继承，ColumnItem 表示数据列及其对应的值。比如，在进行Update操作时，我们可以使用一个ColumnItem 的List来指定要将哪些列的值更新为指定的值。

   首先，注意，Filter中包含一个GetBooleanExpression（）方法，该方法将当前Filter转换为一个标准的Sql条件字句。
   Filter的ComparisonOperator属性表明了采用何种比较符来构建条件表达式。

ComparisonOperators
    [EnumDescription("比较操作符")]
    public enum ComparisonOperators
    {
        [EnumDescription("=")]
        Equal ,
        [EnumDescription("!=")]
        NotEqual ,
        [EnumDescription(">")]
        Greater ,
        [EnumDescription("<")]
        Less ,
        [EnumDescription(">=")]
        NotLessThan,
        [EnumDescription("<=")]
        NotGreaterThan,
        [EnumDescription(" like ")]
        Like
    }

   在IOrmAccesser接口中，很多方法都接受 params Filter[] conditions 或IList<Filter>参数，比如：

        void  Delete(IList < Filter >  conditions);
         void  Delete( params  Filter[] conditions);

   比如，要删除数据库Student表中所有Age大于20岁且为男性的学生记录

 stuOrmAccesser.Delete( new  Filter(Student._Age,  20 , ComparisonOperators.Greater),  new  Filter(Student._IsBoy,  true , ComparisonOperators.Equal));

   
   针对接受 params Filter[] conditions 或IList<Filter>参数的方法，在OrmAccesser内部将会对每个Filter所表示的单个条件进行“与”操作，来作为搜索条件。那么如果需要对各个Filter进行“或”操作，或进行更复杂的逻辑组合（如“filter1 && (filter2 || filter3)”），就需要采用对应的接受IFilterTree作为参数的重载方法。

3.IFilterTree
   IFilterTree 用于表示多个Filter的逻辑组合。
   
   注意，IFilterTree中也包含一个GetBooleanExpression（）方法，该方法将当前Filter通过逻辑组合转换为一个标准的Sql条件字句。
   当前的IFilterTree有两个默认实现：
（1）SimpleFilterTree
   该实现仅仅支持最简单的对多个条件都进行“与”或都进行“或”的逻辑操作，更复杂的逻辑组合需求，可以使用AgileFilterTree。
   如果将上述的例子，改用IFilterTree可以这样实现：

            IList < Filter >  conditions  =   new  List < Filter > ();
            conditions.Add( new  Filter(Student._Age,  20 , ComparisonOperators.Greater));
            conditions.Add( new  Filter(Student._IsBoy,  true , ComparisonOperators.Equal));
            IFilterTree conditionTree  =   new  SimpleFilterTree(LogicType.And, conditions);
             stuOrmAccesser.Delete(conditionTree);

（2）AgileFilterTree
   AgileFilterTree 可以表示非常复杂的多个Filter的逻辑组合。它使用一个logicExpression字符串描述逻辑组合表达式，如"filter1 && (filter2 || filter3)"，然后解析这个表达式获取正确的Sql条件语句。
   比如，我们要找出所有年龄在20与25岁之间，或者名字为sky的学生：

            IDictionary < string , Filter >  mapping  =   new  Dictionary < string , Filter > ();
            mapping.Add( " A " ,  new  Filter(Student._Name,  " sky " , ComparisonOperators.Equal));
            mapping.Add( " B " ,  new  Filter(Student._Age,  20 , ComparisonOperators.Greater));
            mapping.Add( " C " ,  new  Filter(Student._Age,  25 , ComparisonOperators.Less));
            IFilterTree agileTree  =   new  AgileFilterTree( " A||(B&&C) " , mapping);

            IList<Student> list = stuOrmAccesser.GetMuch(agileTree);

4.IOrmAccesser的泛型参数
   IOrmAccesser是一个泛型接口，泛型参数是EntityType－－即实体的类型，我们知道，每个EntityType对应着数据库中的一个表，Entity class的名字最好与数据表的名字一致，这样IOrmAccesser就可以根据EntityType知道要访问数据库中的哪个表。如果Entity class的名字最好与数据表的名字不一致，也没关系，我们可以通过向IDataAccesser的OrmCoagent属性注入IOrmCoagent来提供EntityType与数据表名称的映射关系。IOrmCoagent接口定义如下：

     public   interface  IOrmCoagent
    {
         ///   <summary>
         ///  GetTableName 根据Entity类型获取对应的数据库表名
         ///   </summary>         
         string  GetTableName(Type entityType);
    }

   IOrmAccesser可以通过IOrmCoagent的GetTableName（）方法来获取EntityType所对应的数据库表的名称。

5.基本"CRUD"方法
   IOrmAccesser提供了基本的“CRUD”方法，如Insert，Update，Delete，GetOne，GetMuch，GetDataSet等等。这些方法都提供了多个重载，以接收单个Filter条件或多个Filter以及IFilterTree。
   大多数方法的含义都特别清晰明了，有几个方法的含义需要特别指出一下：

        ///   <summary>
         ///  GetMuchWithoutBlob 根据参数conditions来提取符合条件的所有Entity，但是Entity的blob字段没有被填充。
         ///   </summary>         
        IList < EntityType >  GetMuchWithoutBlob( params  Filter[] conditions);

         ///   <summary>
         ///  LoadBlob 填充entity的Blob字段
         ///   </summary>         
         void  LoadBlob(EntityType entity);

        ///   <summary>
         ///  Update 更新符合conditions的记录中由columnItems指定的各个Column为对应目标值。
         ///   </summary>         
         void  Update(IList < ColumnItem >  columnItems, IList < Filter >  conditions);

        ///   <summary>
         ///  GetDataSet 选取表中符合条件的row，并且只返回columns指定的列。
         ///   </summary>       
        DataSet GetDataSet(IList < Filter >  conditions,  params   string [] columns);

6.基于主外键关系进行Get获取
    IOrmAccesser会自动依据数据表的主外键关系来进行关系加载，比如，Student表中有MentorID字段（外键），对应Mentor表中的主键。那么，IOrmAccesser的GetParent方法，就可以根据指定的Student对象返回Mentor对象。

Mentor mentor  =  stuOrmAccesser.GetParent < Mentor > (student);

基于主外键关系进行Get的方法包括：

         ///   <summary>
         ///  GetParent 依据entity中外键的值，获取主表中的实体。外键建立了"语义"上的"Master-Detail"关系
         ///   </summary>        
        ParentType GetParent < ParentType > (EntityType entity);

         ///   <summary>
         ///  GetForeigner 依据entity中名为fkeyName外键的值，获取主表中的对应实体。外键没有"语义"上的"Master-Detail"关系
         ///   </summary>        
        ForeignerType GetForeigner < ForeignerType > (EntityType entity , string  fkeyName);

         ///   <summary>
         ///  GetChildList 依据entity中主键的值，获取从表中的所有相关实体
         ///   </summary>
        IList < ChildType >  GetChildList < ChildType > (EntityType entity);

         ///   <summary>
         ///  GetChildDataSet 依据entity中主键的值，获取从表中的所有相关记录
         ///   </summary>
        DataSet GetChildDataSet < ChildType > (EntityType entity);
         #endregion

   本文简单介绍了IOrmAccesser的一些基本功能和使用，在后面的文章中将介绍一些IOrmAccesser高级用法。


返回到：轻量的数据访问框架 －－序