从壹开始先后端分离 42 ║支持多种数据库 & 快速数据库生成

缘起

 哈喽你们周三好，休息了一段时间，打算准备找工做了🙃，wuli亲故有帮忙内推么，因此平时的更新学习就停滞了，不过群里的问题，我仍是尽可能一直在回答的。。。

今天的内容很简单，不是一个技术文章，仅仅是一个项目更新文档，给正在使用这个框架的小伙伴一个时间线，否则的话下次再 pull code 的时候，一看，又是更新一片，并且也不知道更新了啥。若是你是铁粉读者的话(至少读完第一个系列吧)，确定知道我以前是写过《38 ║自动初始化数据库》了，这篇文章也是关于如何经过项目，自动生成数据库的，那你确定疑惑了，为啥还要写？这里有几个契机：

一、准备面试，HR打电话，很神奇的是，几乎每一个人都问了是否会 MySql 或者 Oracle ？

二、平均每周都有不少小伙伴问：这个后端项目的数据库数据在哪？执行报错？

三、群里使用MySql的愈来愈多了，也是一直问我：你这个后端项目是否匹配 MySql ？

四、SqlServer 在跨平台上真的难 ！ 

五、本想找伙伴帮我一块儿维护项目，可怜没人😂

六、每次修改数据库，都须要生成sql脚本文件，麻烦！之后sql脚本不维护了，走下文的流程。

 欸~聪明的你看到这几个问题，确定就知道为啥要写这个，没错，就像是文章标题那样，想项目同时支持多个数据库，而且可配置的生成对应数据库，只需一键，就可快速切换任何数据库。

我这周简单学了学 MySql ，虽然大学的时候本身玩儿过，可是很久没有用了，几乎都忘了，趁着此次好好研究研究 MySql ，玩儿了两天，而后整合了下项目，也完美的支持了 MySql ！你能够在配置文件中，一键操做，就能够随心的切换本身喜欢的数据库，之后还会融入其余数据库（好比Oracle啥的）、主从分离等数据库技术，挖个坑之后再看。固然这里也重点夸凯旋兄，SqlSugarCore 多数据库支持完美。

 

好啦，内容很简单，就很少铺垫了，开门见山，主要说说哪里作了更新，以及第一次用我框架的小伙伴，如何操做。

 

1、初次见面，如何玩转项目？

有不少小伙伴，第一次使用，刚刚下载的时候，就被 数据库 和 Reids 搞得心烦意乱，我这里就重点说一下吧，之后这个能够做为 Blog.Core 项目的使用手册。

目前项目已经支持 Sqlserver、MySql、Oracle、Sqlite四种数据库，项目默认启动是Sqlite，你们什么都不用操做，只须要直接运行，就能看到效果，只须要开启阀门便可：

打开这两个，就能够直接使用数据了，不须要配置任何数据库环境！

  

若是你用其余的数据库也同理，这里以 Mysql 举例来讲（更新：目前最新代码 sugar5.0 已经支持本身建立数据库了，无需手动建立空数据库）：

 

 

 

一、配置数据库链接字符串

注意若是要使用 Mysql，记得要 引用 MySql.Data.dll 包。

感谢 @ 守墓老人 提建议

这里不须要安装mysql.data.dll，只须要安装sqlsugarcore一个nuget包就行。

关于数据库链接字符串，这里有个小伙伴总结的挺好的《各类数据库的链接字符串》，我打算之后也学学 SQLite 、Oracle 、PostgreSQL 啥的，权当练练手了。

这个很简单，我在 Blog.Core ->  appsettings.json 文件中，新增了两个节点：

    "SqlServer": {
      "Enabled": false,//这个是开启对应数据库的阀门，都开启的话，优先级越靠上越高。 "SqlServerConnection": "Server=.;Database=WMBlogDB;User ID=sa;Password=123;",//配置链接字符串，能够参考上边的文章中查找 "ProviderName": "System.Data.SqlClient" //暂时无用
    },
    "MySql": {
      "Enabled": true,
      "MySqlConnection": "Server=localhost; Port=3306;Stmt=; Database=wmblogdb; Uid=root; Pwd=456;"
    },

 

多个数据库目前是互斥的，也就是优先采用最上边开启阀门的数据库，若是你想开启其余数据库，好比 Sqlite ，Oracle ，能够顺着开启节点就行，目前 SqlSugar 支持这些数据库，我尽可能都加上：

  public enum DataBaseType
  {
      MySql = 0,
      SqlServer = 1,
      Sqlite = 2,
      Oracle = 3,
      PostgreSQL = 4
  }

 

 

二、启动种子生成阀门 

 配置好链接字符串后，剩下的就是很简单了，直接在下边的 SeedDBEnabled 启动 true 便可，以前是须要在代码 program.cs 中手动注释或取消注释，来实现的，如今移植到了配置文件里：

 

program.cs ：

 

 

由于SqlSugar 不像 EFCore 那样有迁移，因此 Sqlsugar 不能本身建立数据库，因此咱们须要手动建立一个空的数据库，这个很重要不要忘记。

SqlSugar 5.x 版本已经能够支持自动建立数据库了，因此若是你是 5.x+ 版本，能够不用手动建立数据库，反之须要手动建立空的数据库。

这个时候你只须要运行项目便可，当前若是有问题，你须要清理解决方案，再执行。由于我用的是在线数据，可能数据比较慢，稍微等待。

 

三、对了，还有那个 Redis 配置

可能第一次使用，有的小伙伴不知道如何开启 Redis ，请参考个人文章 ：《什么是Redis，为何使用它》 ，并且要注意端口号我改为了 6319 ，不是默认的6379，具体的链接字符串，你依然能够在 appsettings.json 文件中配置：

 

四、最后还有 AOP 服务相关阀门

项目中写了三处 AOP 相关服务，分别是 日志AOP，内存缓存AOP，Redis缓存AOP，若是你想开启对应的服务，只须要在配置文件中开启便可，这三个能够相互叠加的，不是互斥的：

 

 若是你想了解 AOP  以及他所应用的地方，请查看个人这篇文章：《完美基于AOP的接口性能分析》

如今已经很轻松的收集到项目中用到的全部日志了，包括，操做日志+异常日志+Sql日志：

 

 

 

 

五、在Swagger中展现 Sql 执行日志 

操做很简单，功能颇有效，动图以下，快速查看在线Demo：http://123.206.33.109:8081：

 

固然这个 swagger 里不只有SQL日志，还有异常日志，更多功能，等待你的开发：

 

 

2、总体 Seed 开发流程是怎样的？

一、配置数据库初始化参数

为了更好的实现项目的自动化和高效性，一个框架就要尽可能的减小用户的操做步骤，甚至不能修改代码，只须要配置文件就能达到相应的要求，因此我就想着把项目中须要配置的地方，都移植到 appsettings.json 文件里，目前也差很少实现了这个目标，那既然有配置，就必定要有初始化的地方，否则项目如何启动呢？没错，就拿数据库参数初始化举例：

在 Blog.Core.Common -> DB -> BaseDBConfig.cs 中，我这里对数据库相关的参数都作了初始化，之后项目中使用的都从这里获取，固然你也能够注入到服务里，全局单例使用：

 public static string ConnectionString => InitConn();
 public static DataBaseType DbType = DataBaseType.SqlServer;

具体的思路能够参考源码。 

 

二、导出数据到 JSON 

 有了配置文件和初始化，剩下的就是数据了，这一块我考虑了好久，有如下几个思路：

一、我开发一个 dll 文件（其实就是一个类库），而后里边有全部须要的数据，引用这个nuget，就能够直接使用，是一个List 泛型数据；//太复杂

二、手动写死到项目文件里；//代码太长，几千行

三、生成json文件，放到项目里；//直接增大项目大小

四、生成json文件，放到 GitHub 上，直接访问链接的形式；

若是你也有须要这一块的话，也能够尝试尝试，我考虑了考虑，最终采用第四种方法：

我写了一个 exe 小工具，自动将个人数据库数据，生成对应表的 JSON 文件，而后提交到 Github ：

这样我也好维护，也有指定的版本数据，若是你感受这一版本的数据很差，能够回退到上一版本的，是否是很贴心😂，主要仍是数据完整性。

 

三、在线 Data 导入数据库

 这个就是重头戏了，将 json 数据获取到，并发序列化生成 List，最后导入数据库对应表，为了代码的简洁性，我封装了几个 Helper ，感兴趣的能够去 Blog.Core.Common 查看，最后只有这一句便可：

 if (!await myContext.Db.Queryable<BlogArticle>().AnyAsync())
       myContext.GetEntityDB<BlogArticle>().InsertRange(JsonHelper.ParseFormByJson<List<BlogArticle>>(GetNetData.Get(string.Format(GitJsonFileFormat,"BlogArticle"))));
              

这样就把所有的数据导入到数据库了，很全的，并且你还能够指定 GitHub 数据版本。

 

好啦，本文就暂时到这里吧，之后确定还会增长的，主要目的就是帮助新使用的小伙伴，提供新手指南，不知道还会有哪些问题。

未完待续

 

今天是我入园八个月记念日啦，时间真快！感谢各位小伙伴，谢谢！

（ 吉祥金币，你申请了么？）

 

 

 

3、Github & Gitee

 

https://github.com/anjoy8/Blog.Core

https://gitee.com/laozhangIsPhi/Blog.Core

 

------ ♥ ------