Remark:
原题为《简单ORM框架设计》,本想以一个系列讲解框架的代码,而今已经提供链接下载源码,且苦于文笔错顿,于是就改一下介绍这个框架的使用。
开源项目:http://dlite.codeplex.com/
源码下载链接:Known.DLite
Known.DLite是一个简单ORM框架,它是我的第一个开源项目,也是我的练习作品。虽然想法有些简单,思路有些混乱,代码不够严谨,性能不够优越,安全考虑不周,功能存在不全,但是比较满意的是它基本上完成了所需的功能,达到了我学习的目的,将我的思路实现了一遍。这个项目遗憾的是没有做单元测试。
在此将项目发布出来,一是大家共同学习,二是请大家拍砖扶正一些错误,三是交流一下。
首先有必要再此声明一下,这个作品只作学习之用,不作项目应用,因为目前成熟稳定的ORM框架已经比比皆是,而且这个作品也不成熟。
下面简单介绍一下这个框架的设计思路。思路,也就是贯穿整个框架程序的一条线路,正因为有它,整个程序代码才能够紧密的联系在一起。Known.DLite借鉴了DLinq的部分设计思想,主要是通过C#语言的“特性”将实体及其属性映射成数据库表的关系,自动组建CRUD操作命令语句,通过配置数据库提供者来执行操作。下图是项目的结构。
从上图中可以看出,Known.DLite、Known.DLite.Clients、Known.DLite.Mapping三个命名空间。
Known.DLite命名空间下是提供对象访问操作和提供者配置的一些类别。如命令类,命令参数类,提供者接口,提供者配置及配置单项,提供者异常,提供者工厂,查询(取了一个名字叫KQuery),事务操作。
Known.DLite.Clients命名空间下提供的是具体提供者实现类别,目前提供三种数据库的操作,分别是Access、SQL Server、Oracle。
Known.DLite.Mapping命名空间下是对对象映射的一些处理,如表特性,列特性,元数据类型(这是一个抽象类别,考虑映射还有XML映射方式,这里只实现了特性映射方式。),元数据参数,元数据管理,还有一个实体基类,这个类放在这个命名空间下有争议。我本不想写这个类的,但是为了简化实体类,将实体类重复的代码抽出来,所有才写了进来。写的时候不知道该放在那个命名空间下,想来想去,为了少using一个空间名,于是就放在这里。
Known.DLite大体上就是这个样子,其实里面还用到一些缓存技术,主要缓存元数据参数。另外可以实现实体继承操作,意思是一个实体类继承另一个实体,照样可以进行CRUD操作。
示例代码:
实体类
[Table("ks_User")] public class UserInfo : BaseEntity<UserInfo> { [Column(IsDbGenerated = true, IsPrimaryKey = true)] public int ID { get; set; } [Column(IsChangeable = false)] public string UserName { get; set; } public string Password { get; set; } [Column(IsNullable = true)] public string Question { get; set; } [Column(IsNullable = true)] public string Answer { get; set; } public string Email { get; set; } public override string ToString() { return String.Format( "ID={0}<br />UserName={1}<br />Password={2}<br />Question={3}<br />Answer={4}<br />Email={5}<br />", ID, UserName, Password, Question, Answer, Email ); } }
增删改
public partial class _Default : System.Web.UI.Page { protected void Page_Load(object sender, EventArgs e) { if (!String.IsNullOrEmpty(Request.QueryString["id"])) { int id = int.Parse(Request.QueryString["id"]); UserInfo user = UserInfo.Get(id); Response.Write(user.ToString()); Response.Write(user.ToJson()); } btnAdd.Click += new EventHandler(btnAdd_Click); btnUpdate.Click += new EventHandler(btnUpdate_Click); btnDelete.Click += new EventHandler(btnDelete_Click); BindData(); } void btnDelete_Click(object sender, EventArgs e) { int id = int.Parse(Request.Form["ID"]); UserInfo user = UserInfo.Get(id); user.Delete(); user.Save(); BindData(); } void btnUpdate_Click(object sender, EventArgs e) { int id = int.Parse(Request.Form["ID"]); UserInfo user = UserInfo.Get(id); user.Password = "555555"; user.Update(); user.Save(); BindData(); } void btnAdd_Click(object sender, EventArgs e) { UserInfo user = new UserInfo { UserName = Request.Form["UserName"], Password = Request.Form["Password"], Question = Request.Form["Question"], Answer = Request.Form["Answer"], Email = Request.Form["Email"] }; user.Insert(); user.Save(); BindData(); } private void BindData() { gvUser.DataSource = UserInfo.FindAll().OrderBy(u => u.ID); gvUser.DataBind(); } }
配置信息
<?xml version="1.0" encoding="utf-8" ?> <providers> <provider name="DefaultProvider"> <assembly>Known.DLite</assembly> <clazz>Known.DLite.Clients.SqlProvider</clazz> <connString>Data Source=.\SQLEXPRESS;AttachDbFilename=|DataDirectory|\Database.mdf;Integrated Security=True;User Instance=True</connString> </provider> </providers>
源码下载链接:Known.DLite
1.简单ORM框架设计1——实体
2.简单ORM框架设计2——实体操作
3.简单ORM框架设计3——实体提供者
4.简单ORM框架设计4——提供者配置及异常
5.简单ORM框架设计5——映射