[YM]课设-C#-WebApi-Vue-员工管理系统 (一)创建webapi项目

相关安装：

.Net c#编译器安装：

下载地址：下载 .NET(Linux、macOS 和 Windows) (microsoft.com)

安装包相当智能

直接点下载

下载完成直接安装

安装成功后自动会配置.net的环境变量

创建项目：

创建一个空文件夹（当后端文件）

用vscode打开

把终端打开

（最上面那一栏上有三个点“...” 点开就有终端选项，然后直接创建新的终端）

dotnet new webapi --use-controllers

输入这条指令

自动生成相关项目文件

这里他自动给生成了一个小例子：

我们可以先运行下项目试一试

dotnet run

输入启动指令

生成一个后端的端口

Ctrl+左键进入

然后 哎！？ 为什么没有呢

打开小例子的Controller源码看一下

（上面说了Controller是实现和api接口的控制器）

我们可以看到一个ApiController一个Route两个注释

ApiController注释标识该程序是webapi中的controller控制器

Route叫做“路由”，也叫做请求路径

简单来说就是本地端口地址http://localhost:5299后边跟的路径地址

下边我们详细解释

[Route("[controller]")]

（）里面就是你可以自定义请求路径

[controller]就是你现在创建controller类的类名

小例子的controller名称为WeatherForecastController

系统会自动去除后边的Controller

这样

请求路径就是/WeatherForecast

验证一下

在本地端口路径后手动加上自定义请求路径

回车

哦豁！！！

成功了

这样就是简单的前后端互联

我们细说一下路由：

路由：

在class上面写的route是全局路径

下边的方法，类等等他们发送出去的api接口都在这一个请求路径上

这种几乎不常使用

当然有全局就有局部

你可以把他放在具体的方法上

这个请求路径就会执行这个指定的方法

说到方法

route还有一个[action]的标签

使用方法名称作为请求路径

我们先把route再放回全局

改成 

[Route("[controller]/[action]")]

现在访问的形式就是/control名称/方法名称

为了方便测试

我们再定义一个方法Get2

（这里HttpGet一定要写，这个我们后边会详细讲到）

那么我们就来测试一下

 

完美

 在后续开发中我们请求路径不会胡乱去编写

前期提到了

Api接口文档

用于规范前后端请求路径，请求方式，响应参数等等

请求方式：

上文解释了什么是请求路径

有请求路径就有请求方式

前后端会根据请求方式不同而处理不同的情况

常用的方式有

HttpGet 一般用于查询获取

HttpPost 更为安全，一般用于添加信息

HttpDelete 字面意思，用于删除信息

HttpPut 一般用于修改信息

Swagger：

c#webapi提供了一个查看api接口的网页

访问方式就是本地路径+/swagger

旨在后端写完功能之后测试

或者是在没有前端的情况下模拟前端向后端请求

可以看到WeatherForecastController下的两个api接口

swagger测试就相当于常用的 APIPost 的功能

点开一个接口

右边有一个try it out 

点击就可以测试

 下边responses就是相应

code就是http中的状态码

（这个后边前端详细说）

media type就是回应数据的格式

json是最常用的格式

 这里我们不用管

example value就是预期返回数据的样式

Schema就是数据属于哪个实体类

也叫Model

Models就是存储实体类的文件

我们刚刚测试写的方法Get2是直接返回string类型

那么显示的实体类就是string

反观系统自动生成的小案例就会显示一个WeatherForecast的实体类

那么这个在哪里呢？

打开我们心爱的vscode

真的还有一个实体类

但是

我们规范来说要放在一个Models文件下存储这些实体类

下面我们规范一下

创建规范分层文件：

打开vscode

点击文件的空白处

在左上角有一个新建文件夹的按钮

然后创建Mappers，Services，Models

（Controller生成文件时已经有了，Entities后边我们会直接用指令去创建）

那么我们就已经规范了分层文件

接下来我们连接数据库

 ———————————

持续更新中...

关注[YM]课设专栏[YM]课设_夜喵YM的博客-CSDN博客

文章：

[YM]课设-C#-WebApi-Vue-员工管理系统 （前言）-CSDN博客

[YM]课设-C#-WebApi-Vue-员工管理系统 (一)创建webapi项目-CSDN博客

[YM]课设-C#-WebApi-Vue-员工管理系统 Api接口文档&SQL脚本-CSDN博客

[YM]课设-C#-WebApi-Vue-员工管理系统 (二)连接数据库-CSDN博客

[YM]课设-C#-WebApi-Vue-员工管理系统 (三)部门管理-CSDN博客

[YM]课设-C#-WebApi-Vue-员工管理系统 (四)员工管理-条件分页查询-CSDN博客

[YM]课设-C#-WebApi-Vue-员工管理系统 (五)登录-CSDN博客

[YM]课设-C#-WebApi-Vue-员工管理系统-前端文件-CSDN博客

[YM]课设-C#-WebApi-Vue-员工管理系统 (六)前后端交互-CSDN博客

[YM]课设-C#-WebApi-Vue-员工管理系统 (七)员工统计表-CSDN博客