【C#/.NET】RESTful风格的Post请求与CreateAtAction 寻技术

引言

实现步骤

概念介绍

创建控制器

总结

引言

在构建Web应用程序时，遵循RESTful风格的API设计原则能够使我们的系统更加灵活、可扩展和易于维护。其中，Post请求在创建资源时起重要作用。本文将介绍如何在.NET WebApi中使用CreateAtAction来实现RESTful风格的Post请求。

实现步骤

概念介绍

创建资源的Post请求：在RESTful架构中，使用Post请求来创建新资源。以下是一些实现RESTful风格的Post请求的技术要点：

使用POST动词发送请求；
在请求的主体中发送要创建的资源的表示形式（通常使用JSON或XML）；
返回状态码201（Created），表示资源已成功创建；
在响应头中包含新资源的位置URL。

创建控制器

创建一个控制器，并添加一个Post方法，用于处理Post请求：

[Route("api/[controller]")]
[ApiController]
public class RestfulController : ControllerBase
{
    [HttpPost]
    public ActionResult<Model> Post([FromBody] Model model)
    {
        // 处理创建资源的逻辑
        // 返回创建成功的响应，并包含新资源的位置
        return CreatedAtAction(nameof(Get), new { id = model.Id }, model);
    }

    [HttpGet("{id}")]
    public ActionResult<Model> Get(int id)
    {
        // 使用id查询
        return new Model(1, "bob");
    }
}

public record Model(int Id,string Name);

在上面的示例中，我们使用了[ApiController]和[Route("api/[controller]")]属性来标注控制器和路由。[ApiController]属性确保请求的有效性，并自动处理模型绑定和验证。[Route("api/[controller]")]属性定义了API的基础路由，可以替换为你的具体路由。

在Post方法中，我们使用[FromBody]属性将请求体中的数据绑定到Model。你可以根据自己的需求来选择合适的模型。

处理完创建资源的逻辑后，我们通过CreateAtAction方法返回创建成功的响应。CreateAtAction方法接受三个参数：Action名称、路由参数、返回的资源对象。在这里，我们使用"Get"作为Action名称，表示获取刚创建的资源的详细信息。路由参数使用一个匿名对象表示，这个对象包含新资源的唯一标识符（在这个例子中是model.Id）。

在Postman中的效果