第 19 章主要介绍 Restful Service 的相关知识。Restful Service 的核心内容是：（1）HTTP 请求或 HTTP 动词，用 HTTP 请求表达不同的操作，最好遵守惯例。（2）资源，通过 PATH 结合 payload 来表达。以本章的示例来说：

除 Restful Service 外，替代品包括 GraphQL 和 gRPC。

使用自定义的端点实现 Web Service

不同语言的 Web 框架，都需要解决 Routing 问题，也就是客户端提交的请求，服务器通过内部机制最终处理的方法或者函数。在 asp.net core 中，比较流程的方法就是实用 MVC 来实现路由。但在使用标准的 MVC 框架之前，本书介绍了通过自定义 endpoint 来实现的方法。结合第 18 章，也就是说解决路由问题可以有 3 种方法：
1）使用中间件
2）自定义 endpoint
3）使用 MVC 框架的 Controller

第一步：新建 WebserviceEndpoint 类，在该类中实现了获取所有 products，根据 id 获取 product 和创建一个新的 product 三个功能：

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Routing;
using Microsoft.Extensions.DependencyInjection;
using System.Collections;
using System.Collections.Generic;
using System.Text.Json;
using WebApp.Models;

namespace WebApp
{
    public static class WebServiceEndpoint
    {
        private static string BASE_URL = "api/products";

        public static void MapWebService(this IEndpointRouteBuilder app)
        {
            // 匹配 GET: /api/products/{id}
            app.MapGet($"{BASE_URL}/{{id}}", async context =>
            {
                long key = long.Parse(context.Request.RouteValues["id"] as string);
                DataContext dbContext = context.RequestServices.GetService<DataContext>();

                var p = dbContext.Products.Find(key);
                if (p == null) {
                    context.Response.StatusCode = StatusCodes.Status404NotFound;
                } else {
                    context.Response.ContentType = "application/json";
                    context.Response.StatusCode = StatusCodes.Status200OK;
                    await context.Response.WriteAsync(JsonSerializer.Serialize<Product>(p));
                }
            });

            app.MapGet(BASE_URL, async context => 
            {
                DataContext dbContext = context.RequestServices.GetService<DataContext>();
                context.Response.ContentType = "application/json";

                await context.Response.WriteAsync(
                    JsonSerializer.Serialize<IEnumerable<Product>>(dbContext.Products));
            });

            app.MapPost(BASE_URL, async context => 
            {
                DataContext dbContext = context.RequestServices.GetService<DataContext>();
                Product p = await JsonSerializer.DeserializeAsync<Product>(context.Request.Body);
                await dbContext.AddAsync(p);
                await dbContext.SaveChangesAsync();

                context.Response.StatusCode=StatusCodes.Status200OK;
            });
        }
    }
}

注意 MapService() 方法是 IEndpointRouteBuilder 的扩展方法

第二步：在 Startup 类的 Configure() 方法中注册服务：

测试自定义端点

测试建议使用流行的工具，比如 Postman，而不是使用书中所介绍的 Invoke-ReestMethod 等工具。打开 Postman，对自定义 endpoint 的 3 个功能进行测试：

提交后，在数据库中查看：

使用控制器创建 Web 服务

第一步：在 Startup 类的 ConfigureService() 方法中，将控制器的服务添加到指定的 IServiceCollection，并且在 Configure() 中，通过 endpoints.MapControllers(); 方法实现默认的路由。

第二步：创建 Controller ，定义 Action 方法。XXXController 从 ControllerBase 类派生。

using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using System.Collections;
using System.Collections.Generic;
using System.Linq;
using WebApp.Models;

namespace WebApp.Controllers
{
    [Route("api/[controller]")]
    [ApiController]
    public class ProductsController : ControllerBase
    {
        private DataContext dbContext;

        public ProductsController(DataContext dbContext)
        {
            this.dbContext = dbContext;
        }

        // Get products
        [HttpGet]
        public IEnumerable<Product> GetProducts()
        {
            return dbContext.Products;
        }

        // Get product by Id
        [HttpGet("{id}")]
        public Product GetProduct()
        {
            return dbContext.Products.FirstOrDefault();
        }

        // Create product
        [HttpPost]
        public void SaveProduct([FromBody]Product p)
        {
            dbContext.Products.Add(p);
            dbContext.SaveChanges();
        }
    }
}

Controller 实现了相同的功能，我们可以从中看到框架的好处。

源码

pro asp.net core 3 notes: 《ASP.NET Core 3高级编程（第8版）》学习笔记