深入理解 ASP.NET Core Web API：从哲学到一对多模型（Models & 1:N 关系）

引言：为何需要 API 与数据库？

API 本质上是位于数据库之上的一层安全封装，让外部只能通过受控接口访问、修改数据；而数据库就像“智能文件柜”或“高级 Excel”，支持高速检索与多表关联，才被各大企业广泛采用。

一、模型（Models）与文件柜、表格的比喻

数据库：犹如大型文件柜，存储各类分门别类的文件；
模型/POCO：就是文件柜中的单个抽屉（Drawer），定义了该抽屉中表单（Sheet）的格式；
实体实例：则是根据模型产生的表单（数据行），最终存入数据库。

二、创建 Models 文件夹与 Stock 模型

在 API 根目录右键新增 Models 文件夹。

在 Models 内新建 Stock.cs，并依次添加属性：

public class Stock
{
   public int Id { get; set; }                    // 主键 ID
   public string Symbol { get; set; } = string.Empty;
   public string CompanyName { get; set; } = string.Empty;
   [Column(TypeName = "decimal(18,2)")]
   public decimal PurchasePrice { get; set; }     // 金额需用 decimal，保留两位小数
   public decimal LastDividend { get; set; }
   public string Industry { get; set; } = string.Empty;
   public long MarketCap { get; set; }            // 市值可能达到万亿，用 long
}

三、为何要用主键与外键？

主键（Primary Key）：唯一标识父实体（Parent），如 Stock.Id；
外键（Foreign Key）：在子实体（Child）中引用父实体主键，形成一对多（1\:N）关联。

类似“父母—子女”关系：一个 Stock 可能关联多条 Comment，却只能对应一条。

四、在 Stock 中添加导航属性（“一”端）

public class Stock
{
    // … 上述属性 …

    // 一对多：一个 Stock 可有多条评论
    public List < Comment > Comments { get; set; } = new();
}

Comments 作为导航属性，允许通过 .Comments 快速访问关联的所有评论。

五、创建 Comment 模型并定义外键与导航属性

在 Models/Comment.cs 中新增：

public class Comment
{
    public int Id { get; set; }                     // 主键
    public string Title { get; set; } = string.Empty;
    public string Content { get; set; } = string.Empty;
    public DateTime CreatedOn { get; set; }         // 创建时间

    // 外键字段：引用 Stock.Id
    public int StockId { get; set; }                // 外键【截图时间节点：4:05】
    // 导航属性：对应单个 Stock（“多”端导航到“父”实体）
    public Stock Stock { get; set; } = null!;
}