Package org.apache.juneau.bean.openapi3

Class SchemaInfo

java.lang.Object
org.apache.juneau.bean.openapi3.OpenApiElement
org.apache.juneau.bean.openapi3.SchemaInfo
public class SchemaInfo extends OpenApiElement
Allows the definition of input and output data types.

The Schema Object allows the definition of input and output data types, including objects, primitives, and arrays. This object is an extended subset of the JSON Schema Specification Draft 4, with additional extensions provided by the OpenAPI Specification to allow for more complete documentation.

OpenAPI Specification:

The Schema Object supports all properties from JSON Schema Draft 4, including but not limited to:

  • type (string) - The data type. Values: "string", "number", "integer", "boolean", "array", "object"
  • format (string) - The format modifier (e.g., "int32", "int64", "float", "double", "date", "date-time")
  • title (string) - A short title for the schema
  • description (string) - A description of the schema (CommonMark syntax may be used)
  • default (any) - The default value
  • multipleOf (number) - Must be a multiple of this value
  • maximum (number) - Maximum value (inclusive by default)
  • exclusiveMaximum (boolean) - If true, maximum is exclusive
  • minimum (number) - Minimum value (inclusive by default)
  • exclusiveMinimum (boolean) - If true, minimum is exclusive
  • maxLength (integer) - Maximum string length
  • minLength (integer) - Minimum string length
  • pattern (string) - Regular expression pattern the string must match
  • maxItems (integer) - Maximum array length
  • minItems (integer) - Minimum array length
  • uniqueItems (boolean) - If true, array items must be unique
  • maxProperties (integer) - Maximum number of object properties
  • minProperties (integer) - Minimum number of object properties
  • required (array of string) - Required property names
  • enum (array) - Possible values for this schema
  • properties (map of SchemaInfo) - Object property definitions
  • items (Items) - Schema for array items
  • allOf (array of SchemaInfo) - Must validate against all schemas
  • oneOf (array of SchemaInfo) - Must validate against exactly one schema
  • anyOf (array of SchemaInfo) - Must validate against any schema
  • not (SchemaInfo) - Must not validate against this schema
  • nullable (boolean) - Allows the value to be null (OpenAPI 3.0 extension)
  • discriminator (Discriminator) - Discriminator for polymorphism (OpenAPI extension)
  • readOnly (boolean) - Relevant only for Schema properties (OpenAPI extension)
  • writeOnly (boolean) - Relevant only for Schema properties (OpenAPI extension)
  • xml (Xml) - XML representation details (OpenAPI extension)
  • externalDocs (ExternalDocumentation) - Additional external documentation (OpenAPI extension)
  • example (any) - Example value (OpenAPI extension)
  • deprecated (boolean) - Specifies that the schema is deprecated (OpenAPI extension)
Example:

// Create a schema for a Pet object SchemaInfo schema = new SchemaInfo() .setType("object") .setRequired("id", "name") .setProperties( JsonMap.of( "id", new SchemaInfo().setType("integer").setFormat("int64"), "name", new SchemaInfo().setType("string"), "tag", new SchemaInfo().setType("string") ) );

See Also:

  • Constructor Details

    • SchemaInfo

      public SchemaInfo()
      Default constructor.

    • SchemaInfo

      public SchemaInfo(SchemaInfo copyFrom)
      Copy constructor.
      Parameters:
      copyFrom - The object to copy.

  • Method Details

    • copy

      public SchemaInfo copy()
      Make a deep copy of this object.
      Returns:
      A deep copy of this object.

    • getFormat

      public String getFormat()
      Bean property getter: format.
      Returns:
      The property value, or null if it is not set.

    • setFormat

      public SchemaInfo setFormat(String value)
      Bean property setter: format.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Formats defined by the OAS include:
      • "int32"
      • "int64"
      • "float"
      • "double"
      • "byte"
      • "binary"
      • "date"
      • "date-time"
      • "password"
      Returns:
      This object

    • getTitle

      public String getTitle()
      Bean property getter: title.
      Returns:
      The property value, or null if it is not set.

    • setTitle

      public SchemaInfo setTitle(String value)
      Bean property setter: title.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getDescription

      public String getDescription()
      Bean property getter: description.
      Returns:
      The property value, or null if it is not set.

    • setDescription

      public SchemaInfo setDescription(String value)
      Bean property setter: description.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getDefault

      public Object getDefault()
      Bean property getter: default.

      Unlike JSON Schema, the value MUST conform to the defined type for the Schema Object.

      Returns:
      The property value, or null if it is not set.

    • setDefault

      public SchemaInfo setDefault(Object value)
      Bean property setter: default.

      Unlike JSON Schema, the value MUST conform to the defined type for the Schema Object.

      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getMultipleOf

      public Number getMultipleOf()
      Bean property getter: multipleOf.
      Returns:
      The property value, or null if it is not set.

    • setMultipleOf

      public SchemaInfo setMultipleOf(Number value)
      Bean property setter: multipleOf.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getMaximum

      public Number getMaximum()
      Bean property getter: maximum.
      Returns:
      The property value, or null if it is not set.

    • setMaximum

      public SchemaInfo setMaximum(Number value)
      Bean property setter: maximum.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getExclusiveMaximum

      public Boolean getExclusiveMaximum()
      Bean property getter: exclusiveMaximum.
      Returns:
      The property value, or null if it is not set.

    • setExclusiveMaximum

      public SchemaInfo setExclusiveMaximum(Boolean value)
      Bean property setter: exclusiveMaximum.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getMinimum

      public Number getMinimum()
      Bean property getter: minimum.
      Returns:
      The property value, or null if it is not set.

    • setMinimum

      public SchemaInfo setMinimum(Number value)
      Bean property setter: minimum.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getExclusiveMinimum

      public Boolean getExclusiveMinimum()
      Bean property getter: exclusiveMinimum.
      Returns:
      The property value, or null if it is not set.

    • setExclusiveMinimum

      public SchemaInfo setExclusiveMinimum(Boolean value)
      Bean property setter: exclusiveMinimum.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getMaxLength

      public Integer getMaxLength()
      Bean property getter: maxLength.
      Returns:
      The property value, or null if it is not set.

    • setMaxLength

      public SchemaInfo setMaxLength(Integer value)
      Bean property setter: maxLength.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getMinLength

      public Integer getMinLength()
      Bean property getter: minLength.
      Returns:
      The property value, or null if it is not set.

    • setMinLength

      public SchemaInfo setMinLength(Integer value)
      Bean property setter: minLength.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getPattern

      public String getPattern()
      Bean property getter: pattern.
      Returns:
      The property value, or null if it is not set.

    • setPattern

      public SchemaInfo setPattern(String value)
      Bean property setter: pattern.

      This string SHOULD be a valid regular expression.

      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getMaxItems

      public Integer getMaxItems()
      Bean property getter: maxItems.
      Returns:
      The property value, or null if it is not set.

    • setMaxItems

      public SchemaInfo setMaxItems(Integer value)
      Bean property setter: maxItems.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getMinItems

      public Integer getMinItems()
      Bean property getter: minItems.
      Returns:
      The property value, or null if it is not set.

    • setMinItems

      public SchemaInfo setMinItems(Integer value)
      Bean property setter: minItems.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getUniqueItems

      public Boolean getUniqueItems()
      Bean property getter: uniqueItems.
      Returns:
      The property value, or null if it is not set.

    • setUniqueItems

      public SchemaInfo setUniqueItems(Boolean value)
      Bean property setter: uniqueItems.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getNullable

      public Boolean getNullable()
      Bean property getter: uniqueItems.
      Returns:
      The property value, or null if it is not set.

    • setNullable

      public SchemaInfo setNullable(Boolean value)
      Bean property setter: nullable.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getMaxProperties

      public Integer getMaxProperties()
      Bean property getter: maxProperties.
      Returns:
      The property value, or null if it is not set.

    • setMaxProperties

      public SchemaInfo setMaxProperties(Integer value)
      Bean property setter: maxProperties.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getMinProperties

      public Integer getMinProperties()
      Bean property getter: minProperties.
      Returns:
      The property value, or null if it is not set.

    • setMinProperties

      public SchemaInfo setMinProperties(Integer value)
      Bean property setter: minProperties.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getRequired

      public List<String> getRequired()
      Bean property getter: required.

      The list of required properties.

      Returns:
      The property value, or null if it is not set.

    • setRequired

      public SchemaInfo setRequired(Collection<String> value)
      Bean property setter: required.

      The list of required properties.

      Parameters:
      value - The new value for this property.
      Valid values:
      • "http"
      • "https"
      • "ws"
      • "wss"

      Can be null to unset the property.
      Returns:
      This object

    • addRequired

      public SchemaInfo addRequired(String... values)
      Same as addRequired(String...).
      Parameters:
      values - The new value for this property.
      Valid types:
      • Collection<String>
      • String - JSON array representation of Collection<String>
        Example:

        schemes("['scheme1','scheme2']");

      • String - Individual values
        Example:

        schemes("scheme1, "scheme2");

      Returns:
      This object

    • getEnum

      public List<Object> getEnum()
      Bean property getter: enum.
      Returns:
      The property value, or null if it is not set.

    • setEnum

      public SchemaInfo setEnum(Collection<Object> value)
      Bean property setter: enum.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • addEnum

      public SchemaInfo addEnum(Object... values)
      Adds one or more values to the enum property.
      Parameters:
      values - The values to add to this property.
      Valid types:
      • Object
      • Collection<Object>
      • String - JSON array representation of Collection<Object>
        Example:

        _enum("['foo','bar']");

      • String - Individual values
        Example:

        _enum("foo", "bar");


      Ignored if null.
      Returns:
      This object

    • getType

      public String getType()
      Bean property getter: type.
      Returns:
      The property value, or null if it is not set.

    • setType

      public SchemaInfo setType(String value)
      Bean property setter: type.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Possible values include:
      • "object"
      • "string"
      • "number"
      • "integer"
      • "boolean"
      • "array"
      • "file"
      Returns:
      This object

    • getItems

      public Items getItems()
      Bean property getter: items.
      Returns:
      The property value, or null if it is not set.

    • setItems

      public SchemaInfo setItems(Items value)
      Bean property setter: items.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getAllOf

      public List<Object> getAllOf()
      Bean property getter: allOf.
      Returns:
      The property value, or null if it is not set.

    • setAllOf

      public SchemaInfo setAllOf(Collection<Object> value)
      Bean property setter: allOf.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • addAllOf

      public SchemaInfo addAllOf(Object... values)
      Adds one or more values to the allOf property.
      Parameters:
      values - The values to add to this property.
      Valid types:
      • Object
      • Collection<Object>
      • String - JSON array representation of Collection<Object>
        Example:

        allOf("['foo','bar']");

      • String - Individual values
        Example:

        allOf("foo", "bar");


      Ignored if null.
      Returns:
      This object

    • getAnyOf

      public List<Object> getAnyOf()
      Bean property getter: allOf.
      Returns:
      The property value, or null if it is not set.

    • setAnyOf

      public SchemaInfo setAnyOf(Collection<Object> value)
      Bean property setter: allOf.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • addAnyOf

      public SchemaInfo addAnyOf(Object... values)
      Adds one or more values to the allOf property.
      Parameters:
      values - The values to add to this property.
      Valid types:
      • Object
      • Collection<Object>
      • String - JSON array representation of Collection<Object>
        Example:

        allOf("['foo','bar']");

      • String - Individual values
        Example:

        allOf("foo", "bar");


      Ignored if null.
      Returns:
      This object

    • getOneOf

      public List<Object> getOneOf()
      Bean property getter: allOf.
      Returns:
      The property value, or null if it is not set.

    • setOneOf

      public SchemaInfo setOneOf(Collection<Object> value)
      Bean property setter: allOf.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • addOneOf

      public SchemaInfo addOneOf(Object... values)
      Adds one or more values to the allOf property.
      Parameters:
      values - The values to add to this property.
      Valid types:
      • Object
      • Collection<Object>
      • String - JSON array representation of Collection<Object>
        Example:

        allOf("['foo','bar']");

      • String - Individual values
        Example:

        allOf("foo", "bar");


      Ignored if null.
      Returns:
      This object

    • getProperties

      public Map<String,SchemaInfo> getProperties()
      Bean property getter: properties.
      Returns:
      The property value, or null if it is not set.

    • setProperties

      public SchemaInfo setProperties(Map<String,SchemaInfo> value)
      Bean property setter: properties.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getAdditionalProperties

      public SchemaInfo getAdditionalProperties()
      Bean property getter: additionalProperties.
      Returns:
      The property value, or null if it is not set.

    • setAdditionalProperties

      public SchemaInfo setAdditionalProperties(SchemaInfo value)
      Bean property setter: additionalProperties.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getNot

      public SchemaInfo getNot()
      Bean property getter: not.
      Returns:
      The property value, or null if it is not set.

    • setNot

      public SchemaInfo setNot(SchemaInfo value)
      Bean property setter: not.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getDiscriminator

      public Discriminator getDiscriminator()
      Bean property getter: discriminator.
      Returns:
      The property value, or null if it is not set.

    • setDiscriminator

      public SchemaInfo setDiscriminator(Discriminator value)
      Bean property setter: discriminator.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getReadOnly

      public Boolean getReadOnly()
      Bean property getter: readOnly.
      Returns:
      The property value, or null if it is not set.

    • setReadOnly

      public SchemaInfo setReadOnly(Boolean value)
      Bean property setter: readOnly.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getWriteOnly

      public Boolean getWriteOnly()
      Bean property getter: WriteOnly.
      Returns:
      The property value, or null if it is not set.

    • setWriteOnly

      public SchemaInfo setWriteOnly(Boolean value)
      Bean property setter: WriteOnly.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getDeprecated

      public Boolean getDeprecated()
      Bean property getter: deprecated.
      Returns:
      The property value, or null if it is not set.

    • setDeprecated

      public SchemaInfo setDeprecated(Boolean value)
      Bean property setter: deprecated.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getXml

      public Xml getXml()
      Bean property getter: xml.
      Returns:
      The property value, or null if it is not set.

    • setXml

      public SchemaInfo setXml(Xml value)
      Bean property setter: xml.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getExternalDocs

      public ExternalDocumentation getExternalDocs()
      Bean property getter: externalDocs.
      Returns:
      The property value, or null if it is not set.

    • setExternalDocs

      public SchemaInfo setExternalDocs(ExternalDocumentation value)
      Bean property setter: externalDocs.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getExample

      public Object getExample()
      Bean property getter: example.
      Returns:
      The property value, or null if it is not set.

    • setExample

      public SchemaInfo setExample(Object value)
      Bean property setter: example.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • getRef

      @Beanp("$ref") public String getRef()
      Bean property getter: $ref.
      Returns:
      The property value, or null if it is not set.

    • setRef

      @Beanp("$ref") public SchemaInfo setRef(Object value)
      Bean property setter: $ref.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object

    • get

      public <T> T get(String property, Class<T> type)
      Description copied from class: OpenApiElement
      Generic property getter.

      Can be used to retrieve non-standard Swagger fields such as "$ref".

      Overrides:
      get in class OpenApiElement
      Type Parameters:
      T - The datatype to cast the value to.
      Parameters:
      property - The property name to retrieve.
      type - The datatype to cast the value to.
      Returns:
      The property value, or null if the property does not exist or is not set.

    • set

      public SchemaInfo set(String property, Object value)
      Description copied from class: OpenApiElement
      Generic property setter.

      Can be used to set non-standard Swagger fields such as "$ref".

      Overrides:
      set in class OpenApiElement
      Parameters:
      property - The property name to set. Must not be null.
      value - The new value for the property.
      Returns:
      This object

    • keySet

      public Set<String> keySet()
      Description copied from class: OpenApiElement
      Returns all the keys on this element.
      Overrides:
      keySet in class OpenApiElement
      Returns:
      All the keys on this element.
      Never null.

    • resolveRefs

      public SchemaInfo resolveRefs(OpenApi openApi, Deque<String> refStack, int maxDepth)
      Resolves any "$ref" attributes in this element.
      Parameters:
      openApi - The swagger document containing the definitions.
      refStack - Keeps track of previously-visited references so that we don't cause recursive loops.
      maxDepth - The maximum depth to resolve references.
      After that level is reached, $ref references will be left alone.
      Useful if you have very complex models and you don't want your swagger page to be overly-complex.
      Returns:
      This object with references resolved.
      May or may not be the same object.

    • strict

      public SchemaInfo strict()
      Description copied from class: OpenApiElement
      Sets strict mode on this bean.
      Overrides:
      strict in class OpenApiElement
      Returns:
      This object

    • strict

      public SchemaInfo strict(Object value)
      Description copied from class: OpenApiElement
      Sets strict mode on this bean.
      Overrides:
      strict in class OpenApiElement
      Parameters:
      value - The new value for this property.
      Non-boolean values will be converted to boolean using Boolean.valueOf(value.toString()).
      Can be null (interpreted as false).
      Returns:
      This object