Interface Schema
-
- All Superinterfaces:
Constructible
,Extensible
,Reference<Schema>
public interface Schema extends Extensible, Constructible, Reference<Schema>
The Schema Object allows the definition of input and output data types. These types can be objects, but also primitives and arrays. This object is an extended subset of the JSON Schema Specification Wright Draft 00.For more information about the properties, see JSON Schema Core and JSON Schema Validation. Unless stated otherwise, the property definitions follow the JSON Schema.
Any time a Schema Object can be used, a Reference Object can be used in its place. This allows referencing an existing definition instead of defining the same Schema again.
- See Also:
- OpenAPI Specification Schema Object
-
-
Nested Class Summary
Nested Classes Modifier and Type Interface Description static class
Schema.SchemaType
The values allowed for the in field.
-
Method Summary
All Methods Instance Methods Abstract Methods Modifier and Type Method Description Schema
addAllOf(Schema allOf)
Adds the given Schema to the list of schemas used by the allOf property.Schema
addAnyOf(Schema anyOf)
Adds the given Schema to the list of schemas used by the anyOf property.Schema
addEnumeration(java.lang.Object enumeration)
Adds an item of the appropriate type to the enumerated list of values allowed.Schema
additionalProperties(java.lang.Boolean additionalProperties)
Sets the value of "additionalProperties" to either True or False.Schema
additionalProperties(Schema additionalProperties)
Sets the Schema which defines additional properties not defined by "properties" or "patternProperties".Schema
addOneOf(Schema oneOf)
Adds the given Schema to the list of schemas used by the oneOf property.Schema
addProperty(java.lang.String key, Schema propertySchema)
Adds a Schema property of the provided name using the given schema.Schema
addRequired(java.lang.String required)
Adds the name of an item to the list of fields required in objects defined by this Schema.Schema
allOf(java.util.List<Schema> allOf)
Sets the schemas used by the allOf property of this Schema.Schema
anyOf(java.util.List<Schema> anyOf)
Sets the schemas used by the anyOf property of this Schema.Schema
defaultValue(java.lang.Object defaultValue)
Set the default value property of this Schema instance to the value given.Schema
deprecated(java.lang.Boolean deprecated)
Sets the deprecated property of this Schema.Schema
description(java.lang.String description)
Sets the description property of this Schema to the given string.Schema
discriminator(Discriminator discriminator)
Sets the discriminator property of this Schema instance to the given object.Schema
enumeration(java.util.List<java.lang.Object> enumeration)
Schema
example(java.lang.Object example)
Sets the example property of this Schema instance.Schema
exclusiveMaximum(java.lang.Boolean exclusiveMaximum)
Sets the exclusiveMaximum property of this Schema instance to the value given.Schema
exclusiveMinimum(java.lang.Boolean exclusiveMinimum)
Sets the exclusiveMinimum property of this Schema instance to the value given.Schema
externalDocs(ExternalDocumentation externalDocs)
Sets the externalDocs property of this Schema to the indicated value.Schema
format(java.lang.String format)
Sets the format property of this Schema instance to the given string.java.lang.Object
getAdditionalProperties()
Returns the value of the "additionalProperties" setting, which indicates whether properties not otherwise defined are allowed.java.util.List<Schema>
getAllOf()
Returns the schemas used by the allOf property.java.util.List<Schema>
getAnyOf()
Returns the schemas used by the anyOf property.java.lang.Object
getDefaultValue()
Returns the default value property from this Schema instance.java.lang.Boolean
getDeprecated()
Returns the deprecated property from this Schema instance.java.lang.String
getDescription()
Returns a description of the purpose of this Schema.Discriminator
getDiscriminator()
Returns the discriminator property from this Schema instance.java.util.List<java.lang.Object>
getEnumeration()
Returns the enumerated list of values allowed for objects defined by this Schema.java.lang.Object
getExample()
Returns the example property from this Schema instance.java.lang.Boolean
getExclusiveMaximum()
Returns the exclusiveMaximum property from this Schema instance.java.lang.Boolean
getExclusiveMinimum()
Returns the exclusiveMinimum property from this Schema instance.ExternalDocumentation
getExternalDocs()
Returns the externalDocs property from this Schema instance.java.lang.String
getFormat()
Returns the format property from this Schema instance.Schema
getItems()
Returns the Schema used for all the elements of an array typed Schema.java.math.BigDecimal
getMaximum()
Returns the maximum property from this Schema instance.java.lang.Integer
getMaxItems()
Returns the maxItems property from this Schema instance.java.lang.Integer
getMaxLength()
Returns the maxLength property from this Schema instance.java.lang.Integer
getMaxProperties()
Returns the maxProperties property from this Schema instance.java.math.BigDecimal
getMinimum()
Returns the minimum property from this Schema instance.java.lang.Integer
getMinItems()
Returns the minItems property from this Schema instance.java.lang.Integer
getMinLength()
Returns the minLength property from this Schema instance.java.lang.Integer
getMinProperties()
Returns the minProperties property from this Schema instance.java.math.BigDecimal
getMultipleOf()
Returns the multipleOf property from this Schema instance.Schema
getNot()
Returns a Schema which describes properties not allowed in objects defined by the current schema.java.lang.Boolean
getNullable()
Returns the nullable property from this Schema instance which indicates whether null is a valid value.java.util.List<Schema>
getOneOf()
Returns the schemas used by the oneOf property.java.lang.String
getPattern()
Returns the pattern property from this Schema instance.java.util.Map<java.lang.String,Schema>
getProperties()
Returns the properties defined in this Schema.java.lang.Boolean
getReadOnly()
Returns the readOnly property from this Schema instance.java.util.List<java.lang.String>
getRequired()
Returns the required property from this Schema instance.java.lang.String
getTitle()
Returns the title property from this Schema instance.Schema.SchemaType
getType()
Returns the type property from this Schema.java.lang.Boolean
getUniqueItems()
Returns the uniqueItems property from this Schema instance.java.lang.Boolean
getWriteOnly()
Returns the writeOnly property from this Schema instance.XML
getXml()
Returns the xml property from this Schema instance.Schema
items(Schema items)
Set the Schema used for all the elements of an array typed Schema.Schema
maximum(java.math.BigDecimal maximum)
Sets the maximum property of this Schema instance to the value given.Schema
maxItems(java.lang.Integer maxItems)
Sets the maxItems property of this Schema instance to the value given.Schema
maxLength(java.lang.Integer maxLength)
Sets the maxLength property of this Schema instance to the value given.Schema
maxProperties(java.lang.Integer maxProperties)
Sets the maxProperties property of this Schema instance to the value given.Schema
minimum(java.math.BigDecimal minimum)
Sets the minimum property of this Schema instance to the value given.Schema
minItems(java.lang.Integer minItems)
Sets the minItems property of this Schema instance to the value given.Schema
minLength(java.lang.Integer minLength)
Sets the minLength property of this Schema instance to the value given.Schema
minProperties(java.lang.Integer minProperties)
Sets the minProperties property of this Schema instance to the value given.Schema
multipleOf(java.math.BigDecimal multipleOf)
Sets the multipleOf property of this Schema instance to the value given.Schema
not(Schema not)
Sets the not property to a Schema which describes properties not allowed in objects defined by the current schema.Schema
nullable(java.lang.Boolean nullable)
Sets the nullable property of this Schema instance.Schema
oneOf(java.util.List<Schema> oneOf)
Sets the schemas used by the oneOf property of this Schema.Schema
pattern(java.lang.String pattern)
Sets the pattern property of this Schema instance to the string given.Schema
properties(java.util.Map<java.lang.String,Schema> properties)
Sets the properties of this Schema instance to the map provided.Schema
readOnly(java.lang.Boolean readOnly)
Sets the readOnly property of this Schema.Schema
required(java.util.List<java.lang.String> required)
Sets the list of fields required in objects defined by this Schema.void
setAdditionalProperties(java.lang.Boolean additionalProperties)
Sets the value of "additionalProperties" to either True or False.void
setAdditionalProperties(Schema additionalProperties)
Sets the Schema which defines additional properties not defined by "properties" or "patternProperties".void
setAllOf(java.util.List<Schema> allOf)
Sets the schemas used by the allOf property of this Schema.void
setAnyOf(java.util.List<Schema> anyOf)
Sets the schemas used by the anyOf property of this Schema.void
setDefaultValue(java.lang.Object defaultValue)
Set the default value property of this Schema instance to the value given.void
setDeprecated(java.lang.Boolean deprecated)
Sets the deprecated property of this Schema.void
setDescription(java.lang.String description)
Sets the description property of this Schema to the given string.void
setDiscriminator(Discriminator discriminator)
Sets the discriminator property of this Schema instance to the given object.void
setEnumeration(java.util.List<java.lang.Object> enumeration)
Sets the enumerated list of values allowed for objects defined by this Schema.void
setExample(java.lang.Object example)
Sets the example property of this Schema instance.void
setExclusiveMaximum(java.lang.Boolean exclusiveMaximum)
Sets the exclusiveMaximum property of this Schema instance to the value given.void
setExclusiveMinimum(java.lang.Boolean exclusiveMinimum)
Sets the exclusiveMinimum property of this Schema instance to the value given.void
setExternalDocs(ExternalDocumentation externalDocs)
Sets the externalDocs property of this Schema to the indicated value.void
setFormat(java.lang.String format)
Sets the format property of this Schema instance to the given string.void
setItems(Schema items)
Set the Schema used for all the elements of an array typed Schema.void
setMaximum(java.math.BigDecimal maximum)
Sets the maximum property of this Schema instance to the value given.void
setMaxItems(java.lang.Integer maxItems)
Sets the maxItems property of this Schema instance to the value given.void
setMaxLength(java.lang.Integer maxLength)
Sets the maxLength property of this Schema instance to the value given.void
setMaxProperties(java.lang.Integer maxProperties)
Sets the maxProperties property of this Schema instance to the value given.void
setMinimum(java.math.BigDecimal minimum)
Sets the minimum property of this Schema instance to the value given.void
setMinItems(java.lang.Integer minItems)
Sets the minItems property of this Schema instance to the value given.void
setMinLength(java.lang.Integer minLength)
Sets the minLength property of this Schema instance to the value given.void
setMinProperties(java.lang.Integer minProperties)
Sets the minProperties property of this Schema instance to the value given.void
setMultipleOf(java.math.BigDecimal multipleOf)
Sets the multipleOf property of this Schema instance to the value given.void
setNot(Schema not)
Sets the not property to a Schema which describes properties not allowed in objects defined by the current schema.void
setNullable(java.lang.Boolean nullable)
Sets the nullable property of this Schema instance.void
setOneOf(java.util.List<Schema> oneOf)
Sets the schemas used by the oneOf property of this Schema.void
setPattern(java.lang.String pattern)
Sets the pattern property of this Schema instance to the string given.void
setProperties(java.util.Map<java.lang.String,Schema> properties)
Sets the properties of this Schema instance to the map provided.void
setReadOnly(java.lang.Boolean readOnly)
Sets the readOnly property of this Schema.void
setRequired(java.util.List<java.lang.String> required)
Sets the list of fields required in objects defined by this Schema.void
setTitle(java.lang.String title)
Sets the title property of this Schema instance to the given string.void
setType(Schema.SchemaType type)
Sets the type used by this Schema to the string given.void
setUniqueItems(java.lang.Boolean uniqueItems)
Sets the uniqueItems property of this Schema instance to the value given.void
setWriteOnly(java.lang.Boolean writeOnly)
Sets the writeOnly property of this Schema.void
setXml(XML xml)
Sets the xml property of this Schema instance.Schema
title(java.lang.String title)
Sets the title property of this Schema instance to the given string.Schema
type(Schema.SchemaType type)
Sets the type used by this Schema to the string given.Schema
uniqueItems(java.lang.Boolean uniqueItems)
Sets the uniqueItems property of this Schema instance to the value given.Schema
writeOnly(java.lang.Boolean writeOnly)
Sets the writeOnly property of this Schema.Schema
xml(XML xml)
Sets the xml property of this Schema instance.-
Methods inherited from interface org.eclipse.microprofile.openapi.models.Extensible
addExtension, getExtensions, setExtensions
-
-
-
-
Method Detail
-
getDiscriminator
Discriminator getDiscriminator()
Returns the discriminator property from this Schema instance.- Returns:
- the discriminator that is used to differentiate between the schemas which may satisfy the payload description
-
setDiscriminator
void setDiscriminator(Discriminator discriminator)
Sets the discriminator property of this Schema instance to the given object.- Parameters:
discriminator
- the object that is used to differentiate between the schemas which may satisfy the payload description
-
discriminator
Schema discriminator(Discriminator discriminator)
Sets the discriminator property of this Schema instance to the given object.- Parameters:
discriminator
- the object that is used to differentiate between the schemas which may satisfy the payload description- Returns:
- the current Schema instance
-
getTitle
java.lang.String getTitle()
Returns the title property from this Schema instance.- Returns:
- the title assigned to this Schema
-
setTitle
void setTitle(java.lang.String title)
Sets the title property of this Schema instance to the given string.- Parameters:
title
- a title to assign to this Schema
-
title
Schema title(java.lang.String title)
Sets the title property of this Schema instance to the given string.- Parameters:
title
- a title to assign to this Schema- Returns:
- the current Schema instance
-
getDefaultValue
java.lang.Object getDefaultValue()
Returns the default value property from this Schema instance.- Returns:
- the default value object
-
setDefaultValue
void setDefaultValue(java.lang.Object defaultValue)
Set the default value property of this Schema instance to the value given.- Parameters:
defaultValue
- a value to use as the default
-
defaultValue
Schema defaultValue(java.lang.Object defaultValue)
Set the default value property of this Schema instance to the value given.- Parameters:
defaultValue
- a value to use as the default- Returns:
- the current Schema instance
-
getEnumeration
java.util.List<java.lang.Object> getEnumeration()
Returns the enumerated list of values allowed for objects defined by this Schema.- Returns:
- the list of values allowed for objects defined by this Schema
-
setEnumeration
void setEnumeration(java.util.List<java.lang.Object> enumeration)
Sets the enumerated list of values allowed for objects defined by this Schema.- Parameters:
enumeration
- a list of values allowed
-
enumeration
Schema enumeration(java.util.List<java.lang.Object> enumeration)
-
addEnumeration
Schema addEnumeration(java.lang.Object enumeration)
Adds an item of the appropriate type to the enumerated list of values allowed.- Parameters:
enumeration
- an object to add to the enumerated values- Returns:
- current Schema instance
-
getMultipleOf
java.math.BigDecimal getMultipleOf()
Returns the multipleOf property from this Schema instance.minimum: 0
- Returns:
- the positive number that restricts the value of the object
-
setMultipleOf
void setMultipleOf(java.math.BigDecimal multipleOf)
Sets the multipleOf property of this Schema instance to the value given.- Parameters:
multipleOf
- a positive number that restricts the value of objects described by this Schema
-
multipleOf
Schema multipleOf(java.math.BigDecimal multipleOf)
Sets the multipleOf property of this Schema instance to the value given.- Parameters:
multipleOf
- a positive number that restricts the value of objects described by this Schema- Returns:
- the current Schema instance
-
getMaximum
java.math.BigDecimal getMaximum()
Returns the maximum property from this Schema instance.- Returns:
- the maximum value of a numeric object
-
setMaximum
void setMaximum(java.math.BigDecimal maximum)
Sets the maximum property of this Schema instance to the value given.- Parameters:
maximum
- specifies the maximum numeric value of objects defined by this Schema
-
maximum
Schema maximum(java.math.BigDecimal maximum)
Sets the maximum property of this Schema instance to the value given.- Parameters:
maximum
- specifies the maximum numeric value of objects defined by this Schema- Returns:
- the current Schema instance
-
getExclusiveMaximum
java.lang.Boolean getExclusiveMaximum()
Returns the exclusiveMaximum property from this Schema instance.- Returns:
- whether the numeric value of objects must be less than the maximum property
-
setExclusiveMaximum
void setExclusiveMaximum(java.lang.Boolean exclusiveMaximum)
Sets the exclusiveMaximum property of this Schema instance to the value given.- Parameters:
exclusiveMaximum
- when true the numeric value of objects defined by this Schema must be less than indicated by the maximum property
-
exclusiveMaximum
Schema exclusiveMaximum(java.lang.Boolean exclusiveMaximum)
Sets the exclusiveMaximum property of this Schema instance to the value given.- Parameters:
exclusiveMaximum
- when true the numeric value of objects defined by this Schema must be less than indicated by the maximum property- Returns:
- the current Schema instance
-
getMinimum
java.math.BigDecimal getMinimum()
Returns the minimum property from this Schema instance.- Returns:
- the minimum value of a numeric object
-
setMinimum
void setMinimum(java.math.BigDecimal minimum)
Sets the minimum property of this Schema instance to the value given.- Parameters:
minimum
- specifies the minimum numeric value of objects defined by this Schema
-
minimum
Schema minimum(java.math.BigDecimal minimum)
Sets the minimum property of this Schema instance to the value given.- Parameters:
minimum
- specifies the minimum numeric value of objects defined by this Schema- Returns:
- the current Schema instance
-
getExclusiveMinimum
java.lang.Boolean getExclusiveMinimum()
Returns the exclusiveMinimum property from this Schema instance.- Returns:
- whether the numeric value of objects must be greater than the minimum property
-
setExclusiveMinimum
void setExclusiveMinimum(java.lang.Boolean exclusiveMinimum)
Sets the exclusiveMinimum property of this Schema instance to the value given.- Parameters:
exclusiveMinimum
- when true the numeric value of objects defined by this Schema must be greater than indicated by the minimum property
-
exclusiveMinimum
Schema exclusiveMinimum(java.lang.Boolean exclusiveMinimum)
Sets the exclusiveMinimum property of this Schema instance to the value given.- Parameters:
exclusiveMinimum
- when true the numeric value of objects defined by this Schema must be greater than indicated by the minimum property- Returns:
- the current Schema instance
-
getMaxLength
java.lang.Integer getMaxLength()
Returns the maxLength property from this Schema instance.minimum: 0
- Returns:
- the maximum length of objects e.g. strings
-
setMaxLength
void setMaxLength(java.lang.Integer maxLength)
Sets the maxLength property of this Schema instance to the value given.- Parameters:
maxLength
- the maximum length of objects defined by this Schema
-
maxLength
Schema maxLength(java.lang.Integer maxLength)
Sets the maxLength property of this Schema instance to the value given.- Parameters:
maxLength
- the maximum length of objects defined by this Schema- Returns:
- the current Schema instance
-
getMinLength
java.lang.Integer getMinLength()
Returns the minLength property from this Schema instance.minimum: 0
- Returns:
- the minimum length of objects e.g. strings
-
setMinLength
void setMinLength(java.lang.Integer minLength)
Sets the minLength property of this Schema instance to the value given.- Parameters:
minLength
- the minimum length of objects defined by this Schema
-
minLength
Schema minLength(java.lang.Integer minLength)
Sets the minLength property of this Schema instance to the value given.- Parameters:
minLength
- the minimum length of objects defined by this Schema- Returns:
- the current Schema instance
-
getPattern
java.lang.String getPattern()
Returns the pattern property from this Schema instance.- Returns:
- the regular expression which restricts the value of an object e.g. a string
-
setPattern
void setPattern(java.lang.String pattern)
Sets the pattern property of this Schema instance to the string given.- Parameters:
pattern
- the regular expression which restricts objects defined by this Schema
-
pattern
Schema pattern(java.lang.String pattern)
Sets the pattern property of this Schema instance to the string given.- Parameters:
pattern
- the regular expression which restricts objects defined by this Schema- Returns:
- the current Schema instance
-
getMaxItems
java.lang.Integer getMaxItems()
Returns the maxItems property from this Schema instance.minimum: 0
- Returns:
- the maximum number of elements in the object e.g. array elements
-
setMaxItems
void setMaxItems(java.lang.Integer maxItems)
Sets the maxItems property of this Schema instance to the value given.- Parameters:
maxItems
- the maximum number of elements in objects defined by this Schema e.g. array elements
-
maxItems
Schema maxItems(java.lang.Integer maxItems)
Sets the maxItems property of this Schema instance to the value given.- Parameters:
maxItems
- the maximum number of elements in objects defined by this Schema e.g. array elements- Returns:
- the current Schema instance
-
getMinItems
java.lang.Integer getMinItems()
Returns the minItems property from this Schema instance.minimum: 0
- Returns:
- the minimum number of elements in the object e.g. array elements
-
setMinItems
void setMinItems(java.lang.Integer minItems)
Sets the minItems property of this Schema instance to the value given.- Parameters:
minItems
- the minimum number of elements in objects defined by this Schema e.g. array elements
-
minItems
Schema minItems(java.lang.Integer minItems)
Sets the minItems property of this Schema instance to the value given.- Parameters:
minItems
- the minimum number of elements in objects defined by this Schema e.g. array elements- Returns:
- the current Schema instance
-
getUniqueItems
java.lang.Boolean getUniqueItems()
Returns the uniqueItems property from this Schema instance.- Returns:
- whether to ensure items are unique
-
setUniqueItems
void setUniqueItems(java.lang.Boolean uniqueItems)
Sets the uniqueItems property of this Schema instance to the value given.- Parameters:
uniqueItems
- ensure the items (e.g. array elements) are unique in objects defined by this Schema
-
uniqueItems
Schema uniqueItems(java.lang.Boolean uniqueItems)
Sets the uniqueItems property of this Schema instance to the value given.- Parameters:
uniqueItems
- ensure the items (e.g. array elements) are unique in objects defined by this Schema- Returns:
- the current Schema instance
-
getMaxProperties
java.lang.Integer getMaxProperties()
Returns the maxProperties property from this Schema instance.minimum: 0
- Returns:
- the maximum number of properties allowed in the object
-
setMaxProperties
void setMaxProperties(java.lang.Integer maxProperties)
Sets the maxProperties property of this Schema instance to the value given.- Parameters:
maxProperties
- limit the number of properties in objects defined by this Schema
-
maxProperties
Schema maxProperties(java.lang.Integer maxProperties)
Sets the maxProperties property of this Schema instance to the value given.- Parameters:
maxProperties
- limit the number of properties in objects defined by this Schema- Returns:
- the current Schema instance
-
getMinProperties
java.lang.Integer getMinProperties()
Returns the minProperties property from this Schema instance.minimum: 0
- Returns:
- the minimum number of properties allowed in the object
-
setMinProperties
void setMinProperties(java.lang.Integer minProperties)
Sets the minProperties property of this Schema instance to the value given.- Parameters:
minProperties
- limit the number of properties in objects defined by this Schema
-
minProperties
Schema minProperties(java.lang.Integer minProperties)
Sets the minProperties property of this Schema instance to the value given.- Parameters:
minProperties
- limit the number of properties in objects defined by this Schema- Returns:
- the current Schema instance
-
getRequired
java.util.List<java.lang.String> getRequired()
Returns the required property from this Schema instance.- Returns:
- the list of fields required in objects defined by this Schema
-
setRequired
void setRequired(java.util.List<java.lang.String> required)
Sets the list of fields required in objects defined by this Schema.- Parameters:
required
- the list of fields required in objects defined by this Schema
-
required
Schema required(java.util.List<java.lang.String> required)
Sets the list of fields required in objects defined by this Schema.- Parameters:
required
- the list of fields required in objects defined by this Schema- Returns:
- the current Schema instance
-
addRequired
Schema addRequired(java.lang.String required)
Adds the name of an item to the list of fields required in objects defined by this Schema.- Parameters:
required
- the name of an item required in objects defined by this Schema instance- Returns:
- the current Schema instance
-
getType
Schema.SchemaType getType()
Returns the type property from this Schema.- Returns:
- the type used in this Schema. Default value must be
null
-
setType
void setType(Schema.SchemaType type)
Sets the type used by this Schema to the string given.- Parameters:
type
- the type used by this Schema ornull
for reference schemas
-
type
Schema type(Schema.SchemaType type)
Sets the type used by this Schema to the string given.- Parameters:
type
- the type used by this Schema ornull
for reference schemas- Returns:
- the current Schema instance
-
getNot
Schema getNot()
Returns a Schema which describes properties not allowed in objects defined by the current schema.- Returns:
- the not property's schema
-
setNot
void setNot(Schema not)
Sets the not property to a Schema which describes properties not allowed in objects defined by the current schema.- Parameters:
not
- the Schema which describes properties not allowed
-
not
Schema not(Schema not)
Sets the not property to a Schema which describes properties not allowed in objects defined by the current schema.- Parameters:
not
- the Schema which describes properties not allowed- Returns:
- the current Schema instance
-
getProperties
java.util.Map<java.lang.String,Schema> getProperties()
Returns the properties defined in this Schema.- Returns:
- a map which associates property names with the schemas that describe their contents
-
setProperties
void setProperties(java.util.Map<java.lang.String,Schema> properties)
Sets the properties of this Schema instance to the map provided.- Parameters:
properties
- a map which associates property names with the schemas that describe their contents
-
properties
Schema properties(java.util.Map<java.lang.String,Schema> properties)
Sets the properties of this Schema instance to the map provided.- Parameters:
properties
- a map which associates property names with the schemas that describe their contents- Returns:
- the current Schema instance
-
addProperty
Schema addProperty(java.lang.String key, Schema propertySchema)
Adds a Schema property of the provided name using the given schema.- Parameters:
key
- the name of a new Schema propertypropertySchema
- the Schema which describes the properties of the named property- Returns:
- the current Schema instance
-
getAdditionalProperties
java.lang.Object getAdditionalProperties()
Returns the value of the "additionalProperties" setting, which indicates whether properties not otherwise defined are allowed. This setting MUST either be aBoolean
orSchema
.- If "additionalProperties" is true, then any additional properties are allowed.
- If "additionalProperties" is false, then only properties covered by the "properties" and "patternProperties" are allowed.
- If "additionalProperties" is a Schema, then additional properties are allowed but should conform to the Schema.
- Returns:
- this Schema's additionalProperties property
-
setAdditionalProperties
void setAdditionalProperties(Schema additionalProperties)
Sets the Schema which defines additional properties not defined by "properties" or "patternProperties". See the javadoc forgetAdditionalProperties()
for more details on this setting. Note that this version of the setter is mutually exclusive with the Boolean variants.- Parameters:
additionalProperties
- a Schema which defines additional properties
-
setAdditionalProperties
void setAdditionalProperties(java.lang.Boolean additionalProperties)
Sets the value of "additionalProperties" to either True or False. See the javadoc forgetAdditionalProperties()
for more details on this setting. Note that this version of the setter is mutually exclusive with theSchema
variants.- Parameters:
additionalProperties
- a Schema which defines additional properties
-
additionalProperties
Schema additionalProperties(Schema additionalProperties)
Sets the Schema which defines additional properties not defined by "properties" or "patternProperties". See the javadoc forgetAdditionalProperties()
for more details on this setting. Note that this version of the setter is mutually exclusive with the Boolean variants.- Parameters:
additionalProperties
- a Schema which defines additional properties- Returns:
- the current Schema instance
-
additionalProperties
Schema additionalProperties(java.lang.Boolean additionalProperties)
Sets the value of "additionalProperties" to either True or False. See the javadoc forgetAdditionalProperties()
for more details on this setting. Note that this version of the setter is mutually exclusive with theSchema
variants.- Parameters:
additionalProperties
- a Schema which defines additional properties- Returns:
- the current Schema instance
-
getDescription
java.lang.String getDescription()
Returns a description of the purpose of this Schema.- Returns:
- a string containing a description
-
setDescription
void setDescription(java.lang.String description)
Sets the description property of this Schema to the given string.- Parameters:
description
- a string containing a description of the purpose of this Schema
-
description
Schema description(java.lang.String description)
Sets the description property of this Schema to the given string.- Parameters:
description
- a string containing a description of the purpose of this Schema- Returns:
- the current Schema instance
-
getFormat
java.lang.String getFormat()
Returns the format property from this Schema instance. This property clarifies the data type specified in the type property.- Returns:
- a string describing the format of the data in this Schema
-
setFormat
void setFormat(java.lang.String format)
Sets the format property of this Schema instance to the given string. The value may be one of the formats described in the OAS or a user defined format.- Parameters:
format
- the string specifying the data format
-
format
Schema format(java.lang.String format)
Sets the format property of this Schema instance to the given string. The value may be one of the formats described in the OAS or a user defined format.- Parameters:
format
- the string specifying the data format- Returns:
- the current Schema instance
-
getNullable
java.lang.Boolean getNullable()
Returns the nullable property from this Schema instance which indicates whether null is a valid value.- Returns:
- the nullable property
-
setNullable
void setNullable(java.lang.Boolean nullable)
Sets the nullable property of this Schema instance. Specify true if this Schema will allow null values.- Parameters:
nullable
- a boolean value indicating this Schema allows a null value.
-
nullable
Schema nullable(java.lang.Boolean nullable)
Sets the nullable property of this Schema instance. Specify true if this Schema will allow null values.- Parameters:
nullable
- a boolean value indicating this Schema allows a null value.- Returns:
- the current Schema instance
-
getReadOnly
java.lang.Boolean getReadOnly()
Returns the readOnly property from this Schema instance.- Returns:
- indication that the Schema is only valid in a response message
-
setReadOnly
void setReadOnly(java.lang.Boolean readOnly)
Sets the readOnly property of this Schema. Only valid when the Schema is the property in an object.- Parameters:
readOnly
- true indicates the Schema should not be sent as part of a request message
-
readOnly
Schema readOnly(java.lang.Boolean readOnly)
Sets the readOnly property of this Schema. Only valid when the Schema is the property in an object.- Parameters:
readOnly
- true indicates the Schema should not be sent as part of a request message- Returns:
- the current Schema instance
-
getWriteOnly
java.lang.Boolean getWriteOnly()
Returns the writeOnly property from this Schema instance.- Returns:
- indication that the Schema is only valid in a request message
-
setWriteOnly
void setWriteOnly(java.lang.Boolean writeOnly)
Sets the writeOnly property of this Schema. Only valid when the Schema is the property in an object.- Parameters:
writeOnly
- true indicates the Schema should not be sent as part of a response message
-
writeOnly
Schema writeOnly(java.lang.Boolean writeOnly)
Sets the writeOnly property of this Schema. Only valid when the Schema is the property in an object.- Parameters:
writeOnly
- true indicates the Schema should not be sent as part of a response message- Returns:
- the current Schema instance
-
getExample
java.lang.Object getExample()
Returns the example property from this Schema instance.- Returns:
- an object which is an example of an instance of this Schema
-
setExample
void setExample(java.lang.Object example)
Sets the example property of this Schema instance. To represent examples that cannot be naturally represented in JSON or YAML, a string value can be used to contain the example with escaping where necessary.- Parameters:
example
- an object which is an instance of this Schema
-
example
Schema example(java.lang.Object example)
Sets the example property of this Schema instance. To represent examples that cannot be naturally represented in JSON or YAML, a string value can be used to contain the example with escaping where necessary.- Parameters:
example
- an object which is an instance of this Schema- Returns:
- the current Schema instance
-
getExternalDocs
ExternalDocumentation getExternalDocs()
Returns the externalDocs property from this Schema instance.- Returns:
- additional external documentation for this Schema
-
setExternalDocs
void setExternalDocs(ExternalDocumentation externalDocs)
Sets the externalDocs property of this Schema to the indicated value.- Parameters:
externalDocs
- an additional external documentation object
-
externalDocs
Schema externalDocs(ExternalDocumentation externalDocs)
Sets the externalDocs property of this Schema to the indicated value.- Parameters:
externalDocs
- an additional external documentation object- Returns:
- the current Schema instance
-
getDeprecated
java.lang.Boolean getDeprecated()
Returns the deprecated property from this Schema instance.- Returns:
- indication that the Schema is deprecated and should be transitioned out of usage
-
setDeprecated
void setDeprecated(java.lang.Boolean deprecated)
Sets the deprecated property of this Schema. This specifies that the Schema is deprecated and should be transitioned out of usage- Parameters:
deprecated
- true to indicate this Schema is deprecated
-
deprecated
Schema deprecated(java.lang.Boolean deprecated)
Sets the deprecated property of this Schema. This specifies that the Schema is deprecated and should be transitioned out of usage- Parameters:
deprecated
- true to indicate this Schema is deprecated- Returns:
- the current Schema instance
-
getXml
XML getXml()
Returns the xml property from this Schema instance.- Returns:
- a metadata object that allows for more fine-tuned XML model definitions
-
setXml
void setXml(XML xml)
Sets the xml property of this Schema instance. It may only be set on properties schemas and adds additional metadata to describe the XML representation of this property.- Parameters:
xml
- a metadata object to describe the XML representation of this property
-
xml
Schema xml(XML xml)
Sets the xml property of this Schema instance. It may only be set on properties schemas and adds additional metadata to describe the XML representation of this property.- Parameters:
xml
- a metadata object to describe the XML representation of this property- Returns:
- the current Schema instance
-
getItems
Schema getItems()
Returns the Schema used for all the elements of an array typed Schema.- Returns:
- the Schema used for all the elements
-
setItems
void setItems(Schema items)
Set the Schema used for all the elements of an array typed Schema.- Parameters:
items
- the Schema used by this array
-
items
Schema items(Schema items)
Set the Schema used for all the elements of an array typed Schema.- Parameters:
items
- the Schema used by this array- Returns:
- the current Schema instance
-
getAllOf
java.util.List<Schema> getAllOf()
Returns the schemas used by the allOf property.- Returns:
- the list of schemas used by the allOf property
-
setAllOf
void setAllOf(java.util.List<Schema> allOf)
Sets the schemas used by the allOf property of this Schema.- Parameters:
allOf
- the list of schemas used by the allOf property
-
allOf
Schema allOf(java.util.List<Schema> allOf)
Sets the schemas used by the allOf property of this Schema.- Parameters:
allOf
- the list of schemas used by the allOf property- Returns:
- the current Schema instance
-
addAllOf
Schema addAllOf(Schema allOf)
Adds the given Schema to the list of schemas used by the allOf property.- Parameters:
allOf
- a Schema to use with the allOf property- Returns:
- the current Schema instance
-
getAnyOf
java.util.List<Schema> getAnyOf()
Returns the schemas used by the anyOf property.- Returns:
- the list of schemas used by the anyOf property
-
setAnyOf
void setAnyOf(java.util.List<Schema> anyOf)
Sets the schemas used by the anyOf property of this Schema.- Parameters:
anyOf
- the list of schemas used by the anyOf property
-
anyOf
Schema anyOf(java.util.List<Schema> anyOf)
Sets the schemas used by the anyOf property of this Schema.- Parameters:
anyOf
- the list of schemas used by the anyOf property- Returns:
- the current Schema instance
-
addAnyOf
Schema addAnyOf(Schema anyOf)
Adds the given Schema to the list of schemas used by the anyOf property.- Parameters:
anyOf
- a Schema to use with the anyOf property- Returns:
- the current Schema instance
-
getOneOf
java.util.List<Schema> getOneOf()
Returns the schemas used by the oneOf property.- Returns:
- the list of schemas used by the oneOf property
-
setOneOf
void setOneOf(java.util.List<Schema> oneOf)
Sets the schemas used by the oneOf property of this Schema.- Parameters:
oneOf
- the list of schemas used by the oneOf property
-
oneOf
Schema oneOf(java.util.List<Schema> oneOf)
Sets the schemas used by the oneOf property of this Schema.- Parameters:
oneOf
- the list of schemas used by the oneOf property- Returns:
- the current Schema instance
-
-