第6章 6.4 ASP.NET Core Web API各种技术及选择

 6.4.1 控制器父类用哪个

6.2小节和6.3小节所演示的ASP.NET Core Web API 的控制器类都继承自ControllerBase，而6.1中MVC的控制器继承自Controller，Controller又继承自ControllerBase。

所以，一般情况下，编写的WebAPI控制器类继承自ControllerBase即可，当然也可以不继承任何类，例如：

6.4.2 操作方法的异步、返回值、状态码

1. 异步及返回值

IActionResult返回值：

添加一个Hello控制器并编写操作方法，并且在返回404异常码时添加异常原因

using Microsoft.AspNetCore.Http;
using Microsoft.AspNetCore.Mvc;
using System.ComponentModel.Design.Serialization;

namespace WebApplicationTest.Controllers
{
    [Route("api/[controller]")]
    [ApiController]
    public class HelloController : ControllerBase
    {
        [HttpGet]
        public IActionResult GetOrder(int id)
        {
            if (id==1)
            {
                return Ok(100);
            }
            else if (id==2)
            {
                return Ok(200);
            }
            else
            {
                return NotFound("id错误");
            }
        }
    }
}

启动调试

异常：

由于IActionResult不包含返回值的类型信息，Swagger无法从操作方法中获取返回数据的类型信息，所以ASP.Net Core中提供了一个泛型ActionResult<T>

ActionResult<T>作为返回值，新增操作方法：

 [HttpGet("{id}")]
 public ActionResult<Person> GetOrderFX(int id)
 {
     if (id == 1)
     {
         return new Person("枸杞泡茶", 18);
     }
     else if (id == 2)
     {
         return new Person("牧羊人", 27);
     }
     else
     {
         return NotFound("id错误");
     }
 }

启动调试：

2. 异常响应码及统一响应体

一般在项目开发中，需要统一响应报文体的格式，以便客户端进行错误处理。例如此处声明一个ErrorInfo类表示错误详情：

namespace WebApplicationTest
{
    public record ErrorInfo(int ErrorCode ,string ?Message);
}

改造【GetOrderFX】方法：

 [HttpGet("{id}")]
 public ActionResult<Person> GetOrderFX(int id)
 {
     if (id<=0)
     {
         return BadRequest(new ErrorInfo(100, "id需为正数！"));
     }
     else if (id == 1)
     {
         return new Person("枸杞泡茶", 18);
     }
     else if (id == 2)
     {
         return new Person("牧羊人", 27);
     }
     else
     {
         return NotFound(new ErrorInfo(100,"人员不存在！"));
     }
 }

启动调试

6.4.3 操作方法的参数从哪里来

给服务端WebAPI传参时，有URL、QueryString，请求报文体，三种

1. 从URL获取

例如新增一个控制器

 [HttpGet("N1/{number1}/N2/{number2}")]
 public int  Add(int number1,int number2)
 {
     return number1+number2;
 }

启动调试

2. QueryString

对于通过QueryString传递的参数，使用 [FromQuery]获取值

编写一个控制方法：

[HttpPost]
public int AddQueryString([FromQuery]int number1, [FromQuery] int number2)
{
    return number1 + number2;
}

启动调试：

调试结果查看，默认的方式其实就是QueryString方式，如果需要显式设置：

 [HttpPost]
 public int AddQueryString([FromQuery]int number1, [FromQuery] int number2)
 {
     return number1 + number2;
 }

3. 请求报文体

新增一个操作

[HttpPost]
public string AddUser(Person ppp1)
{
    return "保存成功！"+ppp1.Name +",Age:"+ppp1 .Age;
}

启动调试

Json请求报文体

响应：

当然，这几种方式也可以混用：

[HttpPut("{Name}")]
public string AddUser1(string Name, Person ppp1)
{
    return "保存成功！" + ppp1.Name + ",Age:" + ppp1.Age+","+Name;
}

启动调试

响应