带控制器的OpenApi/Swagger前缀函数？

Question

目前，我正在使用一个使用开放Api规范的api，该规范是使用斯瓦格生成的。在 API 中有多个终结点，例如 /客户/获取字节 Id 和 /许可证/获取字节 Id。这会导致代码生成生成一个客户端，该客户端仅使用数字列出方法。

最好有一个名为“许可证代代辅助（...）”和“客户代代辅助同步”（...）的方法。（或任何区别他们的东西）

(如何)使用我的nswag配置实现这一点？我也可以改变OpenApi json的生成

我的 nswag 文件如下所示：

{
   "runtime": "Default",
   "defaultVariables": null,
   "documentGenerator": {
      "fromDocument": {
      "json": "$(InputSwagger)",
      "url": "http://redocly.github.io/redoc/openapi.yaml",
      "output": null
      }
   },
   "codeGenerators": {
      "openApiToCSharpClient": {
      "clientBaseClass": null,
      "configurationClass": null,
      "generateClientClasses": true,
      "generateClientInterfaces": true,
      "injectHttpClient": true,
      "disposeHttpClient": false,
      "protectedMethods": [],
      "generateExceptionClasses": true,
      "exceptionClass": "$(ClientName)Exception",
      "wrapDtoExceptions": true,
      "useHttpClientCreationMethod": false,
      "httpClientType": "System.Net.Http.HttpClient",
      "useHttpRequestMessageCreationMethod": false,
      "useBaseUrl": false,
      "generateBaseUrlProperty": true,
      "generateSyncMethods": false,
      "exposeJsonSerializerSettings": true,
      "clientClassAccessModifier": "public",
      "typeAccessModifier": "public",
      "generateContractsOutput": false,
      "contractsNamespace": null,
      "contractsOutputFilePath": null,
      "parameterDateTimeFormat": "s",
      "generateUpdateJsonSerializerSettingsMethod": true,
      "serializeTypeInformation": false,
      "queryNullValue": "",
      "className": "$(ClientName)Client",
      "operationGenerationMode": "MultipleClientsFromOperationId",
      "additionalNamespaceUsages": [],
      "additionalContractNamespaceUsages": [],
      "generateOptionalParameters": false,
      "generateJsonMethods": true,
      "enforceFlagEnums": false,
      "parameterArrayType": "System.Collections.Generic.IEnumerable",
      "parameterDictionaryType": "System.Collections.Generic.IDictionary",
      "responseArrayType": "System.Collections.Generic.ICollection",
      "responseDictionaryType": "System.Collections.Generic.IDictionary",
      "wrapResponses": false,
      "wrapResponseMethods": [],
      "generateResponseClasses": true,
      "responseClass": "$(ClientName)Response",
      "namespace": "$(ClientNamespace)",
      "requiredPropertiesMustBeDefined": false,
      "dateType": "System.DateTimeOffset",
      "jsonConverters": null,
      "anyType": "object",
      "dateTimeType": "System.DateTimeOffset",
      "timeType": "System.TimeSpan",
      "timeSpanType": "System.TimeSpan",
      "arrayType": "System.Collections.Generic.ICollection",
      "arrayInstanceType": "System.Collections.ObjectModel.Collection",
      "dictionaryType": "System.Collections.Generic.IDictionary",
      "dictionaryInstanceType": "System.Collections.Generic.Dictionary",
      "arrayBaseType": "System.Collections.ObjectModel.Collection",
      "dictionaryBaseType": "System.Collections.Generic.Dictionary",
      "classStyle": "Poco",
      "generateDefaultValues": true,
      "generateDataAnnotations": true,
      "excludedTypeNames": [],
      "excludedParameterNames": [],
      "handleReferences": false,
      "generateImmutableArrayProperties": false,
      "generateImmutableDictionaryProperties": false,
      "jsonSerializerSettingsTransformationMethod": null,
      "inlineNamedArrays": false,
      "inlineNamedDictionaries": false,
      "inlineNamedTuples": true,
      "inlineNamedAny": false,
      "generateDtoTypes": true,
      "templateDirectory": null,
      "typeNameGeneratorType": null,
      "propertyNameGeneratorType": null,
      "enumNameGeneratorType": null,
      "serviceHost": null,
      "serviceSchemes": null,
      "output": "$(GeneratedSwaggerClientFile)"
      }
   }
}

我的swagger文件看起来像这样

{
   "openapi": "3.0.1",
   "info": {
      "title": "ConfigurationManagement.Api",
      "version": "v1"
   },
   "paths": {
      "/api/customer/getbyid/{id}": {
         "get": {
            "tags": [
               "Customer"
            ],
            "summary": "Gets an Customer by the id",
            "parameters": [
               {
                  "name": "id",
                  "in": "path",
                  "description": "The id of the customer.",
                  "required": true,
                  "schema": {
                     "type": "string",
                     "format": "uuid"
                  }
               }
            ],
            "responses": {
               "200": {
                  "description": "Success",
                  "content": {
                     "application/json": {
                        "schema": {
                           "$ref": "#/components/schemas/CustomerDtoSingleItemResultDto"
                        }
                     }
                  }
               }
            }
         }
      },
...
      "/api/license/getbyid/{id}": {
         "get": {
            "tags": [
               "License"
            ],
            "summary": "Gets an License by the id",
            "parameters": [
               {
                  "name": "id",
                  "in": "path",
                  "description": "The id of the license.",
                  "required": true,
                  "schema": {
                     "type": "string",
                     "format": "uuid"
                  }
               }
            ],
            "responses": {
               "200": {
                  "description": "Success",
                  "content": {
                     "application/json": {
                        "schema": {
                           "$ref": "#/components/schemas/LicenseDtoSingleItemResultDto"
                        }
                     }
                  }
               }
            }
         }
      },
...
   }
}

Answer 1

我分两步解决了这个问题:

< li >我在生成swagger文件的api中添加了一个IOperationFilter

   public class OperationControllerPrefixFilter : IOperationFilter
   {
      public void Apply(OpenApiOperation operation, OperationFilterContext context)
      {
         // for example: api/customer/list will become [] {'customer', 'list'}
         var arr = context.ApiDescription.RelativePath
            .Split('/')
            .Skip(1)
            .Take(2)
            .ToArray();

         // becomes customer_list
         operation.OperationId = $"{arr[0]}_{arr[1]}";
         Debug.WriteLine(operation.OperationId);
      }
   }