项目地址 :  https://github.com/kelin-xycs/SimpleEntity

SimpleEntity

一个 用 C# 实现的 简单的 持久层 Entity 实现 。

这是一个 用 C# 实现的 简单的 持久层 Entity 实现 。

和 其它的 持久层 框架 不同 , Simple Entity 并不打算 提供一个 抽象层 来 封装 和 隐藏 关系数据库 。 相反 , 在 SimpleEntity 的 设计 里 , 应用程序 和 关系数据库 之间 是 完全 公开 透明 自由 的 。 SimpleEntity 提供 对象 的 方式 来 访问 数据库 , 帮助 开发 更便捷 , 设计 更清晰(结构化 对象化) 。

SimpleEntity 提供了 一个 DbContext 类 。

DbContext 类 包含 Save(object entity) , Update(object entity) , UpdateNull(string[] columnNames, object id) , Delete(object id) , Flush() , Get(object id) , List Get(object[] ids) 方法 。

Save(object entity) 方法 将 entity Insert 到 数据库 表 中 ;

Update(object entity) 方法 Update entity 对应 的 表 资料 , 只 Update 不为 null 的 Property , 换句话说 , 要 Update 哪个(哪些) 栏位 , 就对 对应 的 Property 赋值 就行 。 不 Update 的 Property 不赋值 。

UpdateNull(string[] columnNames, object id) 方法 用于 将 指定 的 栏位 Update 为 null , 有些时候, 需要 将 某些 栏位 Update 为 null , 就 可以 使用 UpdateNull() 方法 。

Delete(object id) 方法 删除 表 资料 。 参数 id 为 主键 。 只支持 单一列 作为 主键 。 不支持 多列联合主键 。 这也是 OR Mapping 里的 一个 惯例 吧 。

Flush() 方法 将 Save() Update() UpdateNull() Delete() 方法 的 更新结果 提交 到 数据库 。 只有 Flush() 方法 才会 访问 数据库 。 Save() Update() UpdateNull() Delete() 方法 只是 将 更新 转换成 Sql 和 Sql参数 保存起来 。 在 Flush() 的 时候 才 会 批量(Batch)提交 到 数据库 。

Get(object id) 方法 根据 id 返回 entity , id 是 主键 。

List Get(object[] ids) 方法 根据 ids 返回 entityList , ids 是 一组 主键 。 这样可以 一次 返回 多个 主键 的 entity 对象 。

DbContext 是 线程级 的 操作 。 是 线程 安全 的 。 就是说, 在 一个 线程 里 , 可以在 任意个地方 创建任意个 new DbContext() 对象 。 效果 都 一样 。 相同 DB 配置(Connection String, Provider) 的 DbContext 的 更新操作 , 最终都会在 Flush() 方法 里 提交到 数据库 。

为了 更 清楚 的 说明 这一点 , 我们 看一下 这部分 的 实现原理 :

DbContext 实际的 操作 是 调用 SqlClientManager , SqlClientManager 是 实现 IActiveRecordManager 接口 的 一个类 。

SqlClientManager 会把 Save Update Delete 操作 转换 为 Sql 和 Sql参数 , 分别 存在 _sqlList , _paraList 两个 静态变量 里 。 这 2 个 静态变量 是 [ThreadStatic] 标记 标注 的 静态变量 。 就是说, 它们 和 普通的 静态变量 不同, 是 线程级 的 静态变量 。 每个 线程 都有 自己的 这 2 个 静态变量 。

从上面可以看出 , 目前 SimpleEntity 只 支持 SqlServer , 如果 想 支持 别的 数据库 , 比如 Oracle , 那么 可以 新增一个 类 OracleClientManager , 实现 IActiveRecordManager 接口 , 然后 , 把 SqlClientManager 拷贝 过去 稍微 修改 一下 就可以了。 啊 哈哈哈

关于 事务(Transaction) , 可以使用 TransactionScope(System.Transactions.TransactionScope) 。 将 Flush() 放在 TransactionScope 中 就行 。

可以在 Demo 项目 中 查看 Demo , Test.aspx 是 测试 Save Update 等 各种操作 的 页面 , ManageDB.aspx 是 管理 测试 DB 的 页面 , 可以执行 Sql 。

因为 项目 使用 的 是 Asp.net 内置 SqlServer (LocalDb) , 所以 用 一个 ManageDB.aspx 页面 来 管理 DB 。

Demo 项目 是 一个 “Asp.net Web 窗体 项目” , 这个 内置 SqlServer 就是 创建项目 时 自动生成 的 。 mdf ldf 文件 存放在 项目 的 App_Data 文件夹 里 。 创建项目 时 还自动生成了 很多 其它 的 东西 , 我 把 那些 不需要 的 部分 删除 了 。

最新文章

  1. 文本框 textarea 动态显示行数(简单文本编辑器)
  2. XP---------专区(Windows Exprience)--体验的简写
  3. 你知道吗?使用任何HTML5开发工具都可开发iOS、Android原生App
  4. 共享你的控件 -- 用NuGet包装自己的控件
  5. C#添加测量运行时间
  6. OpenCV-paper detection & perspective transformation 相关资料
  7. maven pom.xml示例
  8. 【bzoj1037】 ZJOI2008—生日聚会Party
  9. c++ queue 顺序队列的实现
  10. 【转】MYSQL入门学习之一:基本操作
  11. 答辩ppt
  12. shell脚本循环执行mysql语句
  13. ios开发--编码格式
  14. php 二维数组以树形输出(转)
  15. 流Stream个人学习理解
  16. HDU 5724 - Chess
  17. git将本地项目添加到github远程仓库
  18. 基于Dubbo的分布式事务框架(LCN)
  19. MySQL高级学习笔记
  20. python中删除某个元素的3种方法

热门文章

  1. Convert the AScii to SAC file
  2. Linux文件系统命令 ln
  3. Mybatis级联,使用JOIN和Associa,以及一些ID覆盖和自动变换。
  4. Spring学习六(事物管理)
  5. 阻止ARP欺骗
  6. 【转】C++类内存分布
  7. Python学习笔记第十二周
  8. (6个name="hobby"的复选项,两个按钮)来区分三种方法的不同---区别getElementByID,getElementsByName,getElem
  9. make clean,make distclean与make depend的区别
  10. 百练6247-过滤多余的空格-2015正式B题