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

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

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

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

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

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

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

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

    • copy

      public SchemaInfo copy()
      Make a deep copy of this object.
      Returns:
      A deep copy of 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.

    • getAdditionalProperties

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

    • getAllOf

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

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

    • getDescription

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

    • getDiscriminator

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

    • getEnum

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

    • getExample

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

    • getExclusiveMaximum

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

    • getExclusiveMinimum

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

    • getExternalDocs

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

    • getFormat

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

    • getItems

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

    • getMaximum

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

    • getMaxItems

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

    • getMaxLength

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

    • getMaxProperties

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

    • getMinimum

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

    • getMinItems

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

    • getMinLength

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

    • getMinProperties

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

    • getMultipleOf

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

    • getPattern

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

    • getProperties

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

    • getReadOnly

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

    • getRef

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

    • getRequired

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

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

    • getTitle

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

    • getType

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

    • getUniqueItems

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

    • getXml

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • setRequiredProperties

      public SchemaInfo setRequiredProperties(String... value)
      Bean property fluent setter: requiredProperties.
      Parameters:
      value - The new value for this property.
      Returns:
      This object.

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

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

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

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

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