ObjectBuilder

Struct ObjectBuilder 

Source
pub struct ObjectBuilder { /* private fields */ }
Expand description

Builder for Object with chainable configuration methods to create a new Object.

Implementations§

Source§

impl ObjectBuilder

Source

pub fn new() -> ObjectBuilder

Constructs a new ObjectBuilder.

Source

pub fn build(self) -> Object

Constructs a new Object taking all fields values from this object.

Source§

impl ObjectBuilder

Source

pub fn schema_type<T>(self, schema_type: T) -> ObjectBuilder
where T: Into<SchemaType>,

Add or change type of the object e.g. to change type to string use value SchemaType::Type(Type::String).

Source

pub fn format(self, format: Option<SchemaFormat>) -> ObjectBuilder

Add or change additional format for detailing the schema type.

Source

pub fn property<S, I>(self, property_name: S, component: I) -> ObjectBuilder
where S: Into<String>, I: Into<RefOr<Schema>>,

Add new property to the Object.

Method accepts property name and property component as an arguments.

Source

pub fn additional_properties<I>( self, additional_properties: Option<I>, ) -> ObjectBuilder

Add additional Schema for non specified fields (Useful for typed maps).

Source

pub fn property_names<S>(self, property_name: Option<S>) -> ObjectBuilder
where S: Into<Schema>,

Add additional Schema to describe property names of an object such as a map. See more details https://json-schema.org/draft/2020-12/draft-bhutton-json-schema-01#name-propertynames

Source

pub fn required<I>(self, required_field: I) -> ObjectBuilder
where I: Into<String>,

Add field to the required fields of Object.

Source

pub fn title<I>(self, title: Option<I>) -> ObjectBuilder
where I: Into<String>,

Add or change the title of the Object.

Source

pub fn description<I>(self, description: Option<I>) -> ObjectBuilder
where I: Into<String>,

Add or change description of the property. Markdown syntax is supported.

Source

pub fn default(self, default: Option<Value>) -> ObjectBuilder

Add or change default value for the object which is provided when user has not provided the input in Swagger UI.

Source

pub fn deprecated(self, deprecated: Option<Deprecated>) -> ObjectBuilder

Add or change deprecated status for Object.

Source

pub fn enum_values<I, E>(self, enum_values: Option<I>) -> ObjectBuilder
where I: IntoIterator<Item = E>, E: Into<Value>,

Add or change enum property variants.

Source

pub fn example(self, example: Option<Value>) -> ObjectBuilder

👎Deprecated: Since OpenAPI 3.1 prefer using examples

Add or change example shown in UI of the value for richer documentation.

Deprecated since 3.0.x. Prefer Object::examples instead

Source

pub fn examples<I, V>(self, examples: I) -> ObjectBuilder
where I: IntoIterator<Item = V>, V: Into<Value>,

Add or change examples shown in UI of the value for richer documentation.

Source

pub fn write_only(self, write_only: Option<bool>) -> ObjectBuilder

Add or change write only flag for Object.

Source

pub fn read_only(self, read_only: Option<bool>) -> ObjectBuilder

Add or change read only flag for Object.

Source

pub fn xml(self, xml: Option<Xml>) -> ObjectBuilder

Add or change additional Xml formatting of the Object.

Source

pub fn multiple_of<N>(self, multiple_of: Option<N>) -> ObjectBuilder
where N: Into<Number>,

Set or change multiple_of validation flag for number and integer type values.

Source

pub fn maximum<N>(self, maximum: Option<N>) -> ObjectBuilder
where N: Into<Number>,

Set or change inclusive maximum value for number and integer values.

Source

pub fn minimum<N>(self, minimum: Option<N>) -> ObjectBuilder
where N: Into<Number>,

Set or change inclusive minimum value for number and integer values.

Source

pub fn exclusive_maximum<N>(self, exclusive_maximum: Option<N>) -> ObjectBuilder
where N: Into<Number>,

Set or change exclusive maximum value for number and integer values.

Source

pub fn exclusive_minimum<N>(self, exclusive_minimum: Option<N>) -> ObjectBuilder
where N: Into<Number>,

Set or change exclusive minimum value for number and integer values.

Source

pub fn max_length(self, max_length: Option<usize>) -> ObjectBuilder

Set or change maximum length for string values.

Source

pub fn min_length(self, min_length: Option<usize>) -> ObjectBuilder

Set or change minimum length for string values.

Source

pub fn pattern<I>(self, pattern: Option<I>) -> ObjectBuilder
where I: Into<String>,

Set or change a valid regular expression for string value to match.

Source

pub fn max_properties(self, max_properties: Option<usize>) -> ObjectBuilder

Set or change maximum number of properties the Object can hold.

Source

pub fn min_properties(self, min_properties: Option<usize>) -> ObjectBuilder

Set or change minimum number of properties the Object can hold.

Source

pub fn extensions(self, extensions: Option<Extensions>) -> ObjectBuilder

Add openapi extensions (x-something) for Object.

Source

pub fn content_encoding<S>(self, content_encoding: S) -> ObjectBuilder
where S: Into<String>,

Set of change Object::content_encoding. Typically left empty but could be base64 for example.

Source

pub fn content_media_type<S>(self, content_media_type: S) -> ObjectBuilder
where S: Into<String>,

Set of change Object::content_media_type. Value must be valid MIME type e.g. application/json.

Source

pub fn to_array_builder(self) -> ArrayBuilder

Construct a new ArrayBuilder with this component set to ArrayBuilder::items.

Trait Implementations§

Source§

impl Default for ObjectBuilder

Source§

fn default() -> ObjectBuilder

Returns the “default value” for a type. Read more
Source§

impl From<Object> for ObjectBuilder

Source§

fn from(value: Object) -> ObjectBuilder

Converts to this type from the input type.
Source§

impl From<ObjectBuilder> for AdditionalProperties<Schema>

Source§

fn from(value: ObjectBuilder) -> AdditionalProperties<Schema>

Converts to this type from the input type.
Source§

impl From<ObjectBuilder> for ArrayItems

Source§

fn from(value: ObjectBuilder) -> ArrayItems

Converts to this type from the input type.
Source§

impl From<ObjectBuilder> for Object

Source§

fn from(value: ObjectBuilder) -> Object

Converts to this type from the input type.
Source§

impl From<ObjectBuilder> for RefOr<Schema>

Source§

fn from(builder: ObjectBuilder) -> RefOr<Schema>

Converts to this type from the input type.
Source§

impl From<ObjectBuilder> for Schema

Source§

fn from(builder: ObjectBuilder) -> Schema

Converts to this type from the input type.

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T> Instrument for T

Source§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Source§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Same for T

Source§

type Output = T

Should always be Self
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> WithSubscriber for T

Source§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Source§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more