asp,net core 3.1 的 Controller 和 Action

对于 MVC 视图应用而言，Action 返回的结果通常是一个 View，即页面；

而对于 Web API 应用程序来说，则返回相应的资源或者 HTTP 状态码。

Controller

根据约定，继承自位于 Microsoft.AspNetCore.Mvc 命名空间下的 Controller 类，而这个 Controller 类又继承自 ControllerBase 抽象类。

如果一个类并不满足上述约定，那么只要为它添加[Controller]特性，仍然能够将它作为 Controller 处理；反之，如果为一个 Controller 添加[NotController]特性。

[Controller]
public class Blogs
{
}

[NonController]
public class ValueController
{
}

Action

每个 Action 都应返回 IActionResult 类型或ActionResult<T> 类型的值作为 HTTP 请求的结果。

常见的类别，包括

1. 状态码
2. 对象的状态码
3. 重定向
4. 内容

状态码

返回一个 HTTP 状态码给客户端

对应的状态码	描述	ControllerBase中的方法
200	操作成功	Ok()
400	错误的请求	BadRequest()
204	操作成功，但未返回任何内容	NoContent()
404	请求的资源找不到	NotFound()
401	未授权	Unauthorized()
415	无法处理请求附带的媒体格式	无

如果要返回上述状态码之外的结果，则可以使用 StatusCode 方法，并为该方法指明具体的状态码。

return StatusCode(403);

直接使用状态码数字有可能会出错，更简单且直观的方法是，使用Microsoft.AspNetCore.Http 命名空间下的 StatusCodes 静态类

return StatusCode(Microsoft.AspNetCore.Http.StatusCodes.Status200OK);

对象的状态码

这一类结果继承自 ObjectResult，包括 OkObjectResult、CreatedResult 和 NotFoundObjectResult 等。

public IActionResult DoSomething()
{
		var result = new OkObjectResult(new { message = "success", currentDate = DateTime.Now});
		return result;
}

重定向

包括 RedirectResult、LocalRedirectResult、RedirectToActionResult 和 RedirectToRouteResult 等。

// 重定向到指定的URL
return Redirect("http://www.asp.net/");
// 重定向到当前应用程序中的另一个URL
return LocalRedirect("/account/login");
// 重定向到指定的Action
return RedirectToAction("login");
// 重定向到指定的路由
return RedirectToRoute("default"， new { action = "login", controller = "Login" });

内容

包括 ViewResult、PartialViewResult、JsonResult 和 ContentResult 等，其中 ViewResult 和 PartialViewResult 在 MVC 视图应用中非常常见，用于返回相应的页面；JsonResult 用于返回JSON 字符串，ContentResult 用于返回一个字符串。