describes a single HTTP header More...

#include <Swagger.qm.dox.h>

Inheritance diagram for Swagger::HeaderObject:

Public Member Methods
	constructor (hash< auto > oh, SwaggerSchema swagger)
	Constructor. More...

Public Member Methods inherited from Swagger::ObjectBase
	constructor ()
	Constructor.

	constructor (hash< auto > oh)
	Constructor. More...

	constructor (ObjectBase other)
	copy constructor

	initialize (hash< auto > oh)
	Initialize. More...

Public Member Methods inherited from Swagger::SchemaBase
	constructor (SchemaBase other)
	Copy constructor.

	constructor (string objType, hash< auto > oh)
	Constructor. More...

Public Attributes
*string	collectionFormat
	Determines the format of the array if type array is used. More...

auto	defaultVal
	Declares the value of the header that the server will use if none is provided. More...

*string	desc
	A short description of the header.

*string	format
	The extending format for the previously mentioned `type`. See Data Type Formats for further details.

*SchemaObject	items
	Required if type is `"array"`. Describes the type of items in the array.

string	type
	Required. The type of the object. More...

Public Attributes inherited from Swagger::ObjectBase
hash< auto >	vendorExtensions
	Allows extensions to the Swagger Schema. More...

Public Attributes inherited from Swagger::SchemaBase
hash< string, bool >	enum
	See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.5.1. More...

*bool	exclusiveMax
	See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.2.

*bool	exclusiveMin
	See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.3.

*float	maximum
	See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.2.

*int	maxItems
	See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.2.

*int	maxLength
	See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.1.

*float	minimum
	See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.3.

*int	minItems
	See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.3.

*int	minLength
	See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.2.

*float	multipleOf
	See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.1.1.

*string	pattern
	See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.2.3.

*bool	uniqueItems
	See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-5.3.4.

Static Private Member Methods
static	checkValueType (reference< auto > value, string type, SchemaObject items, string loc)
	validates default values

Static Private Member Methods inherited from Swagger::SchemaBase
static	throwInvalidType (string name, string actual, string expected, auto value)
	throws an `SCHEMA-VALIDATION-ERROR` exception

Additional Inherited Members
Static Public Member Methods inherited from Swagger::SchemaBase
static bool	checkValueType (reference< auto > value, string type)
	Checks the value against the type. More...

Private Member Methods inherited from Swagger::SchemaBase
	check (bool serialize, bool request, string type, string format, SchemaObject items, string path, string method, string name, reference< auto > value)
	validates the value against the schema definition

	checkArrayParam (bool serialize, bool request, SchemaObject items, string path, string method, string name, reference< softlist< auto > > value)
	validates the value against the schema definition

	checkIntern (bool serialize, bool request, string type, *string format, string path, string method, string name, binary v, reference value)
	converts binary values to strings for supported formats

	checkIntern (bool serialize, bool request, string type, *string format, string path, string method, string name, date v, reference value)
	converts strings to/from date/time values for supported formats

	checkIntern (bool serialize, bool request, string type, *string format, string path, string method, string name, string v, reference< auto > value)
	validates string values

auto	getExampleValue (string type, *string format)
	returns an example value for the given type

Detailed Description

describes a single HTTP header

Member Function Documentation

◆ constructor()

Swagger::HeaderObject::constructor	(	hash< auto >	oh,
		SwaggerSchema	swagger
	)

Constructor.

Parameters

oh	deserialized hash from the source schema description describing a single HTTP header
swagger	the REST schema for resolving references

Exceptions

INVALID-FIELD-TYPE	field has invalid type
INVALID-FIELD-VALUE	field has invalid value
REQUIRED-FIELD-MISSING	required field is missing

Member Data Documentation

◆ collectionFormat

*string Swagger::HeaderObject::collectionFormat

Determines the format of the array if type array is used.

Possible values are:

"csv": comma separated values; ex: foo,bar
"ssv": space separated values; ex: foo bar
"tsv": tab separated values; ex: foo\tbar
"pipes": pipe separated values; ex: foo|bar

Default value is "csv".

◆ defaultVal

auto Swagger::HeaderObject::defaultVal

Declares the value of the header that the server will use if none is provided.

(Note: "default" has no meaning for required headers.) See https://tools.ietf.org/html/draft-fge-json-schema-validation-00#section-6.2. Unlike JSON Schema this value MUST conform to the defined type for the header.

◆ type

string Swagger::HeaderObject::type

Required. The type of the object.

The value MUST be one of "string", "number", "integer", "boolean", or "array".

Public Member Methods

Public Attributes

Static Private Member Methods