别再只会用MVC了！用ASP.NET Web API从零搭建一个RESTful商品管理接口（.NET Framework版）

从零构建ASP.NET Web API商品管理接口实战指南

在当今快速迭代的互联网产品开发中，RESTful API已成为前后端分离架构的核心枢纽。对于.NET开发者而言，ASP.NET Web API框架提供了一套高效、灵活的工具集，能够快速构建符合行业标准的HTTP服务。本教程将带您从零开始，使用.NET Framework搭建一个功能完整的商品管理API，涵盖从项目初始化到生产级功能实现的完整流程。

1. 环境准备与项目搭建

1.1 开发环境配置

在开始编码前，我们需要确保开发环境准备就绪。推荐使用Visual Studio 2019或更高版本，它提供了完善的.NET开发工具链。以下是必要的环境组件：

• .NET Framework 4.7.2：这是Web API项目的基础运行环境
• NuGet包管理器：用于安装和管理项目依赖
• Postman或Insomnia：API测试工具，用于验证接口功能

创建新项目时，选择"ASP.NET Web应用程序(.NET Framework)"模板，然后在项目类型中选择"Web API"。确保勾选"添加对Web API的引用"选项，这将自动配置基本的Web API基础设施。

1.2 项目结构规划

合理的项目结构对后期维护至关重要。建议采用以下分层架构：

ProductManagementAPI/
├── Controllers/          # API端点定义
├── Models/               # 数据模型和DTO
├── Services/             # 业务逻辑实现
├── Repositories/         # 数据访问层
├── Filters/              # 自定义过滤器
├── App_Start/            # 配置类
└── Global.asax           # 全局应用配置

初始化完成后，首先删除模板生成的ValuesController，我们将从头开始构建自己的商品控制器。

2. 核心功能实现

2.1 数据模型设计

商品管理系统的核心是产品数据模型。在Models文件夹中创建Product.cs：

public class Product
{
    public int Id { get; set; }
    
    [Required, StringLength(100)]
    public string Name { get; set; }
    
    [StringLength(500)]
    public string Description { get; set; }
    
    [Range(0, double.MaxValue)]
    public decimal Price { get; set; }
    
    [Range(0, int.MaxValue)]
    public int Stock { get; set; }
    
    public DateTime CreatedAt { get; set; }
    public DateTime? UpdatedAt { get; set; }
}

数据注解(Data Annotations)为模型添加了验证规则，这些规则将在请求处理时自动生效。

2.2 仓储模式实现

为了解耦数据访问逻辑，我们采用仓储模式。首先定义接口：

public interface IProductRepository
{
    IEnumerable<Product> GetAll();
    Product GetById(int id);
    Product Add(Product product);
    bool Update(Product product);
    bool Delete(int id);
}

然后实现一个基于内存的简单仓储（实际项目中可替换为EF Core或其他ORM）：

public class ProductRepository : IProductRepository
{
    private static readonly List<