ASP.NET Core开发:从基础到实践
1. 结果类型与序列化
当所有结果路径返回相同类型的结果对象(如 MyType
)时,操作方法可声明为返回 ActionResult<MyType>
。这种方式能进行更好的类型检查,也可返回如 NotFound
这样的响应。
默认情况下,结果对象在响应体中以 JSON 格式序列化。不过,如果在 ASP.NET Core 框架处理管道中添加了 XML 格式化器,结果的序列化方式将取决于 HTTP 请求的 Accept
头。具体而言,若客户端通过 Accept
头明确要求 XML 格式,对象将以 XML 格式序列化;否则,将以 JSON 格式序列化。
复杂对象作为输入传递给操作方法时,可使用验证属性进行验证,示例代码如下:
public record MyType
{
[Required]
public string Name{get; set;}
...
[MaxLength(64)]
public string Description{get; set;}
}
若控制器使用 [ApiController]
属性修饰,且验证失败,ASP.NET Core 框架会自动创建一个包含所有检测到的验证错误的 BadRequest
响应,而无需执行操作方法,因此无需额外添加