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

Question

I am using NSwag to generate swagger for my .NET Core api and everything works great, except the fact that paths are rendered in order that reflection seems to pickup Controllers from project.

So if I do have hierarchy - some controllers at root level ( Controllers folder) and some in subfolder ( Controllers\\Subfolder folder) then the order gets messed up.

Is it possible to somehow tell NSwag to generate resulting swagger.json showing operations in alphabetical order?

Answer 1

There is option within UI configuration. All you need is utilize OperationsSorter and TagsSorter , within your Startup.Configure method like:

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