我已经使用OpenAPI定义了一个API,并使用Swagger Codegen工具生成了一个简单的模拟节点服务器。效果很好,但我需要在/site/docs
而非/docs
上提供文档。
生成的代码如下:
'use strict';
var path = require('path');
var http = require('http');
var oas3Tools = require('oas3-tools');
var serverPort = 8080;
// swaggerRouter configuration
var options = {
controllers: path.join(__dirname, './controllers')
};
var expressAppConfig = oas3Tools.expressAppConfig(path.join(__dirname, 'api/openapi.yaml'), options);
expressAppConfig.addValidator();
var app = expressAppConfig.getApp();
// Initialize the Swagger middleware
http.createServer(app).listen(serverPort, function () {
console.log('Your server is listening on port %d (http://localhost:%d)', serverPort, serverPort);
console.log('Swagger-ui is available on http://localhost:%d/docs', serverPort);
});
看一下oas3-tools
项目的代码,看来我应该能够提供一个选项apiDocsPath
或一个选项swaggerUIPath
(或两者都提供),但实际上它们是做什么的不透明,并且将这些值设置为/site/docs
的任何一种方式都没有任何区别。
有没有办法做到这一点?