ORM Best Practice-V1.0-20111028.docxVIP

文件编号作　　者程柏松文档版本V1.0最后修改日期2011-10-19ORM框架实践版本：V1.0编写人员：程柏松编写日期：2011-10-28修订历史记录日期版本说明撰叙2011年10月28日V1.0新建程柏核目 录1.概述32.详细设计说明32.1.实体类生成器32.1.1.EntityBuilder32.2.MDL SQL语句配置文件42.2.1.DataCommand42.2.2.DataCommandManager52.3.关于配置说明52.4.辅助工具82.4.1.Net Data 3Layers Objs.cst使用92.5.生成DataCommand配置92.6.DataCommand执行92.7.Demo单元测试11概述通过研究多方关于ORM框架，如：Nhibernate，一些开源的，以及广州提供的，现提取ORM中关键部分（数据到对象的Mapping），另外隔离SQL语句，避免拼接SQL字符串，特整理此文档。以上两点，也是MyCompany.Framework.Data下的关键功能。详细设计说明该类库主要包括的功能，从缓存(Cache)，配置文件（及XML文件），安全相关，字符串处理等其他功能项。实体类生成器EntityBuilder该类是读取通过DataRow，DataReader中的数据，通过与实体类中属性定义的Mapping信息来填充实体类。实现数据与实体之间的映射。类名namespace MyCompany.Framework.DataEntitypublic static class EntityBuilder方法public static T BuildEntityT(DataRow dr) where T : class, new()public static ListT BuildEntityListT(DataRow[] rows) where T : class, new()public static ListT BuildEntityListT(DataTable table) where T : class, new()internal static T BuildEntityT(IDataReader dr) where T : class, new()T entity = EntityBuilder.BuildEntityT(reader);MDL SQL语句配置文件DataCommand每个业务对应的SQL处理语句，都有一个唯一的CommandName，收录到多个按照模块划分的配置文件中。该类是和微软SqlCommand类似，可以把它看成SqlCommand。类名namespace MyCompany.Framework.DataAccesspublic class DataCommand : ICloneable, IDisposable方法直接返回传统数据类型的方法：public DataSet ExecuteDataSet()public DataTable ExecuteDataTable()public IDataReader ExecuteDataReader()public object ExecuteScalar()public int ExecuteNonQuery()直接返回泛型实体类的方法：public T ExecuteEntityT() where T : class, new()public ListT ExecuteEntityListT() where T : class, new()public T ExecuteScalarT()参数相关：public void SetParameterValue(string paramName, object val)public object GetParameterValue(string paramName)protected void AddInputParameterWithSize(string name, DbType dataType, int size, object value)事务相关的方法：public void CommitTransaction()public void RollbackTransaction()private void PrepareTransaction()在构造时就调用了。DataCommandManager先从配置文件中读取DataCommand对象，根据设定的数据库连接，用Parameters中声明的参数，执行CommandText语句。类名namespace MyCompany.Framework.DataAccesspubl