.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} |
用户修改密码 |
二、开发环境准备。
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
3 . 运行环境需.NET 5.0 SDK 或更高版本,官方下载地址如下:
https://dotnet.microsoft.com/download/dotnet/5.0
根据操作系统选择对应的版本,Windows 64位操作系统请选择红圈标记的下载链接。