.NET Core 2.2 新增部分功能使用尝鲜

前言

    美国当地时间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 说实话，上面的这个类，我没搞懂到底怎么用，有知道的朋友请在评论中回复，我将把它加入文中，感谢。（经 牛排大叔. 解释，ProducesResponseTypeAttribute应该是给swagger显示API返回描述配套用的。 感谢！

4. Razor 视图部分优化

• 4.1 .NET Core 团队认为，在 Razor 视图中，如果使用 @Html.Parital 引入分部视图，可能存在潜在的死锁情况，所以将 @Html.Parital 变更为

 //旧的：
 @Html.Partial("_StatusMessage", Model.StatusMessage)

 // 新的：
 <partial name="_StatusMessage", for="StatusMessage" />

• 4.2 如果你现在尝试使用 .NET Core 2.2 创建新的 MVC 项目，你就马上可以看到该变化了

5. 钩子

• 5.1 通过设置环境变量，可以在程序 Main 方法运行前执行一些业务逻辑，但是 .NET Core 团队建议，该功能只是一些低级的钩子，不要用于复杂的业务，如有需要，还是应该使用依赖注入，有空再尝试一下该功能，应该会很有意思

结语

• 在 .NET Core 2.2 版本中，有很多性能上的优化，可以看到开源社区的力量确实强大，本文仅节选了部分常用功能进行尝试，相信后续会有更多朋友的分享
• 期待 3.0 早日到来