Entity Framework
我喜欢傻瓜化使用方式的框架,同时又不失灵活性。
EF虽然使用起来足够简单,但却不够灵活。例如,在EF Core中你无法用原生SQL写一个多表连接查询(返回的结果是多表连接的结果)
单表简单条件查询还好,多表查询时生成的SQL性能实在不敢恭维,我更喜欢自己写SQL,可控性更高,心里有底
EF的设计不利于项目的分层;我理想的设计是隔离、低耦合,和数据库打交道的事就交给Db层好了,所有数据库的特性都隔离在Db层内部,对外按业务提供傻瓜化的接口。
而使用EF你没法做到真正的隔离,因为即使能把SaveChanges封装在Db层,导航属性也会导致再次查询数据库。
Dapper
我喜欢它的轻量级,高性能。但它"只支持"原生SQL读写数据库,使用起来还是不太方便。
很多常用的情景其实可以封装一下不用写SQL的,像EF一样,直接Add一个Entity
虽然现在Dapper已经有了这样一个封装,但目前来看实在过于粗糙
PetaPoco
它可以像EF一样直接Add一个Entity,也可以像Dapper一样自己写原生SQL,按理说这已经很完美了。
但是,它不支持批量插入、更新啊
DapperPoco
在实在找不到满意框架的情况下,于是DapperPoco就诞生了,它是基于Dapper高度封装的,有Dapper的一切优点,同时也弥补了它的不足,它有如下特点:
高性能(与Dapper一致),以热启动后计算(第一次启动有缓存过程)
像EF一样使用简单,也可像Dapper一样灵活使用原生SQL
支持使用Fluent API定义实体映射
内部模块化灵活、可扩展
现已将其开源并放到了github上,地址为:https://github.com/md-frank/DapperPoco
如何使用
首先定义一个Poco类
//表示文章表里的一条记录public class Article { public long Id { get; set; } public string Title { get; set; } public string Content { get; set; } }
创建DbContext
class MasterDbContext : DbContext { protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) { optionsBuilder.UseConnectionString("连接字符串"); //使用SQL Server数据库 optionsBuilder.UseSqlAdapter(new SqlServerAdapter(SqlClientFactory.Instance)); } //如果不使用Poco可以不重写此方法 protected override void OnEntitiesBuilding(EntitiesBuilder entityBuilder) { //属性名与表列名(列名)不一样,可在此映射别名 entityBuilder.Entity() .TableName("T_Article") .ColumnName(p => p.Id, "article_id"); } }
插入数据
var masterDb = new MasterDbContext();//插入一个Poco对象var a = new Article { Title = "hello", Content = "hello word"}; masterDb.Insert(a);//插入了2条记录masterDb.Insert(new Article[] { a, a });//也可以显式指定表名masterDb.Insert(a, "T_Article");//原生SQL插入this.Execute("insert T_Article(Title, Content) values (@Title, @Content)", a);//插入了2条记录this.Execute("insert T_Article(Title, Content) values (@Title, @Content)", a, a);//插入了2条记录this.Execute("insert T_Article(Title, Content) values (@Title, @Content)", new Article[] { a, a });//也可以直接写参数值this.Execute("insert T_Article(Title, Content) values (@p0, @p1)", "hello", "hello word");
更新数据
var masterDb = new MasterDbContext();//先查出来准备更新var article = masterDb.FirstOrDefault("select * from T_Article where article_id = @p0", 1);//更新除主键外的所有列article.Title = "hello 2"; article.Content = "content 1"; masterDb.Update(article);//仅更新指定列,指定表列名article.Title = "hello 2"; masterDb.Update(article, new [] { "Title" });//仅更新指定列,指定实体属性名article.Title = "hello 3"; article.Content = "content 1"; masterDb.Update(article, null, null, p=> p.Title, p=> p.Content);
保存数据
var masterDb = new MasterDbContext();var article = new Article { Id = 1, Title = "hello", Content = "hello word"};//如果记录存在则更新,不存在则插入masterDb.Save(article);//保存并指定列名masterDb.Save(article, new [] { "Title" });
删除数据
var masterDb = new MasterDbContext();var article = masterDb.FirstOrDefault("select * from T_Article where article_id = @p0", 1);//删除实体记录masterDb.Delete(article);//删除实体记录,显式指定主键名masterDb.Delete(article, "article_id");
查询数据(立即执行)
var masterDb = new MasterDbContext();//查询T_Article表所有记录var articles = masterDb.FetchAll();//指定条件查询,直接写参数值var articles = masterDb.Fetch ("select * from T_Article where Title=@p0 and Content=@p1", "hello", "hello word");//指定条件查询,支持列表(实现了IEnumerable接口的)var articles = masterDb.Fetch ("select * from T_Article where article_id in @p0", new [] { 1, 2, 3 });//查询单条记录masterDb.FirstOrDefault ("select * from T_Article where article_id = @p0", 1);//查询单列var count = masterDb.ExecuteScalar ("select count(*) from T_Article");//查询分页的结果(第1页,每页20条)Paged paged = masterDb.Paged (1, 20, "select * from T_Article where Title=@p0", "hello");//Paged的定义如下public class Paged where T : new() { //当前页码 public int CurrentPage { get; set; } //总页数 public int TotalPages { get; set; } ///总记录数 public long TotalItems { get; set; } //每页记录数 public int ItemsPerPage { get; set; } //当前页记录列表 public List Items { get; set; } }
查询数据(延迟执行)
延迟查询使用Query,与Fetch不同的是Query返回的结果只有在使用时才会真正查询数据库
var masterDb = new MasterDbContext();//延迟查询var articles = masterDb.Query("select * from T_Article where Title=@p0", "hello");
动态查询条件
var title = "此变量来自用户输入";var sb = new SqlBuilder(); sb.Append("select * from T_Article");if(!string.IsNullOrEmpty(title)) sb.Append("where Title=@p0", title);var sql = sb.Build();var articles = masterDb.Fetch(sql.Statement, sql.Parameters);
事务支持
using (var trans = this.GetTransaction()) { //这里修改数据库 //提交事务 trans.Complete(); }