Swagger JSDoc 不从子文件夹加载 API 文件

Question

我正在为 node.js 和 express 框架中的一个项目集成 swagger 文档，

NPM: Swagger JSDoc - ^4.0.0 NPM

文件夹结构如下：（注意：module-1、module-2、module-3是文件夹！）

 - app 

   - module-1 
      - module-1.controller.js
      - module-1.model.js
      - module-1.route.js
   - module-2 
      - module-2.controller.js
      - module-2.model.js
      - module-2.route.js
   - module-3 
      - module-3.controller.js
      - module-3.model.js
      - module-3.route.js

工作示例：

swaggerJSDoc({
    swaggerDefinition: {
        ...require('../swagger.json')
    },
    apis: [
        './app/module-1/*',
        './app/module-2/*'
        './app/module-3/*'
    ]
})

节点： 我不想像上面的例子那样每次创建新模块时都添加模块路径。

我期待的是下面的例子：我想像设置主folder/file路径一样设置一次，它将加载API文档数据自动从提供的主要 folder/file 路径。

我尝试了以下示例，但它 不适用于 /app/*:

swaggerJSDoc({
    swaggerDefinition: {
        ...require('../swagger.json')
    },
    apis: [
        './app/*'
    ]
})

请指导是否有任何方法可以做到这一点，任何类型的建议将不胜感激，谢谢。

Answer 1

应该可行

apis: ['./app/**/*.js'],

Swagger JSDoc 不从子文件夹加载 API 文件

Swagger JSDoc does not loading API files from sub folders

node.js

express

swagger

swagger-jsdocs