- A+
所属分类:.NetCore
前言
美国当地时间12月4日,微软2019开发者大会中发布了一系列的重磅消息,包含了软硬件和开源社区的各种好消息是铺天盖地,作为一名普通的开发者,我第一时间下载了 .NET Core 2.2 的源码,针对发布说明逐条浏览,并截取了部分常用的功能进行尝试,下面就与大家分享。
1.对 API 接口统一大小写的支持
1.1 查看以下接口代码
- [HttpGet]
- public ActionResult<UserInfo> Get()
- {
- return new UserInfo() { Name = "YuXi", RegTime = DateTime.Now };
- }
- [HttpGet("{id}")]
- public ActionResult<Dictionary<string, string>> Get(int id)
- {
- return new Dictionary<string, string> {
- { "Name", "YuXi" },
- { "RegTime", DateTime.Now.ToString() }
- };
- }
- // 接口 1 输出
- {
- name: "YuXi",
- regTime: "2018-12-05T10:40:37.5090634+08:00"
- }
- // 接口 2 输出
- {
- Name: "YuXi",
- RegTime: "2018-12-05T10:40:58.5072645+08:00"
- }
1.2 默认情况下,字典内地字段名称将不会被应用 CamelCaseNamingStrategy ,所以如果要保持字段名称大小写统一的问题,可在 ConfigureServices 中加入 AddJsonOptions(o => o.UseCamelCasing(true))
- public void ConfigureServices(IServiceCollection services){
- services.AddMvc().AddJsonOptions(o => o.UseCamelCasing(false)).SetCompatibilityVersion(CompatibilityVersion.Version_2_2);
- }
AddJsonOptions 内置两个默认扩展,你可以使用 UseCamelCasing 或者 UseMemberCasing ,如果使用 UseMemberCasing ,表示使用成员字段的大小写规则,即不改变大小写输出
1.3 有意思的是,AddJsonOptions(o => o.UseCamelCasing(true)) 显式传入值的方式是由 JamesNK 这个哥们杠出来的结果,详见
- https://github.com/aspnet/Mvc/pull/7962
2. 复合验证-验证模型的扩展
1.1 在之前的版本中,如果希望对一个属性应用多个验证,必须书写多个验证类,如
- public class UserInfo
- {
- [StringLength(20), RegularExpression(@"^[a-zA-Z]$")]
- public string Name { get; set; }
- [StringLength(20), RegularExpression(@"^[a-zA-Z]$")]
- public string Title { get; set; }
- public DateTime RegTime { get; set; }
- }
2.2 在 .NET Core 2.2 以后的版本中,你可以通过扩展来避免这个问题,通过继承自 ValidationProviderAttribute 并重写 GetValidationAttributes 方法来实现复合验证
- public class UserInfo
- {
- [Name]
- public string Name { get; set; }
- [Name]
- public string Title { get; set; }
- public DateTime RegTime { get; set; }
- }
- public class NameAttribute : ValidationProviderAttribute
看起来是不是简洁多了
3. API Controller 增加默认的响应处理类型
3.1 在以前的版本中,可以通过在 API 上增加特性 ProducesResponseType 来处理不同的 HttpCode 响应,然后 pranavkm 觉得,我们应该像 Swagger/OpenApi 一样,增加一个默认的响应处理类型,然后就出现了
- namespace Microsoft.AspNetCore.Mvc
- {
- /// <summary>
- /// A filter that specifies the type of the value and status code returned by the action.
- /// </summary>
- [AttributeUsage(AttributeTargets.Class | AttributeTargets.Method, AllowMultiple = true, Inherited = true)]
- public class ProducesResponseTypeAttribute : Attribute, IApiResponseMetadataProvider
- {
- ....
- }
3.2 说实话,上面的这个类,我没搞懂到底怎么用,有知道的朋友请在评论中回复,我将把它加入文中,感谢。
4. Razor 视图部分优化
4.1 .NET Core 团队认为,在 Razor 视图中,如果使用 @Html.Parital 引入分部视图,可能存在潜在的死锁情况,所以将 @Html.Parital 变更为
- //旧的:
- @Html.Partial("_StatusMessage", Model.StatusMessage)
- // 新的:
- <partial name="_StatusMessage", for="StatusMessage" />