public class Schema
extends java.lang.Object
用于定义 API 响应的 JSON Schema 结构。 支持描述对象的属性、数组的元素类型、枚举值等。
示例:定义一个用户对象的 Schema
Schema userSchema = new Schema()
.setType(Schema.Type.OBJECT)
.setDescription("用户信息")
.addProperty("name", new Schema().setType(Schema.Type.STRING))
.addProperty("age", new Schema().setType(Schema.Type.INTEGER));
| 限定符和类型 | 类和说明 |
|---|---|
static class |
Schema.Type
Schema 类型枚举
|
| 构造器和说明 |
|---|
Schema() |
| 限定符和类型 | 方法和说明 |
|---|---|
Schema |
addProperty(java.lang.String name,
Schema schema)
便捷方法:添加属性
|
java.util.List<Schema> |
getAnyOf() |
java.lang.String |
getDescription() |
java.lang.Object |
getExample() |
java.lang.String |
getFormat() |
Schema |
getItems() |
java.lang.Number |
getMaximum() |
java.lang.Long |
getMaxItems() |
java.lang.Long |
getMaxLength() |
java.lang.Long |
getMaxProperties() |
java.lang.Number |
getMinimum() |
java.lang.Long |
getMinItems() |
java.lang.Long |
getMinLength() |
java.lang.Long |
getMinProperties() |
java.lang.Boolean |
getNullable() |
java.lang.String |
getPattern() |
java.util.Map<java.lang.String,Schema> |
getProperties() |
java.util.List<java.lang.String> |
getPropertyOrdering() |
java.util.List<java.lang.String> |
getRequiredList() |
java.lang.String |
getTitle() |
Schema.Type |
getType() |
Schema |
setAnyOf(java.util.List<Schema> anyOf) |
Schema |
setDescription(java.lang.String description) |
Schema |
setExample(java.lang.Object example) |
Schema |
setFormat(java.lang.String format) |
Schema |
setItems(Schema items) |
Schema |
setMaximum(java.lang.Number maximum) |
Schema |
setMaxItems(java.lang.Long maxItems) |
Schema |
setMaxLength(java.lang.Long maxLength) |
Schema |
setMaxProperties(java.lang.Long maxProperties) |
Schema |
setMinimum(java.lang.Number minimum) |
Schema |
setMinItems(java.lang.Long minItems) |
Schema |
setMinLength(java.lang.Long minLength) |
Schema |
setMinProperties(java.lang.Long minProperties) |
Schema |
setNullable(java.lang.Boolean nullable) |
Schema |
setPattern(java.lang.String pattern) |
Schema |
setProperties(java.util.Map<java.lang.String,Schema> properties) |
Schema |
setPropertyOrdering(java.util.List<java.lang.String> propertyOrdering) |
Schema |
setRequiredList(java.util.List<java.lang.String> required) |
Schema |
setTitle(java.lang.String title) |
Schema |
setType(Schema.Type type) |
public Schema.Type getType()
public Schema setType(Schema.Type type)
public java.lang.String getDescription()
public Schema setDescription(java.lang.String description)
public java.lang.String getTitle()
public Schema setTitle(java.lang.String title)
public java.lang.String getFormat()
public Schema setFormat(java.lang.String format)
public java.util.Map<java.lang.String,Schema> getProperties()
public java.util.List<java.lang.String> getRequiredList()
public Schema setRequiredList(java.util.List<java.lang.String> required)
public java.lang.Long getMinProperties()
public Schema setMinProperties(java.lang.Long minProperties)
public java.lang.Long getMaxProperties()
public Schema setMaxProperties(java.lang.Long maxProperties)
public Schema getItems()
public java.lang.Long getMinItems()
public Schema setMinItems(java.lang.Long minItems)
public java.lang.Long getMaxItems()
public Schema setMaxItems(java.lang.Long maxItems)
public java.lang.Long getMinLength()
public Schema setMinLength(java.lang.Long minLength)
public java.lang.Long getMaxLength()
public Schema setMaxLength(java.lang.Long maxLength)
public java.lang.String getPattern()
public Schema setPattern(java.lang.String pattern)
public java.lang.Number getMinimum()
public Schema setMinimum(java.lang.Number minimum)
public java.lang.Number getMaximum()
public Schema setMaximum(java.lang.Number maximum)
public java.lang.Boolean getNullable()
public Schema setNullable(java.lang.Boolean nullable)
public java.lang.Object getExample()
public Schema setExample(java.lang.Object example)
public java.util.List<Schema> getAnyOf()
public java.util.List<java.lang.String> getPropertyOrdering()
public Schema setPropertyOrdering(java.util.List<java.lang.String> propertyOrdering)