当尝试使用Azure Autorest生成c#代码时:
https://github.com/blend/blend-api-specs/blob/master/version_4/v4.2.0_stable.openapi_spec.yaml
我得到以下错误:
warning | Interpretations | Generating 'operationId' to 'Home Lending - Applications' for 'get' operation on path '/home-lending/applications/{id}/assignees'
warning | Interpretations | Generating 'operationId' to 'Home Lending - Applications' for 'patch' operation on path '/home-lending/applications/{id}/assignees'
warning | Interpretations | Generating 'operationId' to 'Home Lending - Applications' for 'put' operation on path '/home-lending/applications/{id}/assignees'
warning | Modeler/MissingType | The schema 'paths·bz6x3r·home_lending-applications-id·patch·requestbody·content·application-json·schema·properties·loanamount·allof·1' has no type or format information whatsoever. Location:
file:///home/XX/code/XX-platform/poc/integrations/providers/Blend.autorest/spec/v4.2.0stable.openapi_spec.yaml#/components/schemas/paths·bz6x3r·homelending-applications-id·patch·requestbody·content·application-json·schema·properties·loanamount·allof·1
error | DuplicateOperation | Duplicate Operation '' > 'HomeLendingApplications' detected(This is most likely due to 2 operation using the same 'operationId' or 'tags'). Duplicates have those paths:
- /home-lending/applications/{id}/assignees
- /home-lending/applications/{id}/assignees
- /home-lending/applications/{id}/assignees
fatal | Error: 1 errors occured -- cannot continue.
fatal | Process() cancelled due to failure
Error: Plugin checker reported failure.
由于我不能修改YAML文件(它是一个公共API)，是否有一种方法来避免生成或忽略违规部分?也许使用指令?
在Autorest github问题板上询问后，我被建议使用指令，允许在飞行中预处理规范。
directive:
- from: openapi-document
where: '$.paths["/home-lending/applications/{id}/assignees"].get'
debug: true
transform: |
$["operationId"] = "lending-assignees-get";
- from: openapi-document
where: '$.paths["/home-lending/applications/{id}/assignees"].put'
debug: true
transform: |
$["operationId"] = "lending-assignees-put";
这个特定的规范仍然包含其他导致autorest c#生成器失败的问题，但是这些指令确实修复了最初的问题。