超详细d的.net core WebAPI 使用EF连接MySQL并使用swagger生成API文档

- 基于Visual Studio 2019

- ASP.NET Core 3.0

1.新建项目

从图中可以看到，默认的项目文件中已经包含了 Controllers。其为控制器文件夹，用来进行业务编写的代码，我们基本上需要在这个文件中进行数据的传出与接收。相应的，我们还可以进行各个文件创建，进行层次区分，也可以建立单独的类项目，进行层次区分，如控制层，服务业务层，数据连接层，模型实体层。

另外，

appsettings：配置文件，此处可以编写一些常量设置，然后在程序中进行读取。

Program：项目启动文件。

Startup：项目配置设置文件。

直接运行可以看到如图，因为在Control文件中已经包含了ValuesController


可以在launchsettings.json中看到无论是用IIS启动还是用控制台启动，URL都定向到了valuesControl文件中

2.使用EF连接 MySQL 数据库

里面坑很多，也是参照了网上大神，附上连接
https://www.cnblogs.com/xunzhiyou/p/10661951.html
首先利用Nuget管理包安装
MySql.Data.EntityFrameworkCore
Microsoft.AspNetCore.Mvc.NewtonsoftJson

接下来创建一个为test表明的测试表


接下来创建一个数据表结构，并添入示例数据，例如下图。

C#中创建对应的实体类，另外创建一个类继承dbContext，dbContext是EF框架中非常重要的一个环节，是建立实体类与数据库连接的桥梁，具体的原理，这里不进行赘述。

创建过程如下代码所示（注意要自行在项目中添加 Models 文件夹，并添加实体类文件，如 Person.cs）。

Models/Person.cs

using System.ComponentModel.DataAnnotations;
namespace MyTestCoreAPI.Models
{
public class data
{
[Key]
public int Id { get; set; }
[MaxLength(50)]
public string Name { get; set; }
[MaxLength(10)]
public int Age { get; set; }
}

Models/CoreDbContext.cs

using Microsoft.EntityFrameworkCore;
namespace MyTestCoreAPI.Models
{
public class CoreDbContext : DbContext
{
//创建实体类添加Context中,类名可以任意定义，但是Test名必须跟数据库表名一样
public virtual DbSet<data> Test { get; set; }

public CoreDbContext(DbContextOptions<CoreDbContext> options) : base(options)
{

}
}
}

**

配置数据库连接

**
appsettings.json

{
//加入这段,填写你的数据库连接信息
"ConnectionStrings": {
"DefaultConnection": "server=localhost;uid=YourUserId;pwd=YourPassword;port=3306;database=DbName;sslmode=Preferred;"
},

"Logging": {
"LogLevel": {
"Default": "Warning"
}
},
"AllowedHosts": "*"
}

最后，在ValuesController添加
ValuesController.cs

private readonly CoreDbContext context;

public ShipController(CoreDbContext coreDbContext)
{
context = coreDbContext;
}
// GET api/values
[HttpGet]
public List<data> Get()
{
return context.Set<data>().ToList();
}

// POST api/values/addPreson
[HttpPost("addPreson")]
public String Post(JObject _JObject)
{
data addData = new data();
addData.name = _JObject["name"].ToString();
addData.age = int.Parse(_JObject["age"].ToString());
//必须SaveChanges保存，否则不生效，操作成功后返回操作条数,具体请查阅微软官网教程
context.Add(addData);
int result = context.SaveChanges();

JObject jb = new JObject();
jb.Add("name", addData.name);
jb.Add("age", addData.age);
jb.Add("msg", result);

return jb.ToString();
}

3.运行如下图

大功告成，这样就可以通过EF操作数据库了
微软EF教程

进行POST请求

查看数据库，添加成功

使用swagger生成API文档

也是坑很多，各种no find，参照了网上大神，附链接
https://www.geek-share.com/detail/2738559801.html
这里引用了三个库，都是在Nuget上安装：

Microsoft.AspNetCore.StaticFiles
Swashbuckle.AspNetCore
Swashbuckle.AspNetCore.SwaggerUi

startup.cs

public void ConfigureServices(IServiceCollection services)
{
//加入 Swagger(加入这段)
services.AddSwaggerGen(c =>
{
c.SwaggerDoc("v1", new OpenApiInfo { Title = "MyApi", Version = "v1" });
//MyTestCoreAPI.XML填写成你生成的XML文件
var xmlPath = Path.Combine(AppContext.BaseDirectory, "MyTestCoreAPI.XML");
c.IncludeXmlComments(xmlPath);
});
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
//启用中间件，允许Swagger提供服务生成json文档以及UI
// Enable middleware to serve generated Swagger as a JSON endpoint.
app.UseSwagger(c => { c.RouteTemplate = "swagger/{do
11cd9
cumentName}/swagger.json"; });

// Enable middleware to serve swagger-ui (HTML, JS, CSS, etc.),
// specifying the Swagger JSON endpoint.
app.UseSwaggerUI(c =>
{
//v1填写你自定义的页面
c.SwaggerEndpoint("v1/swagger.json", "v1");
});
}

**

启用XML注释

**

编译一下，会生成XML注释文件

然后需要在API中添加注释

运行

在浏览器中输入：http://localhost:/swagger/index.html
大功告成
可以在这个页面进行get和POST请求测试

发布到Windows平台下IIS运行
请参考我的另一篇博客
https://blog.csdn.net/qq_33931256/article/details/89387554