ASP.NET Core WebAPI中，创建非RESTful风格的和RESTful风格的Controller一些区别

最新推荐文章于 2025-07-09 17:51:04 发布

原创

最新推荐文章于 2025-07-09 17:51:04 发布 · 1.6k 阅读

27 ·

CC 4.0 BY-SA版权

文章标签：

#asp.net #restful #后端

本文探讨了在ASP.NETCore中，RESTful风格和非RESTful风格的API设计差异，包括URL结构、HTTP动词使用、动作方法命名以及适用场景。非RESTful风格如RPC和自定义操作提供了更大的灵活性，但可能不遵循标准的CRUD操作规则。

在 ASP.NET Core WebAPI 中，创建非 RESTful 风格的 API 和创建 RESTful 风格的 Controller 有一些区别。首先，让我们明确一下 RESTful 风格的特点：

RESTful 风格的 Controller 特点：

使用 HTTP 动词（GET、POST、PUT、DELETE 等）对资源执行 CRUD 操作。
资源使用统一的 URL 来标识。
使用 HTTP 状态码来表示操作的结果。
符合 REST 架构风格的规范和约定。

现在，让我们看看如何创建一些非 RESTful 风格的 API 以及它们与 RESTful 风格的 Controller 之间的区别。

1. 非 RESTful 风格的 API

1.1 RPC 风格（Remote Procedure Call）

RPC 风格的 API 类似于传统的远程过程调用，它强调的是对操作或方法的调用而不是资源的操作。

// 非 RESTful 风格的 Controller，使用 RPC 风格
[ApiController]
public class RpcController : ControllerBase
{
   
   
    [HttpPost]
    [Route("api/rpc/add")]
    public IActionResult Add(int a, int b)
    {
   
   
        int result = a + b;
        return Ok(result);
    }

    [HttpPost]
    [Route("api/rpc/multiply")]
    public IActionResult Multiply(int a, int b)
    {
   
   
        int result = a * b;
        return Ok(result);
    }
}

在这个例子中，我们有一个 RpcController，它有两个动作方法 Add 和 Multiply，分别执行加法和乘法操作。

1.2 自定义操作

有时候，你可能想要在 API 中定义一些非标准的操作，这也是非 RESTful 风格的一个例子。

// 非 RESTful 风格的 Controller，使用自定义操作
[ApiController]
public class CustomController : ControllerBase
{
   
   
    [HttpPost]
    [Route("api/custom/resetPassword")]
    public IActionResult ResetPassword(string username)
    {
   
   
        // Reset password logic
        return Ok();
    }

    [HttpPost]
    [Route("api/custom/sendEmail")]
    public IActionResult SendEmail(string recipient, string message)