DataRabbit 轻量的数据访问框架（05）－－ ITableAccesser

2021-09-16 02:58:10

   （完全限定类名：DataRabbit.Relation.ITableAccesser）

   ORM并不能完成所有的事情，有些数据库访问还是需要基于关系来进行，对于那些不提供基于关系进行数据访问操作的纯ORM框架，我认为是不明智的。在DataRabbit中，基于ORM的访问和基于关系进行数据访问各占了一半的天空，这使得我们在无法用ORM达成的地方，可以转向使用基于关系的访问器来达成。DataRabbit.Relation命名空间下的类和接口用于提供基于关系的数据库访问操作，主要包括：针对数据库的Relation访问器（IRelationAccesser）、针对Table的Relation访问器（ITableAccesser）和针对存储过程的访问器（ISPAccesser），本文先介绍 ITableAccesser。

   同所有DataRabbit中的其它访问器一样，ITableAccesser也继承自ITransactionAccesser，它用于针对一个特定的表进行基于关系的数据访问。我们可以从DataRabbit的入口点IDataAccesser中获取ITableAccesser引用，比如，我们要得到针对Student表的ITableAccesser，可以这样做：

ITableAccesser stuTableAccesser = dataAccesser.GetTableAccesser("Student", null);

同ORM访问器一样，所有基于关系的访问器都向使用者屏蔽了地层的IDbCommand、IDbConnection等对象，使用者不必再关心打开连接、执行命令、关闭连接等繁琐的操作，只需要将sql语句交给访问器执行就可以了。比如，我们要删除所有年龄大于30的student，使用ITableAccesser可以这么做：

ITableAccesser stuTableAccesser = dataAccesser.GetTableAccesser("Student", null);
stuTableAccesser.Delete(string.Format("where {0} > '30'" ,Student._Age));

使用基于关系的访问器需要自己手写SQL语句，特别是用于搜索的Where子句，由于能支持手写SQL语句，所以相对于ORM访问器，基于关系的访问器可以执行更复杂的数据库操作。注意，在介绍ORM访问器时，我们经常使用Filter来表示条件，但是Filter以及IFilterTree仅仅只能在ORM访问器中使用，在基于关系的访问器中是不能使用它们的。
IDataAccesser接口相对简单，我们来看看它的全貌，之后你就知道该接口中各方法的含义了：

    public interface ITableAccesser :ITransactionAccesser
    {
        #region TableName
        /// <summary>
        /// TableName 目标表名称
        /// </summary>
        string TableName { get; }
        #endregion

        #region CommitData
        /// <summary>
        /// CommitData 提交DataTable中的changes到数据库
        /// </summary>
        void CommitData(DataTable dt);
        #endregion

        #region Delete
        /// <summary>
        /// Delete 删除目标表中所有满足where条件的记录
        /// </summary>
        void Delete(string where);
        #endregion

        #region Clear
        /// <summary>
        /// Clear 清空目标表
        /// </summary>
        void Clear();
        #endregion

        #region Insert
        /// <summary>
        /// Insert 将row存放到数据库中
        /// </summary>
        void Insert(DataRow row);
        #endregion

        #region Get
        /// <summary>
        /// Get 获取满足条件的DataSet
        /// </summary>
        DataSet Get(string where);

        /// <summary>
        /// GetOne 返回满足where条件的第一条记录
        /// </summary>
        DataRow GetOne(string where);
        #endregion

        #region no transaction
        /// <summary>
        /// GetRecordsCount 获取目标表中满足where条件的记录总数
        /// </summary>
        int GetRecordsCount(string where);

        /// <summary>
        /// NewRow 返回一个与目标表大纲完全一致的DataRow
        /// </summary>
        DataRow NewRow();

        /// <summary>
        /// GetEmptyTable 获取一个空的DataTable，该DataTable反映了目标表的结构
        /// </summary>
        /// <returns></returns>
        DataTable GetEmptyTable();

        #endregion


    }

转到：DataRabbit 轻量的数据访问框架－－序

码农公寓

相关文章