cody
cody
提供了 swaggerOptions, 可以在里面定义 model 示例如下 ``` router.swagger({ title: 'APP-SERVER', description: 'API DOC', version: '1.0.0', swaggerOptions: { definitions: { User: { properties: { id: { type: 'number' }, name: { type:...
对于自动实现 model 有啥好的想法么?我对这部分了解的不多。现在这个库对于 swagger 没有提供完全的支持,只是将日常开发常用到的功能做了包装。 根节点 tag 的功能现在也只能在 swaggerOptions 添加。因为根节点的 tag 本质是是对于 tag 的描述,应该是属于初始化 swagger doc 时的操作,感觉没必要自动生成。
可以通过一个单独的文件来维护 swaggerOptions 中的内容,因为本身是一个简单的 object,具体的实现的结构由你自己定义,这个库只是简单的把这些配置加到根节点上
$ref 实际上是 swagger 为了能使 model 复用提供的一个方法,但是对于 js 中的 object 天然是可以复用的,所以最初没有考虑加 $ref 的功能。 不过可以提供一个加载 model 的方法,对 model 的格式做一个 wrapper,与参数中的 schema 保持结构一致 ```javascript //model.js export const UserSchema = { id: {type: 'string',...
下个版本会考虑使用 Joi 做更完善的 schema 的校验
Im sorry, this authorizations feature is not supported yet. We will implement this featrue in the next major version.
how do you run the script?
you may need ts-node to run the script, or you need to exec `tsc` to compile your ts code first
没用过 operationId 这个功能,对此不是很了解。如果有相关的需求可以在这里讨论或提交 PR
好的,感谢~