Struct ContentBuilder

Source
pub struct ContentBuilder<S: State = Empty> { /* private fields */ }
Expand description

Use builder syntax to set the inputs and finish with build().

Implementations§

Source§

impl<S: State> ContentBuilder<S>

Source

pub fn build(self) -> Content
where S: IsComplete,

Finish building and return the requested object

Source

pub fn schema(self, value: impl Into<Schema>) -> ContentBuilder<SetSchema<S>>
where S::Schema: IsUnset,

Optional (Some / Option setters).

Schema used in response body or request body.

Source

pub fn maybe_schema( self, value: Option<impl Into<Schema>>, ) -> ContentBuilder<SetSchema<S>>
where S::Schema: IsUnset,

Optional (Some / Option setters).

Schema used in response body or request body.

Source

pub fn example(self, value: impl Into<Value>) -> ContentBuilder<SetExample<S>>
where S::Example: IsUnset,

Optional (Some / Option setters).

Example for request body or response body.

Source

pub fn maybe_example( self, value: Option<impl Into<Value>>, ) -> ContentBuilder<SetExample<S>>
where S::Example: IsUnset,

Optional (Some / Option setters).

Example for request body or response body.

Source

pub fn examples( self, value: impl Into<IndexMap<String, RefOr<Example>>>, ) -> ContentBuilder<SetExamples<S>>
where S::Examples: IsUnset,

Optional (Some / Option setters). Default: <IndexMap<String, RefOr<Example>> as Default>::default().

Examples of the request body or response body. Content::examples should match to media type and specified schema if present. Content::examples and Content::example are mutually exclusive. If both are defined examples will override value in example.

Source

pub fn maybe_examples( self, value: Option<impl Into<IndexMap<String, RefOr<Example>>>>, ) -> ContentBuilder<SetExamples<S>>
where S::Examples: IsUnset,

Optional (Some / Option setters). Default: <IndexMap<String, RefOr<Example>> as Default>::default().

Examples of the request body or response body. Content::examples should match to media type and specified schema if present. Content::examples and Content::example are mutually exclusive. If both are defined examples will override value in example.

Source

pub fn encoding( self, value: impl Into<IndexMap<String, Encoding>>, ) -> ContentBuilder<SetEncoding<S>>
where S::Encoding: IsUnset,

Optional (Some / Option setters). Default: <IndexMap<String, Encoding> as Default>::default().

A map between a property name and its encoding information.

The key, being the property name, MUST exist in the Content::schema as a property, with schema being a Schema::Object and this object containing the same property key in Object::properties.

The encoding object SHALL only apply to request_body objects when the media type is multipart or application/x-www-form-urlencoded.

Source

pub fn maybe_encoding( self, value: Option<impl Into<IndexMap<String, Encoding>>>, ) -> ContentBuilder<SetEncoding<S>>
where S::Encoding: IsUnset,

Optional (Some / Option setters). Default: <IndexMap<String, Encoding> as Default>::default().

A map between a property name and its encoding information.

The key, being the property name, MUST exist in the Content::schema as a property, with schema being a Schema::Object and this object containing the same property key in Object::properties.

The encoding object SHALL only apply to request_body objects when the media type is multipart or application/x-www-form-urlencoded.

Source

pub fn extensions( self, value: impl Into<Extensions>, ) -> ContentBuilder<SetExtensions<S>>
where S::Extensions: IsUnset,

Optional (Some / Option setters).

Optional extensions “x-something”.

Source

pub fn maybe_extensions( self, value: Option<impl Into<Extensions>>, ) -> ContentBuilder<SetExtensions<S>>
where S::Extensions: IsUnset,

Optional (Some / Option setters).

Optional extensions “x-something”.

Trait Implementations§

Source§

impl<S: IsComplete> From<ContentBuilder<S>> for Content

Source§

fn from(builder: ContentBuilder<S>) -> Self

Converts to this type from the input type.

Auto Trait Implementations§

§

impl<S> Freeze for ContentBuilder<S>

§

impl<S> RefUnwindSafe for ContentBuilder<S>

§

impl<S> Send for ContentBuilder<S>

§

impl<S> Sync for ContentBuilder<S>

§

impl<S> Unpin for ContentBuilder<S>

§

impl<S> UnwindSafe for ContentBuilder<S>

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