如何按控制器名称对 NSwag swagger.json 中的路径进行排序/排序

Question

我正在使用 NSwag 为我的 .NET Core api 生成 swagger 并且一切正常，除了渲染路径以便反射似乎从项目中拾取控制器这一事实。

因此，如果我确实有层次结构 - 一些控制器位于根级别（Controllers 文件夹），一些控制器位于子文件夹（Controllers\Subfolder 文件夹），那么顺序就会混乱。

是否有可能以某种方式告诉 NSwag 生成结果 swagger.json 按字母顺序显示操作？

Answer 1

UI 配置中有选项。您只需要在Startup.Configure 方法中使用OperationsSorter 和TagsSorter，例如：

app.UseSwaggerUi3(a => {
    a.OperationsSorter = "alpha";
    a.TagsSorter = "alpha";
});