T2FGame.CodeGen.Action 1.0.6

T2FGame.CodeGen.Action

T2FGame Action 模块的 Source Generator，在编译时生成 Action 调用器和注册表，消除运行时反射。

功能

• 零反射方法调用：编译时生成直接方法调用代码，替代 MethodInfo.Invoke()
• 编译时元数据注册：消除启动时的程序集扫描
• AOT 友好：生成的代码完全支持 Native AOT 编译
• 类型安全：编译时验证所有 Action 方法签名

性能对比

使用方法

1. 添加项目引用

在使用 Action 的项目中添加生成器引用：

<ItemGroup>
  <ProjectReference Include="..\T2FGame.Action\T2FGame.Action.csproj" />
  <ProjectReference Include="..\T2FGame.CodeGen.Action\T2FGame.CodeGen.Action.csproj"
                    OutputItemType="Analyzer"
                    ReferenceOutputAssembly="false" />
</ItemGroup>

2. 编写 Action 控制器

[ActionController(1, "用户模块")]
public class UserController
{
    [ActionMethod(1, description: "用户登录")]
    public async Task<LoginResponse> LoginAsync(LoginRequest request, FlowContext context)
    {
        // 业务逻辑
    }

    [ActionMethod(2, requireAuth: false, description: "用户注册")]
    public async ValueTask<RegisterResponse> RegisterAsync(RegisterRequest request, FlowContext context)
    {
        // 业务逻辑
    }
}

3. 使用生成的注册方法

// 旧方式（运行时反射）
services.AddT2FGameAction(typeof(UserController).Assembly);

// 新方式（编译时生成，零反射）
services.AddT2FGameActionGenerated();

生成的代码

编译后会自动生成以下文件：

ActionInvoker.g.cs

public sealed class GeneratedActionInvoker : IGeneratedActionInvoker
{
    public async ValueTask<byte[]?> InvokeAsync(
        int cmdMerge, object controller, object? request, FlowContext context)
    {
        return cmdMerge switch
        {
            // [1:1] UserController.LoginAsync
            0x00010001 => await HandleTaskOfTAsync<LoginResponse>(
                ((UserController)controller).LoginAsync((LoginRequest)request!, context)),

            // [1:2] UserController.RegisterAsync
            0x00010002 => await HandleValueTaskOfTAsync<RegisterResponse>(
                ((UserController)controller).RegisterAsync((RegisterRequest)request!, context)),

            _ => throw new InvalidOperationException($"未知命令: 0x{cmdMerge:X8}")
        };
    }
}

ActionRegistry.g.cs

public sealed class GeneratedActionRegistry
{
    private static readonly FrozenDictionary<int, ActionMethodInfo> _methods;

    static GeneratedActionRegistry()
    {
        var methods = new Dictionary<int, ActionMethodInfo>
        {
            [0x00010001] = new ActionMethodInfo { /* ... */ },
            [0x00010002] = new ActionMethodInfo { /* ... */ },
        };
        _methods = methods.ToFrozenDictionary();
    }
}

架构

编译时：
  用户代码 [ActionController] → ActionSourceGenerator → 生成 .g.cs 文件

运行时：
  请求 → Pipeline → GeneratedActionInvoker.InvokeAsync → 直接方法调用
                          ↓
                    switch (cmdMerge)
                    {
                        case 0x00010001:
                            return controller.LoginAsync(req, ctx);
                        ...
                    }

与现有代码兼容

生成的代码完全兼容现有的 ActionMethodRegistry 和 Pipeline 处理器：

• GeneratedActionRegistry 实现与 ActionMethodRegistry 相同的接口
• IGeneratedActionInvoker 可以注入到自定义 Handler 中使用
• AddT2FGameActionGenerated() 同时注册兼容的 ActionMethodRegistry

许可证

MIT License