本文主要是介绍为控制器的方法添加必要参数,希望对大家解决编程问题提供一定的参考价值,需要的开发者们随着小编来一起学习吧!
前言:做这个系统时,要求每次调用接口时要传操作人、操作人电脑ip、菜单id,然后计入log。本来前端读取到然后加入请求头,后端写入log即可。但是老大要求后端也要把控必传参数,避免前端忘记。所以就写了这个。IOperationFilter 这个是百度知道的。主要用于在Swagger生成的API文档中动态地添加或修改操作(即API接口)的元数据。
用处:可以自动地为 Swagger/OpenAPI 文档中的非匿名 API 方法添加必要的头部参数描述。下面这个过滤器主要用于在 API 的描述中自动添加一些特定的头部参数,比如 operator
(操作人)、menu_id
(菜单ID)等,但仅对未标记为匿名访问的方法有效。
public class AddRequiredHeaderParameter : IOperationFilter {public void Apply(OpenApiOperation operation, OperationFilterContext context){// 确保有一个参数列表 operation.Parameters ??= new List<OpenApiParameter>();// 获取当前操作的描述符 var controllerActionDescriptor = context.ApiDescription.ActionDescriptor as ControllerActionDescriptor;if (controllerActionDescriptor == null){// 如果不是控制器动作描述符,则不添加参数 return;}// 检查是否有AllowAnonymous属性(是否允许匿名访问) bool isAnonymous = controllerActionDescriptor.MethodInfo.GetCustomAttributes(inherit: true).OfType<AllowAnonymousAttribute>().Any();// 如果不是匿名访问,则添加头部参数 if (!isAnonymous){//操作人operation.Parameters.Add(new OpenApiParameter{Name = "operator",In = ParameterLocation.Header,Description = "操作人",Required = true}); //菜单IDoperation.Parameters.Add(new OpenApiParameter{Name = "menu_id",In = ParameterLocation.Header,Description = "菜单ID",Required = true});}}}
还需要在program.cs中
builder.Services.AddSwaggerGen(options =>
{options.OperationFilter<AddRequiredHeaderParameter>();
});
这篇关于为控制器的方法添加必要参数的文章就介绍到这儿,希望我们推荐的文章对编程师们有所帮助!