[开源] FreeSql 配套工具，基于 Razor 模板实现最高兼容的生成器

阅读量：5256 次

发布时间：2019-06-14

本文共 5565 字，大约阅读时间需要 18 分钟。

FreeSql 经过半年的开发和坚持维护，在 0.6.x 版本中完成了几大重要事件：

1、按小包拆分，每个数据库实现为单独 dll；

2、实现 .net framework 4.5 支持；

3、同时支持 MySql.Data、MySqlConnector 的实现；

4、自定义导航属性关系的配置；

5、配套工具 FreeSql.Tools 发布；

本文主要讲解第5项《FreeSql.Tools》，大主角往往在最后才出现！！！

拆分小包

在此之前一直被吐槽 FreeSql 臃肿，没有小包开发理念。其实我是一点也不承认这种评价，虽然刚开始只有一个 FreeSql.dll，但是在开发和规划上简单了很多。

有一条开发原则这样讲道：过早优化是恶梦！

大概意思是无论做什么项目，不要想着一开始就过度系统的、规范的执行。从外界来看是正规了，但是进度和稳定性会大大折扣。可以不信我，但是请一定要相信前人的总结啊！！！

从之前的一个 dll 到拆分成小包，我们总共耗时两天，虽然都在一个项目内开发，但其实耦合性并不高，so easy！！

车到山前必有路，时机到了自然会拆。这个时机也是奠定 FreeSql 走出了稳定关键的一步。这样会有更多人愿意加入 FreeSql 阵营。

各数据库单独包、延时加载包；

FreeSql.Extensions.LazyLoading

FreeSql.Provider.MySql

FreeSql.Provider.PostgreSQL

FreeSql.Provider.SqlServer

FreeSql.Provider.Sqlite

FreeSql.Provider.Oracle

支持 .netframework 4.5

早期 FreeSql 主要是在 .net core 最方便的 ORM！NETStandard 是新的标准，然而前段时间微软又说 ..net5 将合并。。。变化真的太快。

在实现拆分小包后，其实 FreeSql 的模块更加清淅，并且依赖项非常之少，然后比较容易的做出了 4.5 framework 的适配。

目前支持的版本：

Package Name	Version
FreeSql.Provider.MySql	NETStandard2.0、net452
FreeSql.Provider.PostgreSQL	NETStandard2.0、net45
FreeSql.Provider.SqlServer	NETStandard2.0、net451
FreeSql.Provider.Sqlite	NETStandard2.0、net45
FreeSql.Provider.Oracle	NETStandard2.0、net45
FreeSql.Extensions.LazyLoading	NETStandard2.0、net45

MySqlConnector 的实现

mysql 是一个神奇的流行数据库，在 .net 阵营中使用量排名老二。mysql 的版本五花八门，从 5.6 开始有了不同的分支，分支的出现使得 ado.net 驱动不通用。

很多人不推荐使用 MySql.Data 官方驱动，但是 FreeSql 一直在使用官驱，并且支持了所有 5.6 类型，包括 enum/set 等。

然后就有一些人，特别是高手的那些来提出要求，适配一个 MySqlConnector 的实现，然后著名的 A大（茶叔)提了一道 PR ，创建了 FreeSql.Provider.MySqlConnector 项目，99.9999% 源码和原来 FreeSql.Provider.MySql 相同，经过 266 个单元测试后发现，只需要兼容 enum/set 类型，参数化 ? @ 的处理就跑通了。然后就有了现在新的驱动包：

Package Name	Version
FreeSql.Provider.MySqlConnector	NETStandard2.0、net45

然后 FreeSqlBuilder 使用反射决定使用哪个 mysql 驱动。代码如下：

public IFreeSql
    
      Build
     
      () {    if (string.IsNullOrEmpty(_masterConnectionString)) throw new Exception("参数 masterConnectionString 不可为空，请检查 UseConnectionString");    IFreeSql
      
        ret = null;    Type type = null;    switch(_dataType) {        case DataType.MySql:            type = Type.GetType("FreeSql.MySql.MySqlProvider`1,FreeSql.Provider.MySql")?.MakeGenericType(typeof(TMark));            if (type == null) type = Type.GetType("FreeSql.MySql.MySqlProvider`1,FreeSql.Provider.MySqlConnector")?.MakeGenericType(typeof(TMark));            if (type == null) throw new Exception("缺少 FreeSql 数据库实现包：FreeSql.Provider.MySql.dll，可前往 nuget 下载");            break;        case DataType.SqlServer: type = Type.GetType("FreeSql.SqlServer.SqlServerProvider`1,FreeSql.Provider.SqlServer")?.MakeGenericType(typeof(TMark));            if (type == null) throw new Exception("缺少 FreeSql 数据库实现包：FreeSql.Provider.SqlServer.dll，可前往 nuget 下载");            break;        case DataType.PostgreSQL: type = Type.GetType("FreeSql.PostgreSQL.PostgreSQLProvider`1,FreeSql.Provider.PostgreSQL")?.MakeGenericType(typeof(TMark));            if (type == null) throw new Exception("缺少 FreeSql 数据库实现包：FreeSql.Provider.PostgreSQL.dll，可前往 nuget 下载");            break;        case DataType.Oracle: type = Type.GetType("FreeSql.Oracle.OracleProvider`1,FreeSql.Provider.Oracle")?.MakeGenericType(typeof(TMark));            if (type == null) throw new Exception("缺少 FreeSql 数据库实现包：FreeSql.Provider.Oracle.dll，可前往 nuget 下载");            break;        case DataType.Sqlite: type = Type.GetType("FreeSql.Sqlite.SqliteProvider`1,FreeSql.Provider.Sqlite")?.MakeGenericType(typeof(TMark));            if (type == null) throw new Exception("缺少 FreeSql 数据库实现包：FreeSql.Provider.Sqlite.dll，可前往 nuget 下载");            break;        default: throw new Exception("未指定 UseConnectionString");    }    ret = Activator.CreateInstance(type, new object[] { _masterConnectionString, _slaveConnectionString }) as IFreeSql
       
        ;    if (ret != null) {        ret.CodeFirst.IsAutoSyncStructure = _isAutoSyncStructure;                ret.CodeFirst.IsSyncStructureToLower = _isSyncStructureToLower;        ret.CodeFirst.IsSyncStructureToUpper = _isSyncStructureToUpper;        ret.CodeFirst.IsConfigEntityFromDbFirst = _isConfigEntityFromDbFirst;        ret.CodeFirst.IsNoneCommandParameter = _isNoneCommandParameter;        ret.CodeFirst.IsLazyLoading = _isLazyLoading;        var ado = ret.Ado as Internal.CommonProvider.AdoProvider;        ado.AopCommandExecuting += _aopCommandExecuting;        ado.AopCommandExecuted += _aopCommandExecuted;    }    return ret;}

自定义导航属性关系的配置

FreeSql 原先支持约定式导航关系配置，对于新项目开发无疑可约定，但是很多老项目命名不规范的就使用不了相关的功能。

有关约定配置可参考 github wiki 中心文档

QQ 开发群真是个好平台，在发起讨论后，各位大佬都纷纷提出建议，最后以一票否决了各大建议，哈哈。。

主要从语法和用户使用的感受上设计，还是那个理念：日式简约！不能加入太多特性和功能，增加用户的理解和使用成本。

最终效果如下：

//导航属性，OneToMany[Navigate("Song_id")]public virtual List
    
      Obj_song_tag { get; set; }//导航属性，ManyToOne/OneToOne[Navigate("Song_id")]public virtual song Obj_song { get; set; }[Navigate("Tag_id")]public virtual tag Obj_tag { get; set; }

然后就能使用很多导航的骚操作功能了。