HZY.Framework.Core 10.1.16

HZY.Framework

模块化 .NET 10 插件框架：AOP、依赖注入、EF Core 仓储、动态 API 控制器、定时任务、Redis、服务器监控。

• 源码与完整文档：https://gitee.com/hzy6/HZY.Framework
• 完整实战案例（HzyAdmin 后台管理系统）：https://gitee.com/hzy6/HzyAdmin

包清单

快速开始

// 1. 定义启动模块（可组合多个模块，按 Order 排序执行）
[ImportStartupModule(typeof(RepositoryStartupModule))]
public class AppStartup : StartupModule<AppStartup>
{
    public override void ConfigureServices(WebApplicationBuilder builder)
    {
        // 动态 API 控制器：实现 IDynamicApiController 的服务自动注册为控制器
        builder.Services.AddControllers().AddDynamicApiController();

        // 扫描 [Component] 特性自动注册服务
        builder.Services.AddDependencyInjectionByComponent([typeof(Program).Assembly]);
    }
}

// 2. Program.cs —— 一行启动
var builder = WebApplication.CreateSlimBuilder(args);
HzyApplication.Run<AppStartup>(builder);

功能速查（AI 友好索引）

依赖注入

[Component]                                              // 默认 Transient
[Component(ServiceLifetime.Scoped)]                      // 指定生命周期
[Component(typeof(IUserService), ServiceLifetime.Singleton)] // 指定接口注册
public class UserService : IUserService { }

public class OrderService
{
    [Autowired]                                          // 属性注入（AOP 拦截 get）
    public IUserService UserService { get; set; } = null!;
}

注册入口：services.AddDependencyInjectionByComponent([typeof(Program).Assembly])

AOP 拦截器

自定义拦截器继承 AopMoAttribute（基于 Rougamo.Fody 编译期织入，零运行时代理）：

public class LogAttribute : AopMoAttribute
{
    public override void OnEntry(MethodContext context) { /* 方法进入 */ }
    public override void OnSuccess(MethodContext context) { /* 方法成功 */ }
    public override void OnException(MethodContext context) { /* 方法异常 */ }
    public override void OnExit(MethodContext context) { /* 方法退出（重写时必须调 base） */ }
}

// 内置拦截器
[Time]                                                   // 记录方法耗时日志
[MemoryCache(CacheKey = "user:{id}", CacheDuration = 60)] // 内存缓存（秒，0=永久）

EF Core 仓储

// 注册（MySql 为例，其他数据库换对应 Provider 包）
builder.AddRepository<AppDbContext>(new RepositoryOptions
{
    DefaultDatabaseType = DefaultDatabaseType.MySql,
    ConnectionString = builder.Configuration.GetConnectionString("Default")!
});

// 使用：任意服务构造函数注入 IRepository<T>
public class MemberService(IRepository<Member> memberRepository)
{
    // 查询（软删除自动过滤）
    var page = await memberRepository.Queryable
        .WhereIf(!string.IsNullOrWhiteSpace(keyword), w => w.Name.Contains(keyword))
        .ToPageAsync(1, 20);

    // 增删改（雪花 ID、审计字段自动填充，[Transactional] 事务保护）
    await memberRepository.InsertAsync(entity);
    await memberRepository.UpdateAsync(entity);
    await memberRepository.DeleteByIdAsync(id);          // 软删除：改写为 UPDATE
}

实体特性（标记在属性上即生效，无需配置）：

方法级特性：

[Transactional]                                          // 事务（支持嵌套复用、多 DbContext）
[Transactional(typeof(AppDbContext), typeof(OtherDbContext))] // 多库事务
public async Task CreateOrderAsync(Order order) { ... }

动态 API 控制器

// 实现该接口（或标记 [DynamicApiController]）→ 自动注册为控制器
// 路由 kebab-case，方法名前缀推断 HTTP 方法（Get*/Query*→GET，Add*/Create*→POST，...）
public class MemberAppService : IDynamicApiController
{
    public async Task<List<MemberDto>> GetListAsync(string? keyword) { ... }
    // → GET /member/list?keyword=xxx  （具体规则可配）
}

定时任务

[Component]
public class JobService
{
    [Scheduled("0/5 * * * * ?")]                          // 每 5 秒（Quartz Cron）
    public void SyncData() { ... }
}

全局服务网关

App.Services                  // IServiceCollection
App.ServiceProvider           // IServiceProvider（根容器）
App.HttpContext               // 当前 HttpContext
App.CreateScope()             // 创建服务作用域
App.GetJobTaskInfoList()      // 定时任务信息

更多文档

完整功能说明、数据库 Provider 配置、读写分离、分表、并发控制、服务器监控等，见仓库 README： https://gitee.com/hzy6/HZY.Framework