使用 NSwag 和 AutoREST 创建一个代码客户端/扁平化控制器

Question

我正在尝试使用 NSwag 和 Autorest 为 api 创建代码包装器。

以前我使用 Swashbuckle 来生成 swagger 文件。它生成了格式为 operationIds 的 swagger 文件actionMethod。这导致 Autorest 生成一个深度为 1 的代码客户端。所有的动作都在顶级班级。

由于各种原因，我需要将 swagger 生成更改为 NSwag。这将生成格式为 operationIds controller_actionMethod。这导致 AutoRest 创建一个复合类，该类公开带有每个控制器操作的单独类。

怎么可能

• 更改 NSwag 生成 operationId 的方式
• 更改 Autorest 映射 operationIds 的方式

注意：我知道我可以手动更改 swagger.json，但我希望保持一致的自动化流程来生成代码客户端。

Answer 1

似乎没有任何现成的设置，但您可以挂钩到 NSwag 的生成过程

https://github.com/RicoSuter/NSwag/wiki/Document-Processors-and-Operation-Processors#operation-processors

运算处理器

class FlattenOperationsProcessor: IOperationProcessor
{
    public async Task<bool> ProcessAsync(OperationProcessorContext context)
    {
        context.OperationDescription.Operation.OperationId = $"{context.MethodInfo.Name}";
        return true;
    }
}

然后在Startup.cs中添加

document.OperationProcessors.Add(new FlattenOperationsProcessor());