Controller继承自ControllerBase,只不过增加了视图相关的方法,一般mvc项目选用Controller而Web API项目选择ControllerBase即可。
操作方法的返回值和状态码
ASP.NET Core Web API中的操作方法返回值如果是普通数据类型,则返回值默认被序列化为JSON格式的响应报文体返回。
[HttpGet]
public int Add(int a)
{
//这里方法返回的是int类型,但是在Web API中的
//返回值默认被序列化为JSON格式,所以这里前端取到的是json类型的返回值
return a++;
}
ASP.NET Core Web API也支持IActionResult<T>
类型,这里推荐使用
[Route("api/[controller]/[action]")]
[ApiController]
public class TestController : ControllerBase
{
[HttpGet("{id}")]
public ActionResult<Person> GetPerson(int id)
{
if (id <= 0)
{
//返回一个400的http状态码
return BadRequest("id必须是正数");//继承自ACtionResult
}
else if (id == 1)
{
//StatusCode指定http的状态码
return StatusCode(200, new Person(1, "tom", 18));
}
else if (id == 2)
{
return new Person(2, "Zack", 8);
}
else
{
//返回一个404的http状态码
return NotFound("人员不存在");//继承自ACtionResult
}
}
}
public record Person(int Id,string Name,int Age);
对于失败的请求,一般要统一响应报文体的格式以便在客户端进行处理。
public record ErrorInfo(int Code, string? Message);
声明一个表示错误的详细信息类
其中code参数表示错误的自定义业务代码
//使用ErrorInfo改造GetPerson方法
[HttpGet("{id}")]
public ActionResult<Person> GetPerson(int id)
{
if (id <=