.net6的WebApi实战

目录

一 搭建开发环境

二 创建Webapi项目

三 创建类

四 在IIS服务器上部署web应用

五 在Linux部署web应用

六 统一日期时间格式化输出

七 创建Api控制器

八 增加数据库支持

参考文档：

https://bxshare.top/index.php/category/WebApi%E5%85%A5%E9%97%A8/

一 搭建开发环境

说明：开发环境使用window10+vs2022+net6

1 下载并安装VS2022

2  下载并安装Net6

二 创建Webapi项目

方案1

1 在gitee上创建仓库Core6Demo

2 使用git bash 克隆仓库到本地路径vs2022/

3 使用vs2022创建Core6Demo解决方案和Core6Demo.Webapi项目

勾选不使用顶级语句

方案2

1 使用vs2022创建Core6Demo解决方案和Core6Demo.Webapi项目

本地路径vs2022/Core6Demo

2 在gitee上创建仓库Core6Demo

3 git bash中使用命令git push到仓库或者不上传到仓库

三 创建类

1 创建类文件，命名大驼峰形式UserInfo.cs

2 添加using 引用命名空间，或者在写完代码后引用命名空间

3 添加静态字段或者静态属性，可以赋初值

4 添加静态构造函数和静态方法

5 添加实例字段或者实例属性，可以赋初值

6 添加实例构造方法和一般实例方法

7 在另一个类中调用该类的实例成员和静态成员

四 在IIS服务器上部署web应用

1 安装IIS和Net6 runtime bundle.exe （包括了runtime和iis支持）

2 复制发布的文件文件到网站目录

3 添加上传ssl证书或者使用iis创建自定义证书

4 在iis去除勾选ssl，绑定ssl端口到网站，并配置iis证书

5 测试，输入http://url会直接302跳转到https://url

五 在Linux部署web应用

说明：使用nginx做反向代理

1 安装nginx和aspnetcore-runtime-6并设置nginx随服务器启动

yum install -y nginx

yum search aspnetcore

yum install -y aspnetcore-runtime-6

systemctl enable nginx

systemctl start nginx

systemctl stop nginx

2 打开微软配置nginx文档复制内容到etc/nginx/nginx.conf

nginx -s reload

2.1 可选，selinux设置

yum install setroubleshoot

cat /var/log/audit/audit.log

tail -n 3 /var/log/audit/audit.log

tail -n 3 /var/log/audit/audit.log | tee /tmp/audit

audit2why /tmp/audit

sestatus

3 打开防火墙端口

firewall-cmd --add-port=80/tcp --permanent    //命令永久打开

4 运行dotnet应用

dotnet Webapi.dll  --urls="http://*:5000"

运行错误可以更改运行的运行时版本

六 统一日期时间格式化输出

1 安装包Microsoft.AspNetCore.Mvc.NewtonsoftJson

2 添加代码

builder.Services.AddControllers()
                .AddNewtonsoftJson(options =>
                {
                   options.SerializerSettings.DateFormatString = "yyyy-MM-dd HH:mm:ss";
                });

七 创建Api控制器

1 添加控制器UsersController.cs

命名类名，增加特性[ApiController] 和[Route("[controller]")]，继承ControllerBase

2 添加构造函数依赖注入

3 增加action方法，并设置路由[HttpGet("{index}")],[HttpPost]

4 增加action方法的函数参数(基本类型或自定义类型)，并设置来源[FromBody],[FromQuery]

5 设置action 返回值类型和http状态码

八 增加数据库支持

方案1 三层仓储架构

说明：Repositoris，Services，Webapi，Models（或者Entities），Common

1 创建三层仓储架构类库，并按引用关系引用

2 添加要存储的数据库模型类UserInfo.cs，Attachment.cs,Role.cs,Module.cs,RoleModule.cs

权限有三种：访问菜单界面的权限，访问api的权限，访问数据的权限

3 添加nuget包，如EntityFramework或SqlSugar

4 添加泛型仓储类BaseRepository并按官网代码实现

5 添加UserService，并在构造函数中注入BaseRepository

6 添加UserController，并在构造函数中注入UserService

7 在依赖注入关系中添加SqlSugar服务和自己定义的BaseRepository和UserService

8 配置数据库字符串，并在项目中应用