.Net orm 开源项目 FreeSql 2.0.0（满意的答卷）

写在开头

2018年11月头脑发热到今天，一晃已经两年，当初从舒服区走向一个巨大的坑，回头一看后背一凉。

两年时间从无到有，经历数不清的日夜奋斗（有人问花了多长时间投入，答案：全职x2 + 两年无休息）。

今天 FreeSql 已经很强大，感谢第一批、第二批、第N批持续提出建议的朋友，总算给社区交了一个满意答卷。

v2.0.0 是一个稳定的版本，主要体现：

• 用户 API 已经肯定，不会轻易推翻又做调整，坚持五年不变的原则，让使用者真真正正的再也不关心 ORM 使用问题；
• 单元测试覆盖面广，5500+个单元测试，小版本更新升级无须考虑修东墙、补西墙的问题；
• 经历两年时间的生产考验，nuget下载量已超过25万，平均每日350+；

感叹：有些人说 .Net 陷入 orm 怪圈，动手的没几个，指点江山的一堆，.Net orm 真的如他们所讲的简单吗？

项目简介

舒适提醒：如下内容无商吹成份，FreeSql 不打诳语

舒适提醒：如下内容无商吹成份，FreeSql 不打诳语

舒适提醒：如下内容无商吹成份，FreeSql 不打诳语

FreeSql 是 .Net ORM，能支持 .NetFramework4.0+、.NetCore、Xamarin、MAUI、Blazor、以及还有说不出来的运行平台，由于代码绿色无依赖，支持新平台很是简单。目前单元测试数量：5400+，Nuget下载数量：260K+，源码几乎天天都有提交。值得高兴的是 FreeSql 加入了 ncc 开源社区：https://github.com/dotnetcore/FreeSql，加入组织以后社区责任感更大，须要更努力作好品质，为开源社区出一份力。

QQ群：4336577(已满)、8578575(在线)、52508226(在线)

为何要重复造轮子？

FreeSql 主要优点在于易用性上，基本是开箱即用，在不一样数据库之间切换兼容性比较好。做者花了大量的时间精力在这个项目，肯请您花半小时了解下项目，谢谢。FreeSql 总体的功能特性以下：

• 支持 CodeFirst 对比结构变化迁移；
• 支持 DbFirst 从数据库导入实体类；
• 支持 丰富的表达式函数，自定义解析；
• 支持 批量添加、批量更新、BulkCopy；
• 支持 导航属性，贪婪加载、延时加载、级联保存；
• 支持 读写分离、分表分库，租户设计；
• 支持 MySql/SqlServer/PostgreSQL/Oracle/Sqlite/Firebird/达梦/神通/人大金仓/翰高/MsAccess Ado.net 实现包，以及 Odbc 的专门实现包；

5500+个单元测试做为基调，支持10多数数据库，咱们提供了通用Odbc理论上支持全部数据库，目前已知有群友使用 FreeSql 操做华为高斯、mycat、tidb 等数据库。

安装时选择对应的数据库包：

dotnet add packages FreeSql.Provider.MySql

CodeFirst

FreeSql 使用 CodeFirst 模式开发，简直不要再简单，只须要以下定义：

static IFreeSql fsql = new FreeSql.FreeSqlBuilder()
    .UseConnectionString(FreeSql.DataType.MySql, @"Data Source=127.0.0.1;Port=3306;User ID=root;Password=root;Initial Catalog=cccddd_mysqlconnector;Charset=utf8;SslMode=none;Max pool size=10")
    .UseAutoSyncStructure(true) //自动同步实体结构到数据库
    .UseMonitorCommand(cmd => Console.WriteLine(cmd.CommandText + "\r\n")) //打印 SQL
    .Build(); //请务一定义成 Singleton 单例模式

UseAutoSyncStructure(true) 这个设置开启自动迁移功能，啥意思？以下实体类：

class Blog {
    [Column(IsIdentity = true, IsPrimary = true)]
    public int BlogId { get; set; }
    public string Url { get; set; }
    public int Rating { get; set; }
}

fsql 对 Blog 进行 CRUD 时，好比：

fsql.Select<Blog>().First();
fsql.Select<Blog>().First();

会执行 SQL 以下：

CREATE TABLE IF NOT EXISTS `cccddd_mysqlconnector`.`Blog` (  
  `BlogId` INT(11) AUTO_INCREMENT, 
  `Url` VARCHAR(255), 
  `Rating` INT(11) NOT NULL, 
  PRIMARY KEY (`BlogId`)
) Engine=InnoDB;

SELECT a.`BlogId`, a.`Url`, a.`Rating` 
FROM `Blog` a 
limit 0,1

SELECT a.`BlogId`, a.`Url`, a.`Rating` 
FROM `Blog` a 
limit 0,1

程序运行过程当中，首次 CRUD 操做实体类会建立表，以后再也不执行该操做。

这是表不存在的状况，若是表存在的时候会怎样？会对比更新结构。FreeSql 对比表结构和实体类的差别部分，执行迁移尽可能保证不丢数据（没法100%保证，请三思使用在生产环境）

除了自动迁移功能，咱们还提供以几个经常使用 API fsql.CodeFirst 方法：

方法	返回值	参数	说明
GetComparisonDDLStatements	string	Type	将实体类型与数据库对比，返回DDL语句
SyncStructure	bool	Type	同步实体类型到数据库
ConfigEntity	ICodeFirst	Action<TableFluent<T>>	FluentAPI 配置实体的特性
GetTableByEntity	TableInfo	Type	获取类型在ORM内部的元数据

实体特性

.NET ORM 几乎都是经过实体与表进行映射，怎么少得了灵活的特性设置呢。

提示：FreeSql 能够自动识别 EFCore 实体特性 Key/Required/NotMapped/MaxLength/StringLength/DatabaseGenerated/Table/Column

[Table(Name = "topic")]
class Topic {
    [Column(IsPrimary = true, IsIdentity = true, Name = "id")]
    public int Id { get; set; }
}

如上 Name 设置实体类与数据库小写映射，其实还提供统一处理的方法：

static IFreeSql fsql = new FreeSql.FreeSqlBuilder()
    //..
    UseNameConvert(NameConvertType.ToLower)
    //..
    .Build();

// PascalCaseToUnderscore: BigApple -> Big_Apple
// PascalCaseToUnderscoreWithUpper: BigApple -> BIG_APPLE
// PascalCaseToUnderscoreWithLower: BigApple -> big_apple
// ToUpper: BigApple -> BIGAPPLE
// ToLower: BigApple -> bigapple
// 感谢【晓晨】提供的这个思路和功能

CRUD

FreeSql CRUD 命名习惯听从 SQL，代码写起来就像写 SQL 同样，以下：

• 插入数据：fsql.Insert(item).ExecuteAffrows();
• 更新数据：fsql.Update<T>().Where(..).Set(..).ExecuteAffrows();
• 删除数据：fsql.Delete<T>().Where(..).ExecuteAffrows();
• 查询数据：fsql.Select<T>().Where(..).ToList();

Repository

FreeSql.Repository 做为扩展，实现了通用仓储层功能。与其余规范标准同样，仓储层也有相应的规范定义。FreeSql.Repository 参考 abp vnext 接口，定义和实现基础的仓储层（CURD），应该算比较通用的方法吧。仓储能够：

• Select/Attach 快照对象，Update 只更新变化的字段；
• Insert 插入数据，适配各数据库优化执行 ExecuteAffrows/ExecuteIdentity/ExecuteInserted；
• InsertOrUpdate 插入或更新；
• SaveMany 方法快速保存导航对象（一对多、多对多）；
• UnitOfWork 工做单元设置；

导航属性

微软制造了优秀的语言 c#，利用语言特性能够作一些很是好用的功能，在 ORM 中使用导航属性很是适合。

• FreeSql ManyToOne(N对1) 提供了简单的多表 join 查询；

• FreeSql OneToMany(1对N) 提供了简单可控的级联查询、级联保存功能；

• FreeSql ManyToMany(多对多) 提供了简单的多对多过滤查询、级联查询、级联保存功能；

• FreeSql 父子关系 提供了经常使用的 CTE查询、删除、递归功能；

关于导航属性，咱们写了一篇专门介绍的文章，可跳转查看：.NET ORM 导航属性【到底】能够解决什么问题？

分表分库

关于分表分库，咱们写了一篇专门介绍的文章，可跳转查看：.NET ORM 分表分库【到底】怎么作？

事务

关于事务，咱们写了一篇专门介绍的文章，可跳转查看：.NET 数据库事务的各类玩法进化

写在最后

FreeSql 2.0.0 他是免费自由的 ORM，也能够说是宝藏 ORM。更多文档请前往 wiki 查看。

下一个五年，期待少年的你还能归来在此贴回复，兑现五年不变的承诺。

多的不说了，但愿民间的开源力时愈来愈强大。

但愿做者的努力能打动到你，请求正在使用的、善良的您能动一动小手指，把文章转发一下，让更多人知道 .NET 有这样一个好用的 ORM 存在。谢谢！！

FreeSql 使用最宽松的开源协议 MIT https://github.com/dotnetcore/FreeSql，彻底能够商用，文档齐全。QQ群：4336577(已满)、8578575(在线)、52508226(在线)