.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 早日到来
posted @ 2018-12-05 12:36 Ron.liang 阅读(...) 评论(...) 编辑 收藏