.net5 core webapi项目实战之一：项目功能简介及开发环境准备

2020年9月14日，微软发布DOT NET5(Release Candidate)RC1版本，从而完成了.net framework和.net core的统一。

毫无疑问.net5是未来，对企业而言，系统的开发和部署降低了成本，对个人而言，一个统一的开发框架降低了学习成本，

作为一个.net程序员，当然要与时俱进，学习并掌握它至少以后找工作选择会更多，

本实战系列将以一个简单的.net core项目为起点，运用.net5技术由浅入深的介绍基于.net5的web开发。

一、项目基本功能介绍。

1 . 项目是一个RESTful风格的.net core Webapi。

2 . 为了化繁为简，项目的主要功能只提供对用户信息的管理，所以数据库只有一个Users表。

3 . 所有返回给客户端的数据为JSON格式。

4 . 用户信息的管理分两个层次：

　　第一个层次是用户自己，可以修改一些基本信息，比如昵称电话等；

　　第二个层次是管理员，可以新建用户，给用户分配角色、锁定/解锁用户（锁定后不能登录）；

5 . API如下:

功能序号	HTTP谓词（HTTP verbs）	API	描述
F1	GET	`/api/users`	管理员获取用户列表
F2	POST	`/api/users`	管理员添加用户
F3	PATCH	/api/users/{id}/role	管理员修改用户角色
F4	PATCH	/api/users/{id}/state	管理员锁定/解锁用户
F5	GET	/api/users/{id}	用户获取自己的信息
F6	PUT	/api/users/{id}	用户更新自己的信息
F7	PATCH	`/api/users/{id}/password`	用户修改密码

二、开发环境准备。

1. .net5开发官方文档网址：

https://docs.microsoft.com/zh-cn/aspnet/core/getting-started/?view=aspnetcore-5.0&tabs=windows

2. 开发工具需Visual Studio 2019 16.8 或更高版本，官方下载地址如下（社区版是免费的，可以自由使用）：

https://visualstudio.microsoft.com/zh-hans/downloads/?utm_medium=microsoft&utm_source=docs.microsoft.com&utm_campaign=inline+link&utm_content=download+vs2019