Web API 从dynamic参数解析泛型T 搭建单一审计调用端点
单一API端点实现方案
问题根因
之前的实现卡在两个核心点:
- Web API的默认模型绑定器无法对
ApiRequest<dynamic>结构做正确反序列化,嵌套的MyModel会被解析为弱类型的JObject/JsonElement,而不是目标强类型实例 - 泛型方法
DoAudit<T>(T model)的T参数是编译期确定的,运行时拿到动态类型后无法直接匹配泛型签名,必须通过反射调用
具体实现步骤
1. 调整通用请求模型,规避模型绑定异常
无需为每种ViewModel单独创建请求类,直接定义包含原始序列化结构的通用请求类即可:
// 保留原有的公共字段基类 public class ApiRequest : IApiRequest { public string Token { get; set; } public string AppCode { get; set; } // 新增字段:携带目标模型的程序集限定名,用于运行时类型解析 public string ModelAssemblyQualifiedName { get; set; } } // 通用审计请求类,MyModel用弱类型结构接收,避免绑定失败 public class AuditApiRequest : ApiRequest { // Newtonsoft.Json环境用JObject,System.Text.Json环境用JsonElement public JObject MyModel { get; set; } }
注意:不要用
dynamic作为MyModel的属性类型,否则模型绑定阶段会因为无法确定目标类型抛出序列化异常。
2. API方法内部完成类型解析与泛型调用
替换之前的动态入参方法,直接通过反射完成强类型转换与泛型方法调用:
[HttpPost] public async Task DoAuditModel([FromBody] AuditApiRequest request) { // 校验并加载目标模型类型 if (string.IsNullOrWhiteSpace(request.ModelAssemblyQualifiedName)) throw new ArgumentException("缺少模型类型标识"); Type targetModelType = Type.GetType(request.ModelAssemblyQualifiedName) ?? throw new InvalidOperationException($"无法加载类型:{request.ModelAssemblyQualifiedName}"); // 把弱类型的MyModel反序列化为目标强类型实例 object modelInstance = request.MyModel.ToObject(targetModelType); // 反射获取DoAudit泛型方法,绑定实际类型后调用 MethodInfo doAuditMethod = typeof(MyAuditController) .GetMethod(nameof(DoAudit), BindingFlags.NonPublic | BindingFlags.Instance) .MakeGenericMethod(targetModelType); await (Task)doAuditMethod.Invoke(this, new[] { modelInstance }); } // 原有DoAudit泛型方法保持不变,不需要调整业务逻辑 private async Task DoAudit<T>(T myModel) { // 原有审计业务逻辑 }
性能优化方案
上述流程的额外开销完全可以通过缓存消除,不会造成明显性能损耗:
- 首次反射生成的泛型方法委托可以存入内存字典,后续同一类型的请求直接调用缓存委托,完全跳过反射查找逻辑
- 类型加载结果可以提前在应用启动时扫描业务程序集做全量缓存,避免每次请求都调用
Type.GetType()做字符串匹配
缓存实现示例:
// 静态缓存:key为目标模型类型,value为绑定后的泛型方法委托 private static readonly ConcurrentDictionary<Type, Delegate> DoAuditDelegateCache = new(); // 优化后的调用逻辑 if (!DoAuditDelegateCache.TryGetValue(targetModelType, out var invokeDelegate)) { var method = typeof(MyAuditController) .GetMethod(nameof(DoAudit), BindingFlags.NonPublic | BindingFlags.Instance) .MakeGenericMethod(targetModelType); // 生成强类型委托缓存 invokeDelegate = Delegate.CreateDelegate( typeof(Func<,>).MakeGenericType(targetModelType, typeof(Task)), this, method); DoAuditDelegateCache.TryAdd(targetModelType, invokeDelegate); } // 直接调用缓存的委托,无额外反射开销 await (Task)invokeDelegate.DynamicInvoke(modelInstance);
适配不同序列化组件的调整说明
- 如果项目使用System.Text.Json而非Newtonsoft.Json,只需要把
MyModel的类型从JObject换成JsonElement,反序列化逻辑替换为JsonSerializer.Deserialize(jsonElement, targetModelType)即可,整体流程完全不变 - 客户端调用时,需要严格按照约定传入与服务端完全一致的
ModelAssemblyQualifiedName字符串,避免出现类型不匹配
内容的提问来源于stack exchange,提问作者MKEF
相关产品推荐
相关产品推荐

