.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 说实话,上面的这个类,我没搞懂到底怎么用,有知道的朋友请在评论中回复,我将把它加入文中,感谢。

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 早日到来

好了,以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,如果有疑问大家可以留言交流,谢谢大家对的支持。

标签: NET Core