通用性站点管理后台(Bee OPOA Platform) （4）- DAL

该篇将介绍一下该平台中数据库访问层。设计之初考虑的主要偏向于方便应用， 由此数据访问层支持

1. 简单， 方便， 高效。 API简单高效。

2. 支持嵌套调用。 DbSession.Current

3. 通用。 支持主流数据库应用。 已使用验证过的包括Sqlite， SqlServer2008， SqlServer2005， Oracle。

DbSession的介绍

先来看一下DbSession的主要API。

   /* 实现IDisposable接口， 推荐使用using方式*/

    public sealed class DbSession : IDisposable

    {

        public DbSession(string connectionName) { /*使用配置文件中的连接名， 默认不启用事务*/ }

        public DbSession(string connectionName, bool useTransaction) {/*使用配置文件中的连接名， 是否启用事务*/  }



        /// <summary>

        /// 手动注册连接字符串。

        /// </summary>

        public static void Register(string connectionName,

            string providerName, string connectionString) { }



        public int CommandTimeout { get; set; }/* 该实例调用的超时时间*/



        public static DbSession Current

        {

            get; /* 获取当前上下文中DbSession实例， 不跨线程。 若上下文中未声明过， 则使用配置文件中第一个连接。*/

        }



        public void CommitTransaction()

        {

            /* 提交事务， 若不执行， 则自动rollback。 若中途抛异常， 自动rollback。*/

        }



        public int Insert(string tableName, BeeDataAdapter dataAdapter)

        {

            /* 指定表名， 插入数据集。 若不是该表中的字段， 则自动忽略。*/

        }



        public void Update(string tableName, BeeDataAdapter dataAdapter, SqlCriteria sqlCriteria)

        {

            /*指定表名， 数据集， 及条件集， 更新表*/

        }



        public void Delete(string tableName, SqlCriteria sqlCriteria)

        {

            /*指定表名， 及条件集， 删除数据*/

        }



        public DataTable Query(string tableName, SqlCriteria sqlCriteria) { }

        public DataTable Query(string tableName, SqlCriteria sqlCriteria, string orderbyClause) { }

        public DataTable Query(string tableName, string selectClause,

            SqlCriteria sqlCriteria, string orderbyClause, int pageIndex, int pageSize, ref int recordCount) { }



        public DataTable ExecuteCommand(string cmdText, BeeDataAdapter dataAdapter) { }

        public List<T> ExecuteCommand<T>(string cmdText, BeeDataAdapter dataAdapter){}



        public int Insert<T>(T value) { }

        public void Delete<T>(SqlCriteria sqlCriteria) { }

        public int Save<T>(T value) { }

        public List<T> Query<T>() { }

        public List<T> Query<T>(SqlCriteria sqlCriteria) { }

        public List<T> Query<T>(SqlCriteria sqlCriteria, string orderbyClause,

            int pageIndex, int pageSize, ref int recordCount) { }



        public DataTable CallSP(string spName, BeeDataAdapter dataAdapter)

        {

            /*调用存储过程。 若数据中的参数不是该存储过程的参数， 则自动忽略。 请注意存储过程的参数列表被缓存。 */

        }



        #region Schema Access



        /// <summary>

        /// 获取所有Table, SP, View

        /// </summary>

        public List<DbObject> GetDbObject() { }



        public TableSchema GetTableSchema(string tableName) { }

        public SPSchema GetSpSchema(string spName) { }



        /// <summary>

        /// 根据表结构， 获取创建表sql

        /// </summary>

        public string ToCreateTableScript(TableSchema tableSchema) { }



        /// <summary>

        /// 通过类型获取表结构

        /// </summary>

        public TableSchema GetEntitySchema(Type type) { }



        #endregion

    }

接口定义中， 大部分日常操作都能满足。 该接口同时可以满足获取DataTable及Orm方式。

DbSesion的嵌套调用

嵌套应用还是比较常用的， 尤其是在分层系统应用中。 很多底层方法都是完成特定功能的， 如获取单据号。 如下方法：

        public string GetBillId(string billType)

        {

            string result = string.Empty;



            BillTypeConfig billTypeConfig = null;



            DbSession dbSession = DbSession.Current;

            DateTime dateTime = DateTime.Today;



            string billDate = ""; // 当期， 如20121225， 201212.

            billTypeConfig = dbSession.Query<BillTypeConfig>(

                SqlCriteria.New.Equal("billtype", billType).Equal("billdate", billDate)).FirstOrDefault();



            if (billTypeConfig == null)

            {

                billTypeConfig = new BillTypeConfig();

                billTypeConfig.BillType = billType;

                billTypeConfig.BillDate = billDate;

                billTypeConfig.LastId = 1;

            }

            else

            {

                billTypeConfig.LastId = billTypeConfig.LastId + 1;

            }



            dbSession.Save(billTypeConfig);



            // 拼凑单据号



            return result;

        }

如没有上述代码中红色标注这一句， 一般实现要不就不管事务， 要不就需要将当前的访问数据库的上下文作为变量传进来。 若用DbSession.Current处理该类情况， 则十分的优雅， 该方法会自动根据调用方的连接走， 无论是换个连接， 还是是否启用事务。

简单ORM实现

所有的泛型QueryAPI其实都是先获取了DataTable后， 再进行ORM映射的。 之间的转换也是通过Emit动态生成接口（一个接口的实现）实现的。