Farseer.net轻量级ORM开源框架 V1.x 入门篇:数据库上下文
上文讲述了数据库配置使用,搭建好数据库的链接方式了我们知道怎么做了。
事实上,至今我们仍然还没有讲到代码方面,花了前面这么多篇幅讲解,主要是想由浅入深,不然一上来给大家讲解这讲解那的,听的也一头雾水,反而得不到效果。
这篇比较重要,因为它是我们在使用Farseer.Net时最基础的类:DbContext(与EntityFramework的DbContext一个概念)
从字面上,我们就知道:它是我们程序(业务)与数据库之间的沟通桥梁,在对表(实体类)进行CURD时,需要让实体类知道,我需要访问哪种数据库。
而数据库上下文,就是告诉我们的实体类,应该对哪个数据库类型进行连接访问。
在Farsser.Net里,数据库上下文对应的类便是:DbContext,这便是需要我们继承它,然后在这个类里面,封装我们需要的实体类的属性。
/// <summary> /// 通过数据库配置,连接数据库 /// </summary> /// <param name="dbIndex">数据库选项</param> protected DbContext(int dbIndex = 0) /// <summary> /// 通过自定义数据链接符,连接数据库 /// </summary> /// <param name="connectionString">数据库连接字符串</param> /// <param name="dbType">数据库类型</param> /// <param name="commandTimeout">SQL执行超时时间</param> protected DbContext(string connectionString, DataBaseType dbType = DataBaseType.SqlServer, int commandTimeout = 30)
带int dbIndex形参的构造函数,传入的便是DbConfig的配置索引项(假如我们配置了多个数据库的话)。
形参int dbIndex = 0 的默认设置,我们不需要额外的代码来设置它,除非你需要不同的数据库的配置。或者根据自己的业务需要通过自定义构造来达到运行时不同的数据库访问。
最后一个构造函数,是在我们不使用DbConfig数据库配置项的情况下,指定连接方式。
上面我们没有用到Web.Config(或者App.Config)配置项,事实上博主很不喜欢在Web.Config中进行设置自定义的配置项,感觉这会有“侵略”的感觉。
DbContext<TPo>,事实上这个类仅是多了一个属性:
/// <summary> /// 静态实例 /// </summary> public static TPo Data { get { return new TPo { IsMergeCommand = false }; } }
它仅仅是让我们不需要实例化using(var db = new DbContext())来调用。
很多时候,我们仅仅是一个很简单的操作。比如仅一条数据的插入:
// 插入数据 Table.Data.User.Insert(new UserVO() { UserName = "yy" });
而不需要:
using (var context = new Table()) { info = new UserVO() { UserName = "xx" }; // 插入数据 context.User.Insert(info, true); context.SaveChanges(); }
它继承自DbContext<TPo>的:
1 /// <summary> 2 /// 数据库上下文 3 /// </summary> 4 public class Table : DbContext<Table> 5 { 6 /// <summary> 7 /// 默认为0时,可不显示填写这一项,当前只是为了演示 8 /// </summary> 9 public Table() : base(0) { } 10 11 [Set(Name = "Members_User")] 12 public TableSet<UserVO> User { get; set; } 13 14 [Set(Name = "Members_Role")] 15 public TableSetCache<UserRoleVO> UserRole { get; set; } 16 [Set(Name = "Members_Orders")] 17 public TableSet<OrdersVO> Orders { get; set; } 18 19 [Set(Name = "Members_Orders")] 20 [SortDelete(Name = "IsDeleteByAt", FieldType = eumSortDeleteType.DateTime, Value = true)] 21 public TableSet<OrdersVO> OrdersAt { get; set; } 22 23 [Set(Name = "Members_Orders")] 24 [SortDelete(Name = "IsDeleteByBool", FieldType = eumSortDeleteType.Bool, Value = true)] 25 public TableSet<OrdersVO> OrdersBool { get; set; } 26 27 [Set(Name = "Members_Orders")] 28 [SortDelete(Name = "IsDeleteByNum", FieldType = eumSortDeleteType.Number, Value = 3)] 29 public TableSet<OrdersVO> OrdersNum { get; set; } 30 }
TableSet相当于EntityFramework的Set类,这在下一篇中才讲述。
/// <summary> /// 数据库提供者(不同数据库的特性) /// </summary> public AbsDbProvider DbProvider { get; private set; } /// <summary> /// 数据库操作 /// </summary> public DbExecutor DataBase { get; private set; } /// <summary> /// 执行数据库操作 /// </summary> public ExecuteSql Executeor { get; private set; } /// <summary> /// 映射关系 /// </summary> public ContextMap Map { get; private set; }
DbProvider:数据库提供者,不同的数据库类型都要有对应的实现类,比如有:SqlServerProvider。里面实现不同数据库的一些特性。
DataBase:是生成SQL之后最终提交到这里进行数据库交互。
Executeor:通过DataBase执行后返回的object/datatable类型进行泛型转换。它与DataBase的区别是它更区向业务上的数据类型。
Map:是指数据库上下文的映射信息,包括一些Property的信息。
/// <summary> /// 保存修改 /// IsMergeCommand=true时:只提交一次SQL到数据库 /// </summary> /// <param name="isOlation">默认启用事务操作</param> public int SaveChanges(bool isOlation = true)
根据方法命名,我们就可以联想到它是针对数据进行变更时进行的保存提交。
注意的是:对数据库的查询是不需要调用这个方法的,仅在对数据进行更新、删除、插入时,才需要调用。
但是,如果你是使用静态方式,即不需要new DbContext()方式时,也不需要调用SaveChanges的。这是提供的一种便利(语法糖)。
其带了个参数bool isOlation = true,为true时,会默认以事务的方式提交。如果您不希望这样,可以显示传入false。
通常在对数据库进行多次(一个逻辑里面)数据更新、插入时操作。当然这种方式保存的时候默认是开启事务的(查询不是),您也可以手动调用重截来不开启它:SaveChange(false);
值得注意的是:仅仅是对数据库的查询操作时,是不支持延迟执行的。换句话说,不需要调用context.SaveChange()方法。
但如果需要对数据进行更新、插入时,则必须调用。
但是如果用上文提供的静态方法,不管做何操作,也不需要调用SaveChange()。
我在重新说明下SaveChange()方法在什么时候使用:
- new实例化方式
- 需要数据进行更新(Update)、插入(Insert)
这一篇,大家学会了数据库上下文的代码编写了,虽然篇幅很长,但其实就是那么一回事,简单的不能再简单了。
QQ群:116228666 (Farseer.net开源框架交流) 请注明:Farseer.Net
Farseer.Net是一款ORM框架 + 常用工具 + 扩展集合。
Farseer 寓意:先知、预言家 通常在某些场合时,提供计谋、策略。也希望该框架能给大家提供最大化的便捷。
ORM:其英文全称是:Object(对象) Relational(关系) Mapping(映射)
Farseer.Net的目标是:快速上手、快速开发、简单方便。
1 Table.Data.User.Where(o=>o.ID == 1).ToEntity(); 2 Table.Data.User.Where(o=>o.ID > 1).ToList(); 3 Table.Data.User.Where(o=>o.ID != 0).Delete(); 4 Table.Data.User.Where(o=>o.ID != 0).AddUp(o=>o.LoginCount, 1); 5 Table.Data.User.Where(o=>o.ID == 1).Update(new User{ UserName = "newName" }); 6 Table.Data.User.Insert(new User{ UserName = "newName" });