@dweber019/后台-plugin-api-docs-module-wsdl

前端为 @dweber019/backstage-plugin-api-docs-module-wsdl-backend 后端插件 .
您也需要安装后端插件 .

设置

yarn --cwd packages/app add @dweber019/backstage-plugin-api-docs-module-wsdl

将 wsdl DocsApiWidget 添加到您的 APis 中

将部件添加到您的 apiDocsConfigRef。 。 。 .

// packages/app/apis.ts

import {
  apiDocsModuleWsdlApiRef,
  ApiDocsModuleWsdlClient,
  wsdlApiWidget,
} from '@dweber019/backstage-plugin-api-docs-module-wsdl';

export const apis: AnyApiFactory[] = [
  createApiFactory({
    api: apiDocsModuleWsdlApiRef,
    deps: {
      identityApi: identityApiRef,
      discoveryApi: discoveryApiRef,
    },
    factory: ({ identityApi, discoveryApi }) =>
      new ApiDocsModuleWsdlClient({ identityApi, discoveryApi }),
  }),
  createApiFactory({
    api: apiDocsConfigRef,
    deps: {},
    factory: () => {
      const definitionWidgets = defaultDefinitionWidgets();
      return {
        getApiDefinitionWidget: (apiEntity: ApiEntity) => {
          if (apiEntity.spec.type.toLowerCase() === 'wsdl') {
            return wsdlApiWidget(apiEntity);
          }
          return definitionWidgets.find(d => d.type === apiEntity.spec.type);
        },
      };
    },
  }),
];

在您的 API 实体中设置类型

此部件将生成生成 wsdl 说明 xslt 转变.

apiVersion: backstage.io/v1alpha1
kind: API
metadata:
  name: hello-world
  description: Hello World example for WSDL
spec:
  type: wsdl
  lifecycle: deprecated
  owner: foo
  definition:
    $text: http://www.dneonline.com/calculator.asmx?wsdl

您可以在 ./dev。 。 。 .

地方发展

有本地设置 plugins/api-docs-module-wsdl/dev 可以从 yarn --cwd plugins/api-docs-module-wsdl start 从根起.

别忘了本地开发后端也.