驾一叶之扁舟 举匏樽以相属
寄蜉蝣于天地,渺沧海之一粟。哀吾生之须臾,羡长江之无穷。
挟飞仙以遨游,抱明月而长终。知不可乎骤得,托遗响于悲风。

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

缘起

 哈喽大家周三好,休息了一段时间,打算准备找工作了🙃,wuli亲故有帮忙内推么,所以平时的更新学习就停滞了,不过群里的问题,我还是尽量一直在回答的。。。

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

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

2、平均每周都有很多小伙伴问:这个后端项目的数据库数据在哪?执行报错?

3、群里使用MySql的越来越多了,也是一直问我:你这个后端项目是否匹配 MySql ?

4、SqlServer 在跨平台上真的难 ! 

5、本想找伙伴帮我一起维护项目,可怜没人😂

6、每次修改数据库,都需要生成sql脚本文件,麻烦!以后sql脚本不维护了,走下文的流程。

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

我这周简单学了学 MySql ,虽然大学的时候自己玩儿过,但是好久没有用了,几乎都忘了,趁着这次好好研究研究 MySql ,玩儿了两天,然后整合了下项目,也完美的支持了 MySql !你可以在配置文件中,一键操作,就可以随心的切换自己喜欢的数据库,以后还会融入其他数据库(比如Oracle啥的)、主从分离等数据库技术,挖个坑以后再看。当然这里也重点夸凯旋兄,SqlSugarCore 多数据库支持完美。

 

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

 

一、初次见面,如何玩转项目?

有很多小伙伴,第一次使用,刚刚下载的时候,就被 数据库 和 Reids 搞得心烦意乱,我这里就重点说一下吧,以后这个可以作为 Blog.Core 项目的使用手册。

目前项目已经支持 Sqlserver、MySql、Oracle、Sqlite四种数据库,项目默认启动是Sqlite,大家什么都不用操作,只需要直接运行,就能看到效果,只需要开启阀门即可:

打开这两个,就可以直接使用数据了,不需要配置任何数据库环境!

  

如果你用其他的数据库也同理,这里以 Mysql 举例来说(更新:目前最新代码 sugar5.0 已经支持自己创建数据库了,无需手动创建空数据库):

 

 

 

1、配置数据库连接字符串

注意如果使用 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
  }

 

 

2、启动种子生成阀门 

 配置好连接字符串后,剩下的就是很简单了,直接在下边的 SeedDBEnabled 启动 true 即可,之前是需要在代码 program.cs 中手动注释或取消注释,来实现的,现在移植到了配置文件里:

 

program.cs :

 

 

因为SqlSugar 不像 EFCore 那样有迁移,所以 Sqlsugar 不能自己创建数据库,所以我们需要手动创建一个空的数据库,这个很重要不要忘记。

SqlSugar 5.x 版本已经可以支持自动创建数据库了,所以如果你是 5.x+ 版本,可以不用手动创建数据库,反之需要手动创建空的数据库。

这个时候你只需要运行项目即可,当前如果有问题,你需要清理解决方案,再执行。因为我用的是在线数据,可能数据比较慢,稍微等待。

 

3、对了,还有那个 Redis 配置

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

 

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

项目中写了三处 AOP 相关服务,分别是 日志AOP,内存缓存AOP,Redis缓存AOP,如果你想开启对应的服务,只需要在配置文件中开启即可,这三个可以相互叠加的,不是互斥的:

 

 如果你想了解 AOP  以及他所应用的地方,请查看我的这篇文章:《完美基于AOP的接口性能分析

现在已经很轻松的收集到项目中用到的所有日志了,包括,操作日志+异常日志+Sql日志:

 

 

 

 

5、在Swagger中展示 Sql 执行日志 

操作很简单,功能很有效,动图如下,快速查看在线Demo:http://123.206.33.109:8081

 

当然这个 swagger 里不仅有SQL日志,还有异常日志,更多功能,等待你的开发:

 

 

二、整体 Seed 开发流程是怎样的?

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

为了更好的实现项目的自动化和高效性,一个框架就要尽量的减少用户的操作步骤,甚至不能修改代码,只需要配置文件就能达到相应的要求,所以我就想着把项目中需要配置的地方,都移植到 appsettings.json 文件里,目前也差不多实现了这个目标,那既然有配置,就一定要有初始化的地方,不然项目如何启动呢?没错,就拿数据库参数初始化举例:

在 Blog.Core.Common -> DB -> BaseDBConfig.cs 中,我这里对数据库相关的参数都做了初始化,以后项目中使用的都从这里获取,当然你也可以注入到服务里,全局单例使用:

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

具体的思路可以参考源码。 

 

2、导出数据到 JSON 

 有了配置文件和初始化,剩下的就是数据了,这一块我考虑了很久,有以下几个思路:

1、我开发一个 dll 文件(其实就是一个类库),然后里边有所有需要的数据,引用这个nuget,就可以直接使用,是一个List 泛型数据;//太复杂

2、手动写死到项目文件里;//代码太长,几千行

3、生成json文件,放到项目里;//直接增大项目大小

4、生成json文件,放到 GitHub 上,直接访问连接的形式;

如果你也有需要这一块的话,也可以尝试尝试,我考虑了考虑,最终采用第四种方法:

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

这样我也好维护,也有指定的版本数据,如果你感觉这一版本的数据不好,可以回退到上一版本的,是不是很贴心😂,主要还是数据完整性。

 

3、在线 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 数据版本。

 

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

未完待续

 

今天是我入园八个月纪念日啦,时间真快!感谢各位小伙伴,谢谢!

( 吉祥金币,你申请了么?)

 

 

 

三、Github & Gitee

 

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

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

 

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

posted @ 2019-04-17 11:10  老张的哲学  阅读(...)  评论(... 编辑 收藏
作者:老张的哲学
好好学习,天天向上
返回顶部小火箭
好友榜:
如果愿意,把你的博客地址放这里
jianshu.com/u/老张
SqlSugar codeisbug.com
钰玺 studenty.cn