从 Net Core 的 IApplicationModelProvider 上下文中查找 API 路由属性？

Question

我写了一个 API。 尝试自动注册 NSwagger 文档。

如何将路线导出到另一个变量中？ [动作]/{id} ? 对于下面的一个，它的 HttpGet。 并包含“动作/ID”等，

需要通过 IApplicationModelProvider 来完成，类似地通过控制器模型和动作模型这种循环。

*通过了解上面的动词和路由，我们可以注册适当的状态码。 示例：所有 API 需要 200 和 500，仅获取/识别 API 需要 404，Put API 需要 400，等等，

Net Core API：使 ProducesResponseType 全局参数或自动化

    [HttpGet("[Action]/{id}")]
    public async Task<ActionResult<GetDepartmentResponse>> GetByDepartment(int id)
    {
        try
        {
            var department = await departmentAppService.GetDepartmentById(id);
            var response = new GetDepartmentResponse { Body = department };
            return Ok(response);
        }

需要通过阅读下面的类似循环来了解，

public void OnProvidersExecuting(ApplicationModelProviderContext context)
{
    foreach (ControllerModel controller in context.Result.Controllers)
    {
        foreach (ActionModel action in controller.Actions)
        {
            try
            {
                if (action.ActionMethod.ReturnType.GenericTypeArguments[0].GetGenericArguments().Any())
                {

                    Type returnType = action.ActionMethod.ReturnType.GenericTypeArguments[0].GetGenericArguments()[0];
                    var methodVerbs = action.Attributes.OfType<HttpMethodAttribute>().SelectMany(x => x.HttpMethods).Distinct();

                    action.Filters.Add(new ProducesResponseTypeAttribute(returnType, StatusCodes.Status200OK));
                    action.Filters.Add(new ProducesResponseTypeAttribute(returnType, StatusCodes.Status500InternalServerError));
                }

                if (methodVerbs.Contains("GET")) // and contains Route/Id
                {
                    action.Filters.Add(new ProducesResponseTypeAttribute(returnType, StatusCodes.Status404NotFound));
                }
                if (methodVerbs.Contains("PUT"))
                {
                    action.Filters.Add(new ProducesResponseTypeAttribute(returnType, StatusCodes.Status404NotFound));
                }
                if (methodVerbs.Contains("POST"))
                {
                    action.Filters.Add(new ProducesResponseTypeAttribute(returnType, StatusCodes.Status201Created));
                    action.Filters.Add(new ProducesResponseTypeAttribute(returnType, StatusCodes.Status400BadRequest));
                    action.Filters.Add(new ProducesResponseTypeAttribute(returnType, StatusCodes.Status404NotFound));
                }
            }
            catch { }
        }
    }
}

Answer 1

好消息是 Swagger 将自动生成您需要的一切:)

您所要做的就是在 Startup.cs 中添加几行：

1. 将 NuGet 包 Swashbuckle.AspNetCore 添加到您的 REST 项目。

    dotnet add package Swashbuckle.AspNetCore

2. 在 Startup.cs 中注册 Swashbuckle

    public void ConfigureServices(IServiceCollection services) { services.AddSwaggerGen(c => { c.SwaggerDoc("v1", new Info { Title = "My API", Version = "v1" }); }); services.AddMvc(); ... public void Configure(IApplicationBuilder app, IHostingEnvironment env) { app.UseMvc(); app.UseStaticFiles(); // Enable middleware to serve swagger-ui (HTML, JS, CSS, etc.), specifying the Swagger JSON endpoint. app.UseSwagger(); app.UseSwaggerUI(c => { c.SwaggerEndpoint("/swagger/v1/swagger.json", "My API V1"); });

3. 启动您的应用程序，浏览到http://localhost:<port>/swagger ，并享受您的新 UI：

注意：上述语法在 .Net Core 2.x 中有效。 对于 .Net Core 3.0，它略有变化：

新语法（.Net Core 3.x）

1. Nuget > Install Swashbuckle.AspNetCore v5.0.0-rc4

<= NOTE: You must check `Include prerelease= Y` in order to see this version

2. 在 Startup.cs > ConfigureServices() 中，用Microsoft.OpenApi.Models.OpenApiInfo替换Swagger.Info 。

例子：

  services.AddSwaggerGen(c => {
     c.SwaggerDoc("v1", 
        new Microsoft.OpenApi.Models.OpenApiInfo {
           Title = "Contacts App", Version = "v1" 
     });
  });

Answer 2

你可以去action.Attributes.OfType<HttpMethodAttribute>(). 然后在模板中，您会注意到路由值。 在 Visual Studio 调试窗口中查看下图。