Package org.apache.juneau.bean.swagger

Class SchemaInfo

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

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

Swagger 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", "file"
  • 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
  • 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
  • discriminator (string) - Property name for polymorphism (Swagger extension)
  • readOnly (boolean) - Relevant only for Schema properties (Swagger extension)
  • xml (Xml) - XML representation details (Swagger extension)
  • externalDocs (ExternalDocumentation) - Additional external documentation (Swagger extension)
  • example (any) - Example value (Swagger extension)
Example:

// Construct using SwaggerBuilder. SchemaInfo info = schemaInfo() .type("string") .title("foo") // Serialize using JsonSerializer. String json = Json.from(info); // Or just use toString() which does the same as above. json = info.toString();

// Output { "type": "string", "title": "foo" }

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.

    • 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.

    • getAllOf

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

    • setAllOf

      public SchemaInfo setAllOf(Collection<SchemaInfo> 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(SchemaInfo... values)
      Bean property appender: allOf.
      Parameters:
      values - The values to add to this property.
      Ignored if null.
      Returns:
      This object.

    • addAllOf

      public SchemaInfo addAllOf(Collection<SchemaInfo> values)
      Bean property fluent setter: allOf.

      Inline or referenced schema MUST be of a Schema Object and not a standard JSON Schema.

      Parameters:
      values - The values to add to this property.
      Ignored if null.
      Returns:
      This object.

    • setAllOf

      public SchemaInfo setAllOf(SchemaInfo... value)
      Bean property fluent setter: allOf.
      Parameters:
      value - The new value for this property.
      Strings can contains JSON arrays.
      Valid types:
      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.

    • 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.
      GFM syntax can be used for rich text representation.
      Can be null to unset the property.
      Returns:
      This object.

    • getDiscriminator

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

    • setDiscriminator

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

    • getEnum

      public Set<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... value)
      Bean property appender: enum.
      Parameters:
      value - The values to add to this property.
      Ignored if null.
      Returns:
      This object.

    • addEnum

      public SchemaInfo addEnum(Collection<Object> values)
      Bean property fluent setter: enum.

      An enumeration of possible values.

      Parameters:
      values - The values to add to this property.
      Ignored if null.
      Returns:
      This object.

    • setEnum

      public SchemaInfo setEnum(Object... value)
      Bean property fluent setter: enum.
      Parameters:
      value - The new value for this property.
      Strings can be JSON arrays.
      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.

    • 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.

    • 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.

    • 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.

    • 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.

    • 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.

    • 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.

    • 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.

    • 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.

    • 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.

    • 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.

    • 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.

    • 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.

    • 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.

    • 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.

    • 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.
      Parameters:
      value - The new value for this property.
      This string SHOULD be a valid regular expression.
      Can be null to unset the property.
      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.

    • addProperty

      public SchemaInfo addProperty(String key, SchemaInfo value)
      Bean property appender: properties.
      Parameters:
      key - The property key. Must not be null.
      value - The property value. Must not be null.
      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.

    • 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(String value)
      Bean property setter: $ref.
      Parameters:
      value - The new value for this property.
      Can be null to unset the property.
      Returns:
      This object.

    • getRequired

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

    • setRequired

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

    • getRequiredProperties

      public Set<String> getRequiredProperties()
      Bean property getter: requiredProperties.

      The list of required properties.

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

    • setRequiredProperties

      public SchemaInfo setRequiredProperties(Collection<String> value)
      Bean property setter: requiredProperties.

      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.

    • addRequiredProperties

      public SchemaInfo addRequiredProperties(String... value)
      Bean property appender: requiredProperties.

      The list of required properties.

      Parameters:
      value - The values to add to this property.
      Ignored if null.
      Returns:
      This object.

    • addRequiredProperties

      public SchemaInfo addRequiredProperties(Collection<String> values)
      Bean property fluent setter: requiredProperties.

      Takes an array of strings that define the required properties.

      Parameters:
      values - The values to add to this property.
      Ignored if null.
      Returns:
      This object.

    • setRequiredProperties

      public SchemaInfo setRequiredProperties(String... value)
      Bean property fluent setter: requiredProperties.
      Parameters:
      value - The new value for this property.
      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.

    • 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.

    • 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.

    • 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.

    • get

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

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

      Overrides:
      get in class SwaggerElement
      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: SwaggerElement
      Generic property setter.

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

      Overrides:
      set in class SwaggerElement
      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: SwaggerElement
      Returns all the keys on this element.
      Overrides:
      keySet in class SwaggerElement
      Returns:
      All the keys on this element.
      Never null.

    • resolveRefs

      public SchemaInfo resolveRefs(Swagger swagger, Deque<String> refStack, int maxDepth)
      Resolves any "$ref" attributes in this element.
      Parameters:
      swagger - 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()
      Sets strict mode on this bean.
      Overrides:
      strict in class SwaggerElement
      Returns:
      This object.

    • strict

      public SchemaInfo strict(Object value)
      Sets strict mode on this bean.
      Overrides:
      strict in class SwaggerElement
      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.