书接上回,我们继续来聊聊.NET9和C#13带来的新变化。
01、Linq新方法 CountBy 和 AggregateBy
引入了新的方法 CountBy 和 AggregateBy后,可以在不经过GroupBy 分配中间分组的情况下快速完成复杂的聚合操作,同时方法命名也非常直观,可以大大提升工作效率。
我们先以CountBy为例,简单实现一个小功能,统计不同年龄有多少人,代码如下:
public class Student { public string Name { get; set; } public int Age { get; set; } } public void CountByExample() { var students = new List<Student> { new Student { Name = "小明", Age = 10 }, new Student { Name = "小红", Age = 12 }, new Student { Name = "小华", Age = 10 }, new Student { Name = "小亮", Age = 11 } }; //统计不同年龄有多少人,两个版本实现 //.NET 9 之前 var group = students.GroupBy(x => x.Age); foreach (var item in group) { Console.WriteLine($"年龄为:{item.Key},有:{item.Count()} 人。"); } //.NET 9 foreach (var student in students.CountBy(c => c.Age)) { Console.WriteLine($"年龄为:{student.Key},有:{student.Value} 人。"); } }
通过代码可以发现,老版本中必须先调用GroupBy分组再调用Count统计才可完成,而现在只需要调用CountBy即可。
我们再以AggregateBy为例子,看看新老版本中如何计算每个班级中各自学生总年龄,代码如下:
public class Student { public string Name { get; set; } public string Grade { get; set; } public int Age { get; set; } } public void AggregateByExample() { var students = new List<Student> { new Student { Name = "小明", Grade = "一班", Age = 10 }, new Student { Name = "小红", Grade = "二班", Age = 12 }, new Student { Name = "小华", Grade = "一班", Age = 10 }, new Student { Name = "小亮", Grade = "二班", Age = 11 } }; //统计每个班级各自学生总年龄,两个版本实现 //.NET 9 之前 var old = students .GroupBy(stu => stu.Grade) .ToDictionary(group => group.Key, group => group.Sum(stu => stu.Age)) .AsEnumerable(); foreach (var item in old) { Console.WriteLine($"班级:{item.Key},总年龄:{item.Value} 。"); } //.NET 9 foreach (var group in students.AggregateBy(c => c.Grade, 0, (acc, stu) => acc + stu.Age)) { Console.WriteLine($"班级:{group.Key},总年龄:{group.Value} 。"); } }
02、序列化加强
在System.Text.Json中,.NET 9为序列化提供了新的选项和一个新的单例。
1、缩进选项
现在可以通过JsonSerializerOptions新属性IndentCharacter和IndentSize,自定义写入 JSON 的缩进字符和缩进大小。看看下面代码。
static void Main() { var options = new JsonSerializerOptions { WriteIndented = true, IndentCharacter = 't', IndentSize = 2, //处理中文乱码 Encoder = JavaScriptEncoder.Create(UnicodeRanges.All) }; var json = JsonSerializer.Serialize( new Student { Name = "小明", Grade = "一班", Age = 10 }, options ); Console.WriteLine(json); Console.ReadKey(); }
代码执行效果如下:
2、默认 Web 选项单例
在之前的版本中如果想要以小驼峰命名规则序列化对象可以配合JsonProperty特性实现。现在则可以直接通过JsonSerializerOptions.Web单例直接实现。
var json = JsonSerializer.Serialize( new Student { Name = "xiaoming", Grade = "yinianji", Age = 10 }, JsonSerializerOptions.Web ); Console.WriteLine(json);
代码执行效果如下:
03、Task新方法Task.WhenEach
在.NET9之前,如果我们有一个任务列表,并希望每个任务完成后立刻处理它,那么我们只能通过不停的调用Task.WaitAny()方法来实现,现在.NET9引入了Task.WhenEach方法,以一种更优雅、更高效的方式处理这种情况。
因为Task.WhenEach 返回 IAsyncEnumerable<Task
async Task WhenEachAsync() { //生成100个随机时间完成的任务列表 var tasks = Enumerable.Range(1, 100) .Select(async i => { await Task.Delay(new Random().Next(1000, 5000)); return $"任务 {i} 完成"; }) .ToList(); //.NET 9 之前 while (tasks.Count > 0) { var completedTask = await Task.WhenAny(tasks); tasks.Remove(completedTask); Console.WriteLine(await completedTask); } //.NET 9 await foreach (var completedTask in Task.WhenEach(tasks)) { Console.WriteLine(await completedTask); } }
04、新的 TimeSpan.From* 重载
在.NET9之前TimeSpan类提供了几种From*方法,可以使用double类型来创建TimeSpan对象。但是,由于double是基于二进制的浮点格式,因此固有的不精确性可能会导致错误。
为了解决这个问题,.NET 9 添加了新的重载方法,可以使用整数创建TimeSpan对象。
如下面这段代码:
TimeSpan timeSpan1 = TimeSpan.FromSeconds(value: 101.832); Console.WriteLine($"timeSpan1 = {timeSpan1}"); // timeSpan1 = 00:01:41.8319999 TimeSpan timeSpan2 = TimeSpan.FromSeconds(seconds: 101, milliseconds: 832); Console.WriteLine($"timeSpan2 = {timeSpan2}"); // timeSpan2 = 00:01:41.8320000
05、新的内置Swagger
从.NET9开始使用Scalar代替内置的Swagger(Swashbuckle),一方面是因为Swashbuckle项目维护不够积极,另一个方面也是内部希望更专业于OpenAPI的发展。不管原因如何,我们都要根据自己的情况做好选择。
下面我们来一起体验一下Scalar。
首先创建一个Web Api项目,然后安装Scalar.AspNetCore包,修改Prag代码如:
public static void Main(string[] args) { var builder = WebApplication.CreateBuilder(args); builder.Services.AddControllers(); builder.Services.AddOpenApi(); var app = builder.Build(); // scalar/v1 app.MapScalarApiReference(); app.MapOpenApi(); app.UseAuthorization(); app.MapControllers(); app.Run(); }
然后我们添加一个简单的控制器,添加增删改查四个方法,代码如下:
[ApiController] [Route("[controller]")] public class OrdersController : ControllerBase { private static readonly string[] Summaries = new[] { "Freezing", "Bracing", "Chilly", "Cool", "Mild", "Warm", "Balmy", "Hot", "Sweltering", "Scorching" }; private readonly ILogger<OrdersController> _logger; public OrdersController(ILogger<OrdersController> logger) { _logger = logger; } [HttpGet(Name = "")] public IEnumerable<Order> Get() { return Enumerable.Range(1, 5).Select(index => new Order { Date = DateOnly.FromDateTime(DateTime.Now.AddDays(index)), Price = Random.Shared.Next(-20, 55), Name = Summaries[Random.Shared.Next(Summaries.Length)] }) .ToArray(); } [HttpPost(Name = "")] public bool Post(Order order) { return true; } [HttpPut(Name = "{id}")] public bool Put(string id, Order order) { return true; } [HttpDelete(Name = "{id}")] public bool Delete(string id) { return true; } }
然后我们允许代码看看效果:
卖相还是相当惊艳的,左侧是接口列表,左下角可以切换黑白两种风格主题,右侧是接口详情,同时还配备了多种语言请求格式。
我们点击右下角Test Request测试一下获取接口。
可以在左边填写好参数,添加最上面的Send,会看到右下角请求结果。更详细复杂的应用大家可以自己摸索摸索。
注:测试方法代码以及示例源码都已经上传至代码库,有兴趣的可以看看。https://gitee.com/hugogoos/Planner