当前位置：首页 > news >正文

NetCoreKevin-DDD-微服务-WebApi-AI智能体、AISK集成、MCP协议服务、SignalR、Quartz 框架-14-数据模型与持久化

news 2025/9/2 6:46:46

参考资料

https://github.com/junkai-li/NetCoreKevin

https://gitee.com/netkevin-li/NetCoreKevin

数据模型与持久化

摘要

本文档为NetCoreKevin项目提供了全面的数据模型和持久化机制的概述，涵盖了数据库模式设计、实体关系、数据访问模式以及Entity Framework Core的使用方法。NetCoreKevin是一个基于.NET Core的应用程序，采用了模块化设计，包含用户管理、权限控制、文件存储等多个功能模块。数据层通过Entity Framework Core与数据库交互，使用仓储模式（Repository Pattern）来实现数据访问的抽象。本文档还提供了实体类定义、数据库迁移示例，并讨论了数据优化和版本控制策略。

系统架构

NetCoreKevin项目的系统架构采用了分层设计，数据层是整个系统的核心部分之一。数据层主要由以下组件构成：

实体类（Entities）：定义了数据库表的结构，位于kevin.Domain/Entities目录下。
数据库上下文（DbContext）：负责与数据库的交互，位于Repository/Database/dbContext.cs。
仓储（Repositories）：提供数据访问的抽象接口和实现，位于Repositories/Repositories目录下。
迁移文件（Migrations）：用于管理数据库模式的变更，位于Repository/Migrations目录下。

以下是系统架构的简化视图，展示了数据层与其它层之间的关系：

核心组件

实体类（Entities）

实体类定义了数据库表的结构和关系。以下是TUser实体类的代码示例，展示了用户表的基本字段和关系：

namespace kevin.Domain.Kevin
{/// <summary>/// 用户表/// </summary>public class TUser : CUD{/// <summary>/// 用户名/// </summary>[DisplayName("用户名")]public string Name { get; set; }/// <summary>/// 昵称/// </summary>public string NickName { get; set; }/// <summary>/// 手机号/// </summary>public string Phone { get; set; }/// <summary>/// 邮箱/// </summary>public string Email { get; set; }/// <summary>/// 密码/// </summary>public string PassWord { get; set; }/// <summary>/// 角色信息/// </summary>public Guid RoleId { get; set; }public virtual TRole Role { get; set; }/// <summary>/// 是否超级管理员/// </summary>public virtual bool IsSuperAdmin { get; set; }}
}

数据库上下文（DbContext）

数据库上下文是Entity Framework Core的核心组件，用于定义数据库中的所有实体集合，并配置实体之间的关系。以下是dbContext.cs文件中的部分代码，展示了部分实体集合的定义：

public class dbContext : DbContext
{private IMediator? mediator;public static string ConnectionString { get; set; }public dbContext(DbContextOptions<dbContext> _ = default, IMediator? mediator = default) : base(GetDbContextOptions());public DbSet<TPermission> TPermission { get; set; }public DbSet<TRolePermission> TRolePermission { get; set; }public DbSet<TAlipayKey> TAlipayKey { get; set; }// ... 更多实体集合定义public DbSet<TUser> TUser { get; set; }public DbSet<TUserBindAlipay> TUserBindAlipay { get; set; }public DbSet<TUserBindWeixin> TUserBindWeixin { get; set; }public DbSet<TUserInfo> TUserInfo { get; set; }
}

仓储（Repositories）

仓储模式在项目中用于抽象数据访问逻辑，提供统一的接口来进行数据库操作。每个实体通常对应一个仓储接口和实现，例如IUserRp和UserRp.cs。

实现模式

NetCoreKevin项目在数据层采用了以下关键实现模式：

仓储模式（Repository Pattern）：通过仓储接口和实现，将数据访问逻辑与业务逻辑分离，提高代码的可维护性和可测试性。
单元工作模式（Unit of Work）：通过数据库上下文管理多个仓储的事务操作，确保数据一致性。
代码优先（Code First）：使用Entity Framework Core的代码优先方法，通过实体类和配置定义数据库结构，并通过迁移文件管理数据库变更。