.Net Core 3.0 WebAPI && MySQL 8.0搭建详情

微软在2019年9月24日发布了dotnet core 3.0和c# 8.0，添加了许多新features，。无疑dotnet core 3.0和一个月之后即将发布的dotnet core 3.1对于dotnet来说是一个重要的里程碑。

对于mysql而言，现在越来越多的商业公司使用mysql来作为自己的主要数据库，虽然mysql已经迎来了8.0的版本，有着更完善的数据能力，更好的性能，但是还是有很多公司在新项目上使用mysql5.7。我在技术上很鄙视这样的做法，一旦使用的老技术out of support，对已有项目的改动和迁移所做的努力将会是当初学习新和试错的n倍。

言归正传，今天来记录一下使用dotnet core 3.0的webapi和mysql 8.0的使用（本次实践基于已有数据库，没有完成数据库的需要使用workbench或navicat搭建数据库）。

1. 准备工作

准备工作的目的是搭建一个便于我们调试的工程环境。考虑到以后用到微服务的可能，这里并不能用硬编码（hardcoding）写死启动的地址和端口，以下工作就是为了达到指定端口启动的目的。

1. 建立工程

   平常一些小项目我都用vs code来创建工程了，但这次我使用visual studio 2019 16.3.5（dotnet core 3.0需要至少16.3的版本，如果用vs code需要最新的c#插件）创建工程。

   

   为了日后上微服务可能，我们并不能写死项目的启动地址和端口；而且得益于dotnet core自带kestrel，所以我并不打算使用iis express作为调试使用。在"解决方案次源管理器"中右击项目名——"属性"——"调试"——"配置文件"中选择项目名对应项——"启动"选择"项目"，""应用程序参数先不填，这个后面会用到。

   

    

2. 添加启动参数

   要想指定地址和端口启动，我们可以用硬编码；也可以读取json配置；也可以像我一样，在程序启动时传入参数。下面介绍如何通过重写program.cs来读取程序的启动参数。

   可以删除createhostbuilder方法，并填加如下方法：

   1. public static iwebhost buildwebhost(string[] args)  
   2. {  
   3.     var config = new configurationbuilder()  
   4.     .addcommandline(args)  
   5.     .build();  
   6.     string ip = config["ip"];  
   7.     string port = config["port"];  
   8.     console.writeline($"ip={ip}:port={port}");  
   9.     return webhost.createdefaultbuilder(args)  
   10.     .usestartup<startup>()  
   11.     .useurls($"http://{ip}:{port}")  
   12.     .build();  
   13. }  

   修改main方法为：

   1. public static void main(string[] args)  
   2. {  
   3.     buildwebhost(args).run();  
   4. }  

    

   在项目"属性"页——"调试"选项卡——"应用程序参数"中填写相应参数，例如我这里填写"—ip 127.0.0.1 –port 8000"。

   

   在调试按钮的下拉选项中选择项目名。

   

   到此，按f5或ctrl+f5启动调试，浏览器会跳转到我们指定的地址和端口。

   1. 添加数据库

   官方教程并没有给出添加mysql的实例，但其过程和sql server是一样的。

3. 准备工作

   添加nuget包：在"程序包管理器控制台"中键入：

   dotnet add package mysql.data.entityframeworkcore --version 8.0.18

   我并没有使用pomelo库，而用的是mysql官方库，截止到当天是8.0.18。

   创建如下几个目录：

   data——用来存放数据库上下文等数据文件

   models——用来存放数据模型

4. 创建模型

   在models目录下创建与数据库匹配的数据模型testmodel.cs。如要指定主键，可以用[key]属性在模型中指定。

   1. using system;    
   2. using system.componentmodel.dataannotations;    
   3. namespace lrms.server    
   4. {    
   5.     public class testmodel    
   6.     {    
   7.         [key]    
   8.         public int uid { get; set; }    
   9.         public string username { get; set; }    
   10.         public string password { get; set; }    
   11.     }    
   12. }  

    

5. 创建数据库上下文

   在data目录下创建数据库上下文testdbcontext.cs。在上下文中使用ef core中的dbset类型创建对应的与数据表名称（可忽略大小写）相应的实例。

   1. using microsoft.entityframeworkcore;    
   2. namespace lrms.server    
   3. {    
   4.     public class userinfodbcontext : dbcontext    
   5.     {    
   6.         public userinfodbcontext(dbcontextoptions options) : base(options) { }    
   7.         public dbset<testmodel> user_login { get; set; }    
   8.     }    
   9. }    
6. 添加数据库连接字

   打开在工程的根目录下的appsettings.json。替换以下对象：

   1. {  
   2.     "connectionstrings": {  
   3.         "连接字名称": "server=数据库地址;uid=数据库账户;pwd=数据库密码;database=数据库schema;charset=utf8;sslmode=none;",  
   4.     },  
   5.     "logging": {  
   6.         "loglevel": {  
   7.             "default": "information",  
   8.             "microsoft": "warning",  
   9.             "microsoft.hosting.lifetime": "information"  
   10.         }  
   11.     },  
   12.     "allowedhosts": "*"  
   13. }  

    

   打开startup.cs，在coinfigureservices方法中添加如下代码：

   1. public void configureservices(iservicecollection services)  
   2. {  
   3.     services.addcontrollers();  
   4.     services.adddbcontext<userinfodbcontext>(options =>  
   5.     {  
   6.         options.usemysql(configuration.getconnectionstring("连接字名称"));  
   7.     });  
   8. }  

   到此，数据库的使用部分结束了。

   1. 后续

   为了安全，防止泄漏，在控制器中我们并不能直接使用数据库上下文，下面的代码展示了一种简单的处理。

   1. // 创建私有、只读的数据库上下文实例  
   2. private readonly userinfodbcontext _db;  
   3. // 构造函数中为其赋值  
   4. public userlogincontroller(userinfodbcontext db)  
   5. {  
   6.     _db = db;  
   7. }  

    

   以上。