项目代码第2讲：从0实现LoginController.cs，UsersController.cs、User相关的后端接口对应的前端界面

news2025/1/6 18:09:14

一、User

1、使用数据注解设置主键和外键

设置主键：在User类的U_uid属性上使用[Key]注解。
设置外键：在Order类中，创建一个表示外键的属性（例如UserU_uid），并使用[ForeignKey]注解指定它引用User类的哪个属性。同时，在导航属性上使用[Required]（如果外键不允许为空）和[InverseProperty]（用于指定反向导航属性，可选）注解。

但是，通常我们会将外键属性的名称设置为与它所引用的主键属性名称相同（或遵循某种命名约定），这样EF可以自动推断出外键关系，而无需显式使用[ForeignKey]注解。

using System.ComponentModel.DataAnnotations;
using System.ComponentModel.DataAnnotations.Schema;

namespace WebServerTest.Models
{
    public class User
    {
        [Key]
        public int U_uid { get; set; }
        public string U_name { get; set; }
        public string U_password { get; set; }
        public string U_email { get; set; }
        public string U_identity { get; set; }

        // 导航属性
        public ICollection<Order> Orders { get; set; }
    }

    public class Order
    {
        [Key]
        public int OrderId { get; set; }
        public string OrderDetails { get; set; }

        // 外键属性（通常与所引用的主键属性名称相同或遵循命名约定）
        public int U_uid { get; set; }

        // 导航属性
        [ForeignKey("U_uid")] // 实际上，如果属性名称与User类中的主键名称相同，这个注解可以省略
        public User User { get; set; }
    }
}

2、连接Mysql数据库

1>安装必要的 NuGet 包

Pomelo.EntityFrameworkCore.MySql：这是一个流行的 Entity Framework Core 提供程序，用于与 MySQL 数据库交互。
Microsoft.EntityFrameworkCore.Tools（可选）：这个包提供了一些有用的工具，比如迁移工具。

2>`ServerVersion` 参数

这个参数的缺失可能会导致问题，特别是当 MySql 提供程序需要知道服务器的确切版本来正确处理某些数据库特性或行为时。

通常，如果你不确定服务器的版本，或者想要避免在多个地方硬编码版本信息，使用 ServerVersion.AutoDetect(connectionString) 是一个好方法。它会尝试根据提供的连接字符串自动检测服务器的版本。

3>每一次添加新表、修改现有表的结构或进行其他数据库架构更改时，都要迁移使用:Add-Migration MyMigration -Context和更新数据库使用:update-database

查看现有迁移：
首先，通过“程序包管理器控制台”（Package Manager Console）运行以下命令来查看当前项目中的所有迁移：

Get-Migration
这个命令会列出所有已生成的迁移文件及其顺序。
删除迁移文件：
找到你想要删除的迁移文件（通常是上一次生成的迁移文件），并手动从项目的“Migrations”文件夹中删除它。
回退数据库：
由于迁移文件已经被删除，你需要将数据库架构回退到上一次迁移之前的状态。这可以通过在“程序包管理器控制台”中运行以下命令来实现：

Update-Database -TargetMigration [PreviousMigrationName]
其中 [PreviousMigrationName] 是上一次迁移之前的迁移名称。如果这是你的第一个迁移并且你想要完全重置数据库，你可能需要使用 -TargetMigration:0（这取决于你的具体迁移配置，有时可能是其他值，比如一个特殊的起始迁移名称）。

请注意，回退数据库可能会导致数据丢失，特别是如果删除的迁移包含了破坏性更改（如删除表或列）。因此，在执行此操作之前，请确保你已经备份了数据库。
清理迁移历史记录（可选）：
如果你想要完全清理迁移历史记录（即删除 __EFMigrationsHistory 表中的记录），你需要手动执行 SQL 脚本来删除这些记录。但是，这通常是不推荐的，因为它可能会导致数据库与迁移记录不一致。更好的做法是让迁移历史记录保持原样，以便将来可以轻松地跟踪和回退迁移。

4>全局取消跟踪机制

二、User的增删改查

1、[HttpGet("{id}")]

1>使用 `.FindAsync` 查找用户：使用主键索引，异步地从数据库中查找一个实体。

注意：它只查找主键列，而不是表中的所有列。

如果 FindAsync 方法返回 null，这意味着在数据库中没有找到具有指定 id 的用户实体。在这种情况下，您的代码返回 NotFound()，这是一个HTTP 404状态码，表示请求的资源不存在。

2>加上通过邮箱查询

ToList：
- 是一个同步方法，会立即执行并将结果加载到内存中。
- 如果处理的集合非常大，可能会阻塞当前线程并影响应用程序的响应性。
ToListAsync：
- 是一个异步方法，会返回一个Task<List<T>>对象，表示异步操作的任务。
- 使用await关键字可以等待异步操作完成并获取结果。
- 在等待期间，当前线程不会被阻塞，可以继续执行其他任务。