美国当地时间12月4日,微软2019开发者大会中发布了一系列的重磅消息,包含了软硬件和开源社区的各种好消息是铺天盖地,作为一名普通的开发者,我第一时间下载了 .NET Core 2.2 的源码,针对发布说明逐条浏览,并截取了部分常用的功能进行尝试,下面就与大家分享。话不多说了,来一起看看详细的介绍吧
1. 对 API 接口统一大小写的支持
1.1 查看以下接口代码
[HttpGet] public ActionResult<UserInfo> Get() { return new UserInfo() { Name = "Ron.liang", RegTime = DateTime.Now }; } [HttpGet("{id}")] public ActionResult<Dictionary<string, string>> Get(int id) { return new Dictionary<string, string> { { "Name", "Ron.liang" }, { "RegTime", DateTime.Now.ToString() } }; } // 接口 1 输出 { name: "Ron.liang", regTime: "2018-12-05T10:40:37.5090634+08:00" } // 接口 2 输出 { Name: "Ron.liang", 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 { public override IEnumerable<ValidationAttribute> GetValidationAttributes() { return new List<ValidationAttribute> { new RequiredAttribute(), new RegularExpressionAttribute(pattern: "[A-Za-z]*"), new StringLengthAttribute(maximumLength: 20) }; } }
2.3 看起来是不是简洁多了
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, for="StatusMessage" />
4.2 如果你现在尝试使用 .NET Core 2.2 创建新的 MVC 项目,你就马上可以看到该变化了
5. 钩子
5.1 通过设置环境变量,可以在程序 Main 方法运行前执行一些业务逻辑,但是 .NET Core 团队建议,该功能只是一些低级的钩子,不要用于复杂的业务,如有需要,还是应该使用依赖注入,有空再尝试一下该功能,应该会很有意思
结语
在 .NET Core 2.2 版本中,有很多性能上的优化,可以看到开源社区的力量确实强大,本文仅节选了部分常用功能进行尝试,相信后续会有更多朋友的分享
期待 3.0 早日到来