番摊机器人 我们成功运行了第一个.NET 8控制台程序，初步接触了C#的基础语法
一、前言：从"能写"到"写得好"
在上一篇入门教程中，我们成功运行了第一个.NET 8控制台程序，初步接触了C#的基础语法。对于有其他编程语言基础的开发者来说，C#的语法会带来一种熟悉感，但在现代.NET 8的Web API开发场景中，传统的编程思路已经无法满足高效、安全、可维护的开发需求。
现代Web API开发更注重代码的简洁性、执行的高效性以及数据的安全性。我们不再依赖繁琐的类继承和重复的属性封装，而是充分利用C#的语法糖和新特性，用更少的代码实现更强大的功能，同时降低出错的概率。本篇教程将聚焦三个核心领域：如何优雅定义API的输入输出数据载体、如何通过异步编程避免服务器阻塞、如何高效处理内存中的数据集合。
二、数据载体的革命：从Class到Record
在Web API开发过程中，数据传输是核心环节。前端发送的JSON数据需要解析为后端对象，后端从数据库查询的数据也要封装为对象返回给前端，这些用于数据传输的对象被称为DTO（Data Transfer Objects）。
2.1 传统Class的痛点
在传统的C#开发中，定义一个用户数据传输类通常需要编写大量重复代码：
public class UserDto
{
public int Id { get; set; }
public string Name { get; set; }
public string Email { get; set; }
// 为了实现值相等性比较，需要重写Equals方法
public override bool Equals(object obj)
{
if (obj == null || GetType() != obj.GetType())
return false;
UserDto other = (UserDto)obj;
return Id == other.Id && Name == other.Name && Email == other.Email;
}
// 重写GetHashCode方法以配合Equals方法
public override int GetHashCode()
{
return HashCode.Combine(Id, Name, Email);
}
}
这种方式不仅代码冗长，还存在数据易被意外修改的风险，在多线程环境下可能引发难以排查的问题。
2.2 使用Record定义不可变模型
C# 9引入的Record（记录类型）完美解决了传统Class的痛点，我们可以用一行代码定义一个强类型的不可变模型：
public record User(int Id, string Name, string Email);
编译器会自动为Record类型生成以下内容：
一个包含所有属性的构造函数
只读属性（默认不可变，确保数据在传递过程中不被意外篡改）
重写后的Equals、GetHashCode和ToString方法
2.3 Record特性实战演练
我们可以通过一个简单的控制台程序来测试Record的强大特性：
// 定义Record类型
public record User(int Id, string Name, string Email);
class Program
{
static void Main()
{
// 1. 构造对象
var user1 = new User(1, "张三", "zhangsan@example.com");
Console.WriteLine(user1);
// 输出: User { Id = 1, Name = 张三, Email = zhangsan@example.com }
// 2. 值相等性比较
var user2 = new User(1, "张三", "zhangsan@example.com");
// 即使是两个不同的对象实例，内容相同也被认为相等
Console.WriteLine(user1 == user2);
// 输出: True（这是传统Class无法直接实现的）
// 3. 不可变性与with表达式
// user1.Name = "李四"; // 错误！Record默认是只读的，无法直接修改属性
// 如果需要修改数据，使用with表达式创建一个新的副本
var user3 = user1 with { Name = "李四" };
Console.WriteLine(user3);
// 输出: User { Id = 1, Name = 李四, Email = zhangsan@example.com }
}
}
在Web API开发中，Record是定义DTO的首选方案。它的不可变性保证了数据传输的安全性，内置的值比较逻辑让单元测试和状态判断变得异常简单，大幅提升了代码的可维护性。
三、Web开发的生命线：异步编程（Async/Await）
异步编程是现代Web API开发中最重要的技术之一。很多新手开发者开发的网站在低并发场景下运行正常，但一旦访问量增加就会出现服务器卡死的情况，根本原因就是没有掌握异步编程的核心思想。
3.1 为什么需要异步编程？
我们可以用餐厅的服务流程来类比同步和异步编程的区别：
同步模式：服务员下单后，站在厨房门口等待菜品做好，期间无法为其他客人服务。如果厨房出菜速度慢，整个餐厅的服务效率会极低。
异步模式：服务员下单后，将订单交给厨房，立即返回为其他客人服务。当菜品做好后，厨房通知服务员端菜给客人。
在Web开发中，"厨房"就相当于数据库、文件系统或外部API。如果使用同步代码访问这些资源，服务器线程会被阻塞等待，导致大量资源被浪费，无法处理更多的用户请求。而通过异步编程，服务器可以在等待资源响应的同时处理其他请求，大幅提升系统的并发处理能力。
3.2 Task：未来的承诺
在.NET中，Task和Task是异步编程的核心类型，它们代表一个"正在进行"或"将来完成"的任务：
Task：代表一个没有返回值的异步操作，比如写入文件、发送邮件等。
Task：代表一个将来会返回T类型结果的异步操作，比如查询数据库、调用外部API获取数据等。
3.3 实战：模拟异步数据查询
我们通过模拟网络请求来体会异步编程的优势：
using System;
using System.Threading.Tasks;
class Program
{
static async Task Main()
{
Console.WriteLine("开始处理请求...");
// 异步调用模拟的网络请求
var result = await FetchDataFromApiAsync();
Console.WriteLine($"获取到的数据：{result}");
Console.WriteLine("请求处理完成");
}
// 模拟一个需要2秒才能完成的网络请求
static async Task<string> FetchDataFromApiAsync()
{
Console.WriteLine("开始调用外部API...");
// 模拟网络延迟
await Task.Delay(2000);
return "来自API的响应数据";
}
}
在这个示例中，使用async和await关键字标记异步方法，编译器会自动处理异步操作的状态管理，让我们可以用同步代码的编写方式实现异步逻辑，大幅降低了异步编程的复杂度。
3.4 Web API中的异步实践
在ASP.NET Core Web API中，我们应该将所有涉及IO操作的方法都设计为异步方法，比如数据库查询、文件读写、外部API调用等：
[ApiController]
[Route("api/[controller]")]
public class ProductsController : ControllerBase
{
private readonly IProductRepository _repository;
public ProductsController(IProductRepository repository)
{
_repository = repository;
}
// 异步获取所有产品
[HttpGet]
public async Task<ActionResult<IEnumerable<Product>>> GetAllProducts()
{
var products = await _repository.GetAllAsync();
return Ok(products);
}
// 异步根据ID获取产品
[HttpGet("{id}")]
public async Task<ActionResult<Product>> GetProduct(int id)
{
var product = await _repository.GetByIdAsync(id);
if (product == null)
{
return NotFound();
}
return Ok(product);
}
}
通过异步编程，我们的Web API可以同时处理更多的用户请求，提升系统的响应速度和稳定性。
四、数据处理的利器：LINQ查询表达式
在Web API开发中，我们经常需要对内存中的数据集合进行各种处理，比如过滤、排序、分组、投影等。C#中的LINQ（Language Integrated Query）为我们提供了一种简洁、强大的数据处理方式，让我们可以像写SQL语句一样处理内存中的数据。
4.1 LINQ的基本语法
LINQ提供了两种语法形式：查询表达式语法和方法链式语法，我们可以根据实际需求选择合适的语法形式。
查询表达式语法：
var result = from p in products
where p.Price > 10
orderby p.Price descending
select new { p.Name, p.Price };
方法链式语法：
var result = products
.Where(p => p.Price > 10)
.OrderByDescending(p => p.Price)
.Select(p => new { p.Name, p.Price });
4.2 常用LINQ操作符
LINQ提供了丰富的操作符，满足各种数据处理需求：
过滤：Where、OfType
排序：OrderBy、OrderByDescending、ThenBy、ThenByDescending
投影：Select、SelectMany
分组：GroupBy
聚合：Count、Sum、Average、Max、Min
连接：Join、GroupJoin
分页：Skip、Take
4.3 LINQ在Web API中的应用
在Web API中，我们可以使用LINQ对从数据库查询到的数据进行进一步处理，或者对前端传递的参数进行验证和转换：
[HttpGet]
public async Task<ActionResult<IEnumerable<ProductDto>>> GetProducts(
[FromQuery] decimal? minPrice,
[FromQuery] decimal? maxPrice,
[FromQuery] string category)
{
var products = await _repository.GetAllAsync();
// 使用LINQ进行数据过滤
var query = products.AsQueryable();
if (minPrice.HasValue)
{
query = query.Where(p => p.Price >= minPrice.Value);
}
if (maxPrice.HasValue)
{
query = query.Where(p => p.Price <= maxPrice.Value);
}
if (!string.IsNullOrEmpty(category))
{
query = query.Where(p => p.Category.Equals(category, StringComparison.OrdinalIgnoreCase));
}
// 使用LINQ进行投影，将Product转换为ProductDto
var result = query.Select(p => new ProductDto
{
Id = p.Id,
Name = p.Name,
Price = p.Price,
Category = p.Category
}).ToList();
return Ok(result);
}
通过LINQ，我们可以用简洁的代码实现复杂的数据处理逻辑，提升代码的可读性和可维护性。
五、总结
通过本篇教程的学习，我们掌握了.NET 8 Web API开发中三个核心的C#现代语法特性：
Record类型：用于定义不可变的数据传输对象，简化代码编写，提升数据安全性。
异步编程：通过async/await和Task类型，实现高效的并发处理，避免服务器阻塞。
LINQ查询表达式：用简洁的语法实现复杂的数据处理逻辑，提升代码的可读性和可维护性。
这些现代语法特性是构建高效、安全、可维护的.NET 8 Web API的基础，掌握它们可以让我们从"能写代码"提升到"写好代码"的层次。在后续的教程中，我们将学习如何使用这些特性构建完整的Web API应用。