1.0.0-beta.41 • Published 2 years ago
@pagoda-tools/swagger-ui v1.0.0-beta.41
@pagoda-tools/swagger-ui
安装
# install npm
npm install @pagoda-tools/swagger-ui -S
# install yarn
yarn add @pagoda-tools/swagger-ui -S
文档编写示例
- 根目录新增配置文件
swagger.config.js
import { defineSwaggerConfig } from '@pagoda-tools/swagger-ui';
export default defineSwaggerConfig({
info: {
title: '测试文档标题',
version: '1.0.0',
},
server: [
{
url: 'http://www.xxx.com',
description: '测试环境',
},
],
});
- 在 src 任意目录下新建
xx.dto.ts
,示例代码如下:
import {
defineSwaggerConfig,
defineSwaggerApi,
IsInt,
IsString,
Type,
ValidateNested,
} from '@pagoda-tools/swagger-ui';
class User {
@IsString()
name: string;
}
export class TestInput {
@IsInt()
@JSONSchema({
description: '字段描述',
})
a: number;
@ValidateNested({ each: true })
@Type(() => User)
@JSONSchema({
description: '字段描述',
})
users: User[];
}
export class TestOutput {
@IsInt()
a: number;
}
export default defineSwaggerApi({
method: 'get',
summary: '接口名称',
input: TestInput,
output: TestOutput,
});
- 在
package.json
的scripts
中新增命令
{
"scripts": {
"doc-serve": "pd-swagger-ui serve",
"export-doc-json": "pd-swagger-ui json"
}
}
- 执行
npm run doc-serve
swagger.config.js 配置项
interface SwaggerConfig {
info?: {
// 文档标题
title?: string;
// 文档描述
description?: string;
// 文档版本
version?: string;
};
server?: {
// 接口环境地址
url: string;
// 接口环境地址描述
description?: string;
}[];
}
IsInt
等修饰器参考 class-validator
1.0.0-beta.22
2 years ago
1.0.0-beta.23
2 years ago
1.0.0-beta.20
2 years ago
1.0.0-beta.21
2 years ago
1.0.0-beta.40
2 years ago
1.0.0-beta.41
2 years ago
1.0.0-beta.28
2 years ago
1.0.0-beta.29
2 years ago
1.0.0-beta.26
2 years ago
1.0.0-beta.27
2 years ago
1.0.0-beta.24
2 years ago
1.0.0-beta.25
2 years ago
1.0.0-beta.33
2 years ago
1.0.0-beta.34
2 years ago
1.0.0-beta.31
2 years ago
1.0.0-beta.32
2 years ago
1.0.0-beta.30
2 years ago
1.0.0-beta.19
2 years ago
1.0.0-beta.39
2 years ago
1.0.0-beta.17
2 years ago
1.0.0-beta.18
2 years ago
1.0.0-beta.37
2 years ago
1.0.0-beta.15
2 years ago
1.0.0-beta.38
2 years ago
1.0.0-beta.16
2 years ago
1.0.0-beta.35
2 years ago
1.0.0-beta.13
2 years ago
1.0.0-beta.36
2 years ago
1.0.0-beta.14
2 years ago
1.0.0-beta.12
2 years ago
1.0.0-beta.11
2 years ago
1.0.0-beta.10
2 years ago
1.0.0-beta.9
2 years ago
1.0.0-beta.8
2 years ago
1.0.0-beta.7
2 years ago
1.0.0-beta.6
2 years ago
1.0.0-beta.5
2 years ago
1.0.0-beta.4
2 years ago
1.0.0-beta.3
2 years ago
1.0.0-beta.2
2 years ago
1.0.0-beta.1
2 years ago
1.0.0-beta.0
2 years ago