Hapydev JSON Schema
Hapydev JSON Schema 扩展是对标准 JSON Schema 的自定义增强,旨在满足特定需求或提供额外功能。虽然 JSON Schema 是验证 JSON 数据结构的标准,但在某些情况下,它可能无法充分描述复杂的验证逻辑。通过扩展,开发者可以添加自定义属性、规则或描述,实现更灵活的验证。
Hapydev 的 JSON Schema 扩展则提供了一系列自定义功能,旨在增强标准 JSON Schema,以满足特定的 API 开发和测试需求。
x_hapydev_orders 扩展
用于控制 object 类型中各个字段的排序,允许自定义 JSON 数据结构中字段的顺序。
{
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
},
"x_hapydev_orders": [ //字段排序,避免操作object对象后排序打乱
"id",
"name"
]
}
x_hapydev_overrides 扩展
用于对引用的数据模型进行数据重定义,以替代原有参数内容。
{
"properties": {
"id": {
"type": "string"
},
"category": {
"$ref": "#/definitions/4dcfb1a3",
"x_hapydev_overrides": {
"id": { //覆盖引用对象中的id参数内容
"type": "string",
"mock": "@uuid"
}
}
}
},
}