动态WebAPI实现全攻略

在.NET中实现动态Web API可通过以下步骤完成：

一、基本实现原理

1. 动态路由注册：利用ASP.NET Core的Endpoint路由系统
2. 反射机制：动态发现服务方法
3. 委托工厂：将方法调用转换为请求处理委托

二、具体实现方案

1. 定义服务接口

public interface IDynamicService
{
    string GetMessage(string name);
    int Calculate(int a, int b);
}

2. 实现动态路由注册

app.UseEndpoints(endpoints =>
{
    var serviceType = typeof(IDynamicService);
    
    foreach (var method in serviceType.GetMethods())
    {
        endpoints.MapPost($"/api/{method.Name}", async context =>
        {
            var service = context.RequestServices.GetService(serviceType);
            var parameters = await ParseParameters(context, method);
            var result = method.Invoke(service, parameters);
            await context.Response.WriteAsJsonAsync(result);
        });
    }
});

3. 参数解析方法

private static async Task<object[]> ParseParameters(HttpContext context, MethodInfo method)
{
    var parameters = new List<object>();
    var json = await context.Request.ReadFromJsonAsync<JsonElement>();
    
    foreach (var param in method.GetParameters())
    {
        if (json.TryGetProperty(param.Name!, out var value))
        {
            parameters.Add(value.Deserialize(param.ParameterType));
        }
    }
    
    return parameters.ToArray();
}

三、高级功能扩展

1. 支持多种HTTP方法

var httpMethod = method.GetCustomAttribute<HttpMethodAttribute>()?.Method ?? "POST";
endpoints.MapMethods($"/api/{method.Name}", new[] { httpMethod }, ...);

2. 添加Swagger支持

services.AddSwaggerGen(c =>
{
    c.SwaggerDoc("v1", new OpenApiInfo { Title = "Dynamic API", Version = "v1" });
    
    c.DocumentFilter<DynamicApiDocumentFilter>();
});

四、性能优化建议

1. 缓存反射结果：对MethodInfo和参数信息进行缓存
2. 预编译表达式树：使用Expression代替直接反射调用
3. 使用Source Generators：在编译时生成API端点代码

五、注意事项

1. 安全验证：建议添加统一的权限验证中间件
2. 异常处理：统一处理参数解析和方法调用异常
3. 版本控制：建议在路由路径中加入版本标识

示例调用：

POST /api/Calculate
Content-Type: application/json

{
    "a": 5,
    "b": 3
}

响应：

8

此方案通过动态注册路由和反射调用实现了基本API功能，实际生产环境中建议结合具体需求添加日志记录、性能监控等基础功能。