Interface Schema

    • 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 Default Methods Deprecated 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.
      default Schema additionalProperties​(java.lang.Boolean additionalProperties)
      Deprecated.
      since 1.1, use @link additionalPropertiesBoolean(Boolean) instead
      default Schema additionalProperties​(Schema additionalProperties)
      Deprecated.
      since 1.1, use @link additionalPropertiesSchema(Schema) instead
      default Schema additionalPropertiesBoolean​(java.lang.Boolean additionalProperties)
      Sets the value of "additionalProperties" to either True or False.
      default Schema additionalPropertiesSchema​(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.
      default Schema allOf​(java.util.List<Schema> allOf)
      Sets the schemas used by the allOf property of this Schema.
      default Schema anyOf​(java.util.List<Schema> anyOf)
      Sets the schemas used by the anyOf property of this Schema.
      default Schema defaultValue​(java.lang.Object defaultValue)
      Set the default value property of this Schema instance to the value given.
      default Schema deprecated​(java.lang.Boolean deprecated)
      Sets the deprecated property of this Schema.
      default Schema description​(java.lang.String description)
      Sets the description property of this Schema to the given string.
      default Schema discriminator​(Discriminator discriminator)
      Sets the discriminator property of this Schema instance to the given object.
      default Schema enumeration​(java.util.List<java.lang.Object> enumeration)  
      default Schema example​(java.lang.Object example)
      Sets the example property of this Schema instance.
      default Schema exclusiveMaximum​(java.lang.Boolean exclusiveMaximum)
      Sets the exclusiveMaximum property of this Schema instance to the value given.
      default Schema exclusiveMinimum​(java.lang.Boolean exclusiveMinimum)
      Sets the exclusiveMinimum property of this Schema instance to the value given.
      default Schema externalDocs​(ExternalDocumentation externalDocs)
      Sets the externalDocs property of this Schema to the indicated value.
      default Schema format​(java.lang.String format)
      Sets the format property of this Schema instance to the given string.
      default java.lang.Object getAdditionalProperties()
      Deprecated.
      java.lang.Boolean getAdditionalPropertiesBoolean()
      Returns the value of the "additionalProperties" setting, which indicates whether properties not otherwise defined are allowed.
      Schema getAdditionalPropertiesSchema()
      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.
      default Schema items​(Schema items)
      Set the Schema used for all the elements of an array typed Schema.
      default Schema maximum​(java.math.BigDecimal maximum)
      Sets the maximum property of this Schema instance to the value given.
      default Schema maxItems​(java.lang.Integer maxItems)
      Sets the maxItems property of this Schema instance to the value given.
      default Schema maxLength​(java.lang.Integer maxLength)
      Sets the maxLength property of this Schema instance to the value given.
      default Schema maxProperties​(java.lang.Integer maxProperties)
      Sets the maxProperties property of this Schema instance to the value given.
      default Schema minimum​(java.math.BigDecimal minimum)
      Sets the minimum property of this Schema instance to the value given.
      default Schema minItems​(java.lang.Integer minItems)
      Sets the minItems property of this Schema instance to the value given.
      default Schema minLength​(java.lang.Integer minLength)
      Sets the minLength property of this Schema instance to the value given.
      default Schema minProperties​(java.lang.Integer minProperties)
      Sets the minProperties property of this Schema instance to the value given.
      default Schema multipleOf​(java.math.BigDecimal multipleOf)
      Sets the multipleOf property of this Schema instance to the value given.
      default Schema not​(Schema not)
      Sets the not property to a Schema which describes properties not allowed in objects defined by the current schema.
      default Schema nullable​(java.lang.Boolean nullable)
      Sets the nullable property of this Schema instance.
      default Schema oneOf​(java.util.List<Schema> oneOf)
      Sets the schemas used by the oneOf property of this Schema.
      default Schema pattern​(java.lang.String pattern)
      Sets the pattern property of this Schema instance to the string given.
      default Schema properties​(java.util.Map<java.lang.String,​Schema> properties)
      Sets the properties of this Schema instance to the map provided.
      default Schema readOnly​(java.lang.Boolean readOnly)
      Sets the readOnly property of this Schema.
      void removeAllOf​(Schema allOf)
      Removes the given Schema to the list of schemas used by the allOf property.
      void removeAnyOf​(Schema anyOf)
      Removes the given Schema to the list of schemas used by the anyOf property.
      void removeEnumeration​(java.lang.Object enumeration)
      Removes an item of the appropriate type to the enumerated list of values allowed.
      void removeOneOf​(Schema oneOf)
      Removes the given Schema to the list of schemas used by the oneOf property.
      void removeProperty​(java.lang.String key)
      Removes a Schema property of the provided name using the given schema.
      void removeRequired​(java.lang.String required)
      Removes the name of an item to the list of fields required in objects defined by this Schema.
      default Schema required​(java.util.List<java.lang.String> required)
      Sets the list of fields required in objects defined by this Schema.
      default void setAdditionalProperties​(java.lang.Boolean additionalProperties)
      Deprecated.
      since 1.1, use @link setAdditionalPropertiesBoolean(Boolean) instead
      default void setAdditionalProperties​(Schema additionalProperties)
      Deprecated.
      since 1.1, use @link setAdditionalPropertiesSchema(Schema) instead
      void setAdditionalPropertiesBoolean​(java.lang.Boolean additionalProperties)
      Sets the value of "additionalProperties" to either True or False.
      void setAdditionalPropertiesSchema​(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.
      default Schema title​(java.lang.String title)
      Sets the title property of this Schema instance to the given string.
      default Schema type​(Schema.SchemaType type)
      Sets the type used by this Schema to the string given.
      default Schema uniqueItems​(java.lang.Boolean uniqueItems)
      Sets the uniqueItems property of this Schema instance to the value given.
      default Schema writeOnly​(java.lang.Boolean writeOnly)
      Sets the writeOnly property of this Schema.
      default Schema xml​(XML xml)
      Sets the xml property of this Schema instance.
    • 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

        default 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

        default 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

        default 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

        default 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
      • removeEnumeration

        void removeEnumeration​(java.lang.Object enumeration)
        Removes an item of the appropriate type to the enumerated list of values allowed.
        Parameters:
        enumeration - an object to add to the enumerated values
      • 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

        default 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

        default 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

        default 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

        default 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

        default 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

        default 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

        default 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

        default 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

        default 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

        default 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

        default 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

        default 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

        default 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

        default 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
      • removeRequired

        void removeRequired​(java.lang.String required)
        Removes 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
      • 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 or null for reference schemas
      • type

        default Schema type​(Schema.SchemaType type)
        Sets the type used by this Schema to the string given.
        Parameters:
        type - the type used by this Schema or null 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

        default 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

        default 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 property
        propertySchema - the Schema which describes the properties of the named property. null values will be rejected (implementation will throw an exception) or ignored.
        Returns:
        the current Schema instance
      • removeProperty

        void removeProperty​(java.lang.String key)
        Removes a Schema property of the provided name using the given schema.
        Parameters:
        key - the name of a new Schema property
      • getAdditionalProperties

        @Deprecated
        default java.lang.Object getAdditionalProperties()
        Deprecated.
        Returns the value of the "additionalProperties" setting, which indicates whether properties not otherwise defined are allowed. This setting MUST either be a Boolean or Schema, they can not be set both at the same time.
        • 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:
        a Boolean or a schema
      • getAdditionalPropertiesSchema

        Schema getAdditionalPropertiesSchema()
        Returns the value of the "additionalProperties" setting, which indicates whether properties not otherwise defined are allowed. This setting MUST either be a Boolean or Schema, they can not be set both at the same time.

        This method returns a Schema, for the Boolean getter use getAdditionalPropertiesBoolean()

        • If "additionalProperties" is a Schema, then additional properties are allowed but should conform to the Schema.
        Returns:
        this Schema's additionalProperties property (as Schema)
      • getAdditionalPropertiesBoolean

        java.lang.Boolean getAdditionalPropertiesBoolean()
        Returns the value of the "additionalProperties" setting, which indicates whether properties not otherwise defined are allowed. This setting MUST either be a Boolean or Schema, they can not be set both at the same time.

        This method returns a Boolean, for the Schema getter use getAdditionalPropertiesSchema()

        • 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.
        Returns:
        this Schema's additionalProperties property (as Boolean)
      • setAdditionalProperties

        @Deprecated
        default void setAdditionalProperties​(Schema additionalProperties)
        Deprecated.
        since 1.1, use @link setAdditionalPropertiesSchema(Schema) instead
        Sets the Schema which defines additional properties not defined by "properties" or "patternProperties". See the javadoc for getAdditionalPropertiesSchema() for more details on this setting. Note that this version of the setter is mutually exclusive with the Boolean variants (see setAdditionalPropertiesBoolean(Boolean)).
        Parameters:
        additionalProperties - a Schema which defines additional properties
      • setAdditionalPropertiesSchema

        void setAdditionalPropertiesSchema​(Schema additionalProperties)
        Sets the Schema which defines additional properties not defined by "properties" or "patternProperties". See the javadoc for getAdditionalPropertiesSchema() for more details on this setting. Note that this version of the setter is mutually exclusive with the Boolean variants (see setAdditionalPropertiesBoolean(Boolean)).
        Parameters:
        additionalProperties - a Schema which defines additional properties
      • setAdditionalPropertiesBoolean

        void setAdditionalPropertiesBoolean​(java.lang.Boolean additionalProperties)
        Sets the value of "additionalProperties" to either True or False. See the javadoc for getAdditionalPropertiesBoolean() for more details on this setting. Note that this version of the setter is mutually exclusive with the Schema variants (see setAdditionalPropertiesSchema(Schema)).
        Parameters:
        additionalProperties - a Schema which defines additional properties
      • additionalProperties

        @Deprecated
        default Schema additionalProperties​(Schema additionalProperties)
        Deprecated.
        since 1.1, use @link additionalPropertiesSchema(Schema) instead
        Sets the Schema which defines additional properties not defined by "properties" or "patternProperties". See the javadoc for getAdditionalPropertiesSchema() for more details on this setting. Note that this version of the setter is mutually exclusive with the Boolean variants (see additionalPropertiesBoolean(Boolean)).
        Parameters:
        additionalProperties - a Schema which defines additional properties
        Returns:
        the current Schema instance
      • additionalPropertiesSchema

        default Schema additionalPropertiesSchema​(Schema additionalProperties)
        Sets the Schema which defines additional properties not defined by "properties" or "patternProperties". See the javadoc for getAdditionalPropertiesSchema() for more details on this setting. Note that this version of the setter is mutually exclusive with the Boolean variants (see additionalPropertiesBoolean(Boolean)).
        Parameters:
        additionalProperties - a Schema which defines additional properties
        Returns:
        the current Schema instance
      • additionalProperties

        @Deprecated
        default Schema additionalProperties​(java.lang.Boolean additionalProperties)
        Deprecated.
        since 1.1, use @link additionalPropertiesBoolean(Boolean) instead
        Sets the value of "additionalProperties" to either True or False. See the javadoc for getAdditionalPropertiesBoolean() for more details on this setting. Note that this version of the setter is mutually exclusive with the Schema variants (see additionalPropertiesSchema(Schema)).
        Parameters:
        additionalProperties - a Schema which defines additional properties
        Returns:
        the current Schema instance
      • additionalPropertiesBoolean

        default Schema additionalPropertiesBoolean​(java.lang.Boolean additionalProperties)
        Sets the value of "additionalProperties" to either True or False. See the javadoc for getAdditionalPropertiesBoolean() for more details on this setting. Note that this version of the setter is mutually exclusive with the Schema variants (see additionalPropertiesSchema(Schema)).
        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

        default 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

        default 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

        default 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

        default 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

        default 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

        default 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

        default 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

        default 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

        default 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

        default 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

        default 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
      • removeAllOf

        void removeAllOf​(Schema allOf)
        Removes the given Schema to the list of schemas used by the allOf property.
        Parameters:
        allOf - a Schema to use with the allOf property
      • 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

        default 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
      • removeAnyOf

        void removeAnyOf​(Schema anyOf)
        Removes the given Schema to the list of schemas used by the anyOf property.
        Parameters:
        anyOf - a Schema to use with the anyOf property
      • 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

        default 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
      • addOneOf

        Schema addOneOf​(Schema oneOf)
        Adds the given Schema to the list of schemas used by the oneOf property.
        Parameters:
        oneOf - a Schema to use with the oneOf property
        Returns:
        the current Schema instance
      • removeOneOf

        void removeOneOf​(Schema oneOf)
        Removes the given Schema to the list of schemas used by the oneOf property.
        Parameters:
        oneOf - a Schema to use with the oneOf property