翻译自 Mohamad Lawand 2021年1月19日的文章 《Asp.Net Core 5 Rest API Step by Step》 ^[1]

在本文中，我们将创建一个简单的 Asp.Net Core REST API Todo 应用程序，在其中我们可以添加、编辑、删除和查看待办事项，并且将使用 SQLite 来存储数据。

你也可以在 YouTube 上观看完整的视频^[2]，还可以下载源代码^[3]。

这是 API 开发系列的第一部分，后面还有：

• Part 2：Asp.Net Core 5 REST API 使用 JWT 身份验证 - Step by Step ^[4]
• Part 3：Asp Net Core 5 REST API 中使用 RefreshToken 刷新 JWT - Step by Step

在开始之前，我们需要准备的四样东西：

• Visual Studio code (https://code.visualstudio.com/)
• Dotnet core SDK (https://dotnet.microsoft.com/download)
• Postman (https://www.postman.com/downloads/)
• DBeaver (https://dbeaver.io/download/)

下载并安装了所有必需的工具后，我们需要确保 dotnet SDK 已成功安装，我们需要打开终端并通过检查 dotnet 版本来检查 dotnet SDK 是否已成功安装。

打开终端并输入以下命令：

dotnet --version

现在，我们需要安装 EntityFramework 工具：

dotnet tool install --global dotnet-ef

完成后，我们需要创建我们的应用程序：

dotnet new webapi -n "TodoApp" -lang "C#" -au none

现在让我们添加需要使用的依赖包，以便可以使用 EntityFramrwork 和 SQLite：

dotnet add package Microsoft.EntityFrameworkCore.Sqlite

dotnet add package Microsoft.EntityFrameworkCore.Tools

现在，请打开 VS Code 并检查我们的应用程序和源代码，然后，让我们构建应用程序并查看其是否可以运行：

dotnet build

dotnet run

确认可以正常运行后，我们删除由 .Net Core 框架为我们生成的默认模板代码，即删除 WeatherForcastController 和WeatherForcast 类。

接着，我们创建自己的控制器，将其命名为 TodoController。

然后，我们创建第一个简单的 Action，将其命名为 TestRun，让我们开始为我们的控制器编码：

[Route("api/[controller]")] // 我们定义控制器要使用的路由

[ApiController] // 我们需要指定控制器的类型以让 .Net Core 知道

public class TodoController : ControllerBase

{

    [Route("TestRun")] // 定义此 Action 的路由

    [HttpGet]

    public ActionResult TestRun()

    {

        return Ok("success");

    }

}

创建完成后，我们需要对其进行测试，为了测试，我们需要执行以下操作：

dotnet build

dotnet run

应用程序运行起来后，我们可以打开 Postman 试一下看看我们得到的响应。

我们在 Postman 中创建一个新请求，并将类型设置为 GET，然后请求以下 URL：

https://localhost:5001/api/todo/testrun

正如您在 TestRun 中看到的那样，我们在 Postman 中得到了 “success” 响应。

测试完之后，我们现在需要开始添加模型，在根目录中添加一个 Models 文件夹，并在其中添加一个名为 ItemData 的类。这是一个非常简单的模型，它表示我们的待办事项的列表项。

public class ItemData

{

    public int Id { get; set; }

    public string Title { get; set; }

    public string Description { get; set; }

    public bool Done { get; set; }

}

添加好模型后，我们需要构建 ApiDbContext。在根目录中创建一个 Data 文件夹，然后在该文件夹中创建一个名为 ApiDbContext 的新类。

public class ApiDbContext : DbContext

{

    public virtual DbSet<ItemData> Items {get;set;}

    public ApiDbContext(DbContextOptions<ApiDbContext> options)

        : base(options)

    {

    }

}

然后，我们需要在 appsetting.json 中指定应用程序的连接字符串：

"ConnectionStrings": {

  "DefaultConnection" : "DataSource=app.db; Cache=Shared"

}

完善 DbContext 和连接字符串后，我们需要更新 Startup 类，以便可以在应用程序中使用 Application DbContext。在我们的根目录中打开 Startup 类，然后添加以下代码：

services.AddDbContext<ApiDbContext>(options =>

    options.UseSqlite(

        Configuration.GetConnectionString("DefaultConnection")

    ));

添加好 DbContext 中间件后，我们需要添加初始化迁移来创建数据库：

dotnet ef migrations add "Initial Migrations"

dotnet ef database update

成功完成数据库更新后，我们可以看到有一个名为 Migrations 的新文件夹，它将包含 C# 脚本，该脚本将负责创建数据库及其表 Items。我们可以在根目录中看到 app.db 文件，也可以使用 SQLite 查看工具来验证表是否已成功创建，由此我们可以验证数据库是否已创建。

现在，我们已经完成了控制器的所有基础设施的搭建。现在，我们需要开始构建 TodoController 并将其连接到ApiDbContext。

我们从添加获取待办事项中的所有项的方法 GetItems 开始，依次添加所有需要的方法：

using System.Threading.Tasks;

using Microsoft.AspNetCore.Mvc;

using Microsoft.EntityFrameworkCore;

using TodoApp.Data;

using TodoApp.Models;

namespace TodoApp.Controllers

{

    [Route("api/[controller]")] // api/todo

    [ApiController]

    public class TodoController : ControllerBase

    {

        private readonly ApiDbContext _context;

        public TodoController(ApiDbContext context)

        {

            _context = context;

        }

        [HttpGet]

        public async Task<IActionResult> GetItems()

        {

            var items = await _context.Items.ToListAsync();

            return Ok(items);

        }

        [HttpPost]

        public async Task<IActionResult> CreateItem(ItemData data)

        {

            if (ModelState.IsValid)

            {

                await _context.Items.AddAsync(data);

                await _context.SaveChangesAsync();

                return CreatedAtAction("GetItem", new { data.Id }, data);

            }

            return new JsonResult("Something went wrong") { StatusCode = 500 };

        }

        [HttpGet("{id}")]

        public async Task<IActionResult> GetItem(int id)

        {

            var item = await _context.Items.FirstOrDefaultAsync(x => x.Id == id);

            if (item == null)

                return NotFound();

            return Ok(item);

        }

        [HttpPut("{id}")]

        public async Task<IActionResult> UpdateItem(int id, ItemData item)

        {

            if (id != item.Id)

                return BadRequest();

            var existItem = await _context.Items.FirstOrDefaultAsync(x => x.Id == id);

            if (existItem == null)

                return NotFound();

            existItem.Title = item.Title;

            existItem.Description = item.Description;

            existItem.Done = item.Done;

            // 在数据库级别实施更改

            await _context.SaveChangesAsync();

            return NoContent();

        }

        [HttpDelete("{id}")]

        public async Task<IActionResult> DeleteItem(int id)

        {

            var existItem = await _context.Items.FirstOrDefaultAsync(x => x.Id == id);

            if (existItem == null)

                return NotFound();

            _context.Items.Remove(existItem);

            await _context.SaveChangesAsync();

            return Ok(existItem);

        }

    }

}

然后，我们可以在 Postman 中一个一个地对它们进行测试。

最后，由于我们在创建 Web API 项目时使用的是 .Net 5，因此 Swagger 已经集成到了我们的应用程序中，要查看 Swagger 界面，可以在浏览器中导航到 http://localhost:5000/swagger/index.html。

Swagger 允许您描述 API 的结构，以便程序可以自动读取它们，而无需我们额外的工作。Swagger 能够读取 API 结构并为我们生成一个 UI，我们可以借此来改善开发体验。

感谢您阅读本文。

本文是 API 开发系列的第一部分，后面会有第二、第三部分。

作者 ： Mohamad Lawand

译者 ： 技术译民

出品 ： 技术译站

链接 ： 英文原文

---

1. https://dev.to/moe23/asp-net-core-5-rest-api-step-by-step-2mb6 Asp.Net Core 5 Rest API Step by Step ︎

2. https://youtu.be/p_wUdWshYc8 ︎

3. https://github.com/mohamadlawand087/v6-RestApiNetCore5 ︎

4. https://mp.weixin.qq.com/s/zR0Yz0eUYXzSrctYmE2oWg Asp.Net Core 5 REST API 使用 JWT 身份验证 - Step by Step ︎

Asp.Net Core 5 REST API - Step by Step的更多相关文章

1. angular4和asp.net core 2 web api

   angular4和asp.net core 2 web api 这是一篇学习笔记. angular 5 正式版都快出了, 不过主要是性能升级. 我认为angular 4还是很适合企业的, 就像.net ...

2. ASP.NET Core 中基于 API Key 对私有 Web API 进行保护

   这两天遇到一个应用场景,需要对内网调用的部分 web api 进行安全保护,只允许请求头账户包含指定 key 的客户端进行调用.在网上找到一篇英文博文 ASP.NET Core - Protect y ...

3. ASP.NET Core WebApi构建API接口服务实战演练

   一.ASP.NET Core WebApi课程介绍 人生苦短,我用.NET Core!提到Api接口,一般会想到以前用到的WebService和WCF服务,这三个技术都是用来创建服务接口,只不过Web ...

4. 使用ASP.NET Core构建RESTful API的技术指南

   译者荐语:利用周末的时间,本人拜读了长沙.NET技术社区翻译的技术标准<微软RESTFul API指南>,打算按照步骤写一个完整的教程,后来无意中看到了这篇文章,与我要写的主题有不少相似之 ...

5. 使用angular4和asp.net core 2 web api做个练习项目(一)

   这是一篇学习笔记. angular 5 正式版都快出了, 不过主要是性能升级. 我认为angular 4还是很适合企业的, 就像.net一样. 我用的是windows 10 安装工具: git for ...

6. 使用angular4和asp.net core 2 web api做个练习项目(四)

   第一部分: http://www.cnblogs.com/cgzl/p/7755801.html 第二部分: http://www.cnblogs.com/cgzl/p/7763397.html 第三 ...

7. 关于ASP.Net Core Web及API身份认证的解决方案

   6月15日,在端午节前的最后一个工作日,想起有段日子没有写过文章了,倒有些荒疏了.今借夏日蒸蒸之气,偷得浮生半日悠闲.闲话就说到这里吧,提前祝大家端午愉快(屈原听了该不高兴了:))!.NetCore自 ...

8. 基于ASP.NET Core 创建 Web API

   使用 Visual Studio 创建项目. 文件->新建->项目,选择创建 ASP.NET Core Web 应用程序. 基于 ASP.NET Core 2.0 ,选择API,身份验证选 ...

9. ASP.NET Core 1.0: API的输入参数

   Web API是需要接受参数的,譬如,通常用于创建数据的POST method需要接受输入数据,而用于GET method也需要接受一些可选参数,譬如:为了性能起见,控制返回数据的数量是至关重要的. ...

10. ASP.NET Core Restful Web API 相关资源索引

    GraphQL 使用ASP.NET Core开发GraphQL服务器 -- 预备知识(上) 使用ASP.NET Core开发GraphQL服务器 -- 预备知识(下) [视频] 使用ASP.NET C ...

随机推荐

1. 创业实战go语言制作网站(转)

   简单介绍一下之前的整个职业生涯,挺典型的,工程师 –> 资深工程师 –> 架构师 –> 项目经理 –> 部门经理,可以说,产品研发过程中的所有角色我都走了一遍,任职的公司也越来 ...

2. 浅析Netty的异步事件驱动（二）

   上一篇文件浅析了Netty中的事件驱动过程,这篇主要写一下异步相关的东东. 首先,什么是异步了? 异步的概念和同步相对.当一个异步过程调用发出后,调用者不能立刻得到结果.实际处理这个调用的部件在完成后 ...

3. Tsinsen A1505. 树（张闻涛） 倍增LCA,可持久化线段树,DFS序

   题目:http://www.tsinsen.com/A1505 A1505. 树(张闻涛) 时间限制:1.0s   内存限制:512.0MB    总提交次数:196   AC次数:65   平均分: ...

4. linux 命令——PS命令

   首先要明白什么是进程进程是一个正在运行的程序.也就是说在Linux系统上运行的所有东西都是进程.和进程相比较,作业是一系列按一定顺序执行的命令.一条简单的命令可能会涉及多个进程,尤其是当使用管道和重定 ...

5. 一次rman恢复的实验

   本文主要针对备份和恢复数据文件,具体rman知识点查阅我的另一篇文章:http://blog.csdn.net/perfect_db/article/details/8765022 首先看看数据文件的 ...

6. 极限挑战—C#+ODP 100万条数据导入Oracle数据库仅用不到1秒

   链接地址:http://www.cnblogs.com/armyfai/p/4646213.html 要:在这里我们将看到的是C#中利用ODP实现在Oracle数据库中瞬间导入百万级数据,这对快速批量 ...

7. leetcode先刷_Merge Two Sorted Lists

   非常easy问题. 唯一的地方可以具有更具挑战是确保不会引入额外的空间.查找开始值最小的名单列表的新掌门人,头从列表中删除.其他操作应该没有问题. class Solution { public: L ...

8. 被final关键字坑了

   一直都傻傻的以为用final关键字定义的都是不可变的.没想到的是对基本类型来说,这是一直成立的. 但是对于final修饰的对象,仍然可以修改对象里面的对象和成员变量.不变的只是当前对象的地址. 昨天我 ...

9. .NET的未来-广州.NET俱乐部学生分会

   偶然的一次机会,让我发现了在我们社区的微信群里潜藏着许多高校的学生,他们有的来自重点高校中山大学.华南理工,也有的来自普通高校的惠州学院.广州白云学院等. 因为相同的技术爱好使他们聚集在社区.相同的技 ...

10. Vim列模式（块选择）输入

    https://www.ibm.com/developerworks/cn/linux/l-cn-vimcolumn/ https://www.zhihu.com/question/19968224 ...