基于 EF Core 的 Code First 模式 .NET 快速开发框架

NuGet [最新版本：7.0.0]

Zxw.Framework.NetCore

• Install-Package Zxw.Framework.NetCore -Version 7.0.0
• dotnet add package Zxw.Framework.NetCore --version 7.0.0

Zxw.Framework.AI（可选）

• Install-Package Zxw.Framework.AI -Version 1.0.0
• dotnet add package Zxw.Framework.AI --version 1.0.0
• 内置 LLM 网关选项：OrcaRouter（OpenAI 兼容，默认 orcarouter/auto）

开发环境

• Visual Studio 2022 / VS Code / Cursor
• .NET SDK 8 / 9 / 10

目标框架

• net8.0 / net9.0 / net10.0（已移除 net6 / net7）

支持的数据库

• SQL Server
• MySQL（net8/net9：Pomelo；net10：MySql.EntityFrameworkCore，待 Pomelo 正式支持 EF10 后切回）
• Sqlite
• InMemory
• PostgreSQL
• Oracle
• MongoDB（已移除）

日志组件

• log4net（建议业务侧优先使用 ILogger<T>）

DI 组件

• Microsoft.Extensions.DependencyInjection（默认）
• Autofac（可选）
• AspectCore（可选 AOP）

AOP 缓存组件使用

本项目可采用 AOP 中间件：AspectCore.Extensions.Cache

• Zxw.Framework.NetCore.Demo

• Zxw.Framework.Nfx

• 请参考我的博客：http://www.cnblogs.com/zengxw/p/7673952.html

2026/08/19 — 7.0.0（破坏性升级）

Breaking

• 1. 目标框架改为 net8.0 / net9.0 / net10.0，移除对 net6.0 / net7.0 的支持
• 2. IRepository / IService / IWebContext 生命周期改为 Scoped（不再使用 Transient / Singleton 承载请求态依赖）
• 3. ASP.NET Core 改为 FrameworkReference，移除 Microsoft.AspNetCore.* 2.2 兼容包
• 4. 淘汰 Jil，JsonConvertor 统一为 System.Text.Json（原 Jil.Options 参数改为 JsonSerializerOptions；已移除 DeserializeDynamic）

数据访问 / 工作单元

• 5. 新增 IUnitOfWork / EfUnitOfWork；DbContextOption.AutoSaveChanges（默认 true 兼容旧行为，设为 false 后需显式提交以支持跨仓储事务）
• 6. 仓储构造函数不再调用 EnsureCreated()；生产环境请使用迁移
• 7. 仓储 Dispose 不再释放共享 DbContext（由 DI 作用域管理）
• 8. 修复 EditRange 未标记 Modified；分页 GetByPagination 多字段排序改为 OrderBy + ThenBy
• 9. 修复假异步（如 ExistAsync）；异步 API 补充 CancellationToken
• 10. SQL Server / MySQL BulkInsert 改为同步等待完成，避免未 await 导致数据不确定

安全 / Web

• 11. 新增 SqlIdentifier，校验分页 ORDER BY、视图名、表名等动态 SQL 标识符
• 12. WebContext 改为 Scoped，每次从 IHttpContextAccessor 读取当前 HttpContext
• 13. GlobalExceptionFilter 返回 ProblemDetails（500），不再静默吞掉异常
• 14. 修正 RegisterControllers 中 IsAssignableFrom 判断写反的问题

依赖

• 15. 按 TFM 对齐 EF Core / Npgsql / Oracle / Z.EntityFramework.Plus 主版本
• 16. net10 MySQL 暂用 MySql.EntityFrameworkCore（Pomelo 10 未发布）；BulkInsert 在 net10 退化为 AddRange
• 17. 移除重复的 DotNetCore.NPOI 引用与停更的 Jil / StackExchange.Redis.Extensions.JilCore

测试

• 18. 补充 SqlIdentifier、IUnitOfWork / AutoSaveChanges、分页 ThenBy、WebContext 作用域等单元测试（net8/9/10）

可选 AI

• 19. 新增独立包 Zxw.Framework.AI：内置 OrcaRouter 作为一等 LLM Provider（AddOrcaRouter / IChatClient，含非流式与 SSE）；主包不引用，按需安装

迁移提示

// 跨仓储事务：关闭自动提交
var option = new DbContextOption
{
    ConnectionString = "...",
    AutoSaveChanges = false
};
// ...
await repoA.AddAsync(a);
await repoB.AddAsync(b);
await uow.SaveChangesAsync(); // IUnitOfWork

后续规划（包拆分）

• 计划拆为可选包：Abstractions / EFCore（及各数据库 Provider）/ Caching / AspNetCore / CodeGenerator，并保留 Zxw.Framework.NetCore 元包兼容旧引用方式
• 已先行提供可选包 Zxw.Framework.AI：内置 OrcaRouter 作为一等 LLM Provider（不进入主包，按需引用）

本框架将 OrcaRouter 注册为内置 LLM provider（见 providers/orcarouter.json）。EF / DI 主包不绑定大模型；需要 Chat Completions 时引用 Zxw.Framework.AI，通过 AddOrcaRouter() 启用。

services.AddOrcaRouter(o =>
{
    o.ApiKey = Configuration["OrcaRouter:ApiKey"]; // 或 ORCAROUTER_API_KEY；申请 Key：https://www.orcarouter.ai/ref/ref_4efd338f7db91cf2aa1d
    o.DefaultModel = "orcarouter/auto";
    o.FallbackModels = new[] { "openai/gpt-4o-mini", "deepseek/deepseek-chat" };
});

// 注入使用
public class MyService(IChatClient chat)
{
    public async Task<string> AskAsync(string prompt)
    {
        var resp = await chat.CompleteAsync(new ChatCompletionRequest
        {
            Messages = { ChatMessage.User(prompt) }
        });
        return resp.GetContent();
    }
}

• Provider 清单：providers/orcarouter.json（id: orcarouter）
• 环境变量示例：.env.example
• Base URL 默认：https://api.orcarouter.ai/v1
• 协议：OpenAI 兼容 /chat/completions（含 SSE 流式）
• 文档：docs.orcarouter.ai

2022/11/20

• 1.兼容.net7.0，
• 2.移除对MongoDB的支持
• 3.HttpRequestHelper标识为已过时，请用HttpClient

2019/12/17

• 1. 添加框架同一入口扩展方法 AddCoreX

services.AddCoreX(config=> { })

• 2. AddCoreX方法里面默认开启注入实现了ISingletonDependency、IScopedDependency、ITransientDependency三种不同生命周期的类，以及AddHttpContextAccessor和AddDataProtection。如需要自动注入，只需要按需实现ISingletonDependency、IScopedDependency、ITransientDependency这三种生命周期接口即可。
• 3. 添加会话上下文 WebContext
• 4. 升级 AspectCore 至 2.0.0
• 5. 示例 Zxw.Framework.NetCore.Demo 已同步更新。

2019/09/16

• 1.更换Oracle for efcore驱动，使用Oracle官方驱动

2019/09/15

• 1.重构AOP缓存，统一用CachedAttribute

2019/08/11

• 1.重构代码生成器，分CodeFirst和DbFirst

a.启用代码生成器

//启用代码生成器
services.UseCodeGenerator(new CodeGeneratorOption());

b.使用代码生成器

//CodeFirst---根据model生成其他各层的代码
dbContext.CodeFirst().GenerateAll(ifExsitedCovered:true);

//DbFirst---根据现有数据表生成各层代码
dbCOntext.DbFirst().GenerateAll(ifExsitedCovered:true);

• 2.添加对APIController的代码生成

2019/04/25

• 1.修改缓存拦截器默认key格式为：{namespace}{class}{method}{参数值hashcode}
• 2.缓存拦截器添加对Task<>类型的支持

2019/04/18

• 1.删除触发器功能...
• 2.实现多数据库上下文。用法：

    //注入数据库上下文
    services.AddDbContextFactory(factory =>
    {
        factory.AddDbContext<PostgreSQLDbContext>("db1", new DbContextOption(){ConnectionString = "User ID=postgres;Password=123456;Host=localhost;Port=5432;Database=ZxwPgDemo;Pooling=true;" });
        factory.AddDbContext<SqlServerDbContext>("db2", new DbContextOption() { ConnectionString = "" });
        factory.AddDbContext<MongoDbContext>("db3", new DbContextOption() { ConnectionString = "" });
    });


    //获取
    public class TestController
    {
        public IDbContextCore DbContext1 { get; set; }
        public IDbContextCore DbContext2 { get; set; }
        public IDbContextCore DbContext3 { get; set; }

        public TestController(DbContextFactory factory)
        {
            DbContext1 = factory.GetDbContext("db1");
            DbContext2 = factory.GetDbContext("db2");
            DbContext3 = factory.GetDbContext("db3");
        }

        public void Run()
        {
            var db = DbContext1.GetDatabase();
            Console.WriteLine();
        }
    }

• 3.多数据库上下文支持属性注入,用法如下：（具体请参考单元测试）

public class TestRepository: BaseRepository<MongoModel, ObjectId>, IMongoRepository
    {
        [FromDbContextFactory("db1")]
        public IDbContextCore DbContext1 { get; set; }
        [FromDbContextFactory("db2")]
        public IDbContextCore DbContext2 { get; set; }
        [FromDbContextFactory("db3")]
        public IDbContextCore DbContext3 { get; set; }



        public void Run()
        {
            Console.WriteLine("Over!");
        }

        public TestRepository(IDbContextCore dbContext) : base(dbContext)
        {
        }
    }

2018/09/24

• 1.实现Oracle for EfCore，引用第三方驱动Citms.EntityFrameworkCore.Oracle
• 2.实现MongoDB for EfCore，引用第三方驱动Blueshift.EntityFrameworkCore.MongoDB

2018/08/26

• 1.添加自定义视图分页查询，数据库分页，目前只支持sqlserver
• 2.update packages

2018/07/06 合并dev分支到master

• 1.添加EFCore直接返回DataTable功能
• 2.DBFirst功能，目前仅支持SQL Server、MySQL、NpgSQL三种数据库。根据已存在的数据表直接生成实体代码，详见CodeGenerator
• 3.添加单元测试项目，并完成对以上两点新功能的测试
• 4.引入IOC容器Aspectcore.Injector，详见AspectCoreContainer.cs

• 本开源项目遵守MIT开源协议，请保留原作者出处。