ASP.NET Core Web API 模型（Models）详解：从 POCO 到数据库表的一站式指南

引言：什么是 Models？

在 ASP.NET Core Web API 中，Model（也称 POCO——Plain Old C# Object）负责承载业务数据，是应用与数据库交互的核心载体。本文将带你逐步创建模型类，并理解它们如何对应数据库表及列。

一、创建 Models 文件夹与基础 POCO 类

在项目根目录下新建 Models 文件夹。
在其中创建第一个 POCO 类 Pokemon.cs，示例属性：
```
public class Pokemon
{
   public int Id { get; set; }
   public string Name { get; set; }
   public DateTime BirthDate { get; set; }
}
```
这是最简单的 Model，仅由属性构成，用于映射数据库表的列。

二、Model 与数据库表的对应关系

将 Model 看作数据库中的“电子表格”：
每个类对应一张表，每个属性对应一列，属性值对应行数据。
EF Core 会根据 POCO 自动生成 SQL 语句，完成表的创建与操作。
模型使我们无需手写繁琐 SQL，仅用 C# 类即可完成数据持久化。

三、UML 图助力可视化建模

使用 UML 类图整理各实体及字段：

+---------------+

|  Pokemon      |

|---------------|

| Id            |

| Name          |

| BirthDate     |

+---------------+



+---------------+

|  Owner        |

|---------------|

| Id            |

| Name          |

| Gym           |

+---------------+

UML 清晰展示模型字段及后续关系（1:1、1\:N、N\:N），便于团队协作与设计评审。

四、补充其他核心实体模型

Owner

   public class Owner
   {
       public int Id { get; set; }
       public string Name { get; set; }
       public string Gym { get; set; }
   }

Country

   public class Country
   {
       public int Id { get; set; }
       public string Name { get; set; }
   }

Category

   public class Category
   {
       public int Id { get; set; }
       public string Name { get; set; }
   }

提示：Id 是主键（Primary Key），用于唯一标识和关联外键。

Review 与 Reviewer

   public class Review
   {
       public int Id { get; set; }
       public string Title { get; set; }
       public string Text { get; set; }
   }

   public class Reviewer
   {
       public int Id { get; set; }
       public string FirstName { get; set; }
       public string LastName { get; set; }
   }

Review.Id 唯一标识一条评论，结合外键可实现评论与实体（如 Pokemon）的关联。

小结

Model/POCO：C# 类与数据库表的映射桥梁。
属性：对应数据库列，需严格指定数据类型（int、string、DateTime 等）。
主键与外键：Id 属性为主键，用于唯一识别和建立实体间关系。
UML：可视化模型与字段，助力设计与交流。

下一章将详细解读实体间的 一对多 与 多对多 关系，并演示如何在 EF Core 中配置关联。

原文引自YouTube视频：https://www.youtube.com/watch?v=BnlFovYeQtI