Struct rweb::openapi::Parameter [−][src]
pub struct Parameter { pub name: Cow<'static, str>, pub location: Location, pub description: Cow<'static, str>, pub required: Option<bool>, pub deprecated: Option<bool>, pub style: Option<ParameterStyle>, pub explode: Option<bool>, pub allow_reserved: Option<bool>, pub representation: Option<ParameterRepresentation>, pub example: Option<ParameterExamples>, }
Expand description
Describes a single operation parameter. A unique parameter is defined by a combination of a name and location.
See https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.1.md#parameterObject.
Fields
name: Cow<'static, str>
The name of the parameter. Parameter names are case sensitive.
location: Location
The location of the parameter. Possible values are "query"
, "header"
, "path"
or "cookie"
.
description: Cow<'static, str>
A brief description of the parameter. This could contain examples of use. CommonMark syntax MAY be used for rich text representation.
required: Option<bool>
Determines whether this parameter is mandatory.
If the parameter location is "path"
, this property is REQUIRED and its value MUST be true
.
Otherwise, the property MAY be included and its default value is false
.
deprecated: Option<bool>
Specifies that a parameter is deprecated and SHOULD be transitioned out of usage.
Default value is false
.
style: Option<ParameterStyle>
Describes how the parameter value will be serialized depending on the type of the parameter
value. Default values (based on value of in): for query
- form
; for path
- simple
; for
header
- simple
; for cookie - form
.
explode: Option<bool>
When this is true, parameter values of type array
or object
generate separate parameters for each value of the array or key-value pair of the map.
For other types of parameters this property has no effect.
When [style
] is form
, the default value is true
.
For all other styles, the default value is false
.
allow_reserved: Option<bool>
Determines whether the parameter value SHOULD allow reserved characters, as defined by RFC3986 :/?#[]@!$&'()*+,;=
to be included without percent-encoding.
This property only applies to parameters with an in
value of query
.
The default value is false
.
representation: Option<ParameterRepresentation>
The schema defining the type used for the parameter or a map containing the representations for the parameter.
example: Option<ParameterExamples>
Example(s) of the parameter’s potential value
Trait Implementations
pub fn deserialize<__D>(
__deserializer: __D
) -> Result<Parameter, <__D as Deserializer<'de>>::Error> where
__D: Deserializer<'de>,
pub fn deserialize<__D>(
__deserializer: __D
) -> Result<Parameter, <__D as Deserializer<'de>>::Error> where
__D: Deserializer<'de>,
Deserialize this value from the given Serde deserializer. Read more
pub fn serialize<__S>(
&self,
__serializer: __S
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error> where
__S: Serializer,
pub fn serialize<__S>(
&self,
__serializer: __S
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error> where
__S: Serializer,
Serialize this value into the given Serde serializer. Read more
Auto Trait Implementations
impl RefUnwindSafe for Parameter
impl UnwindSafe for Parameter
Blanket Implementations
Mutably borrows from an owned value. Read more
fn instrument(self, span: Span) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>
impl<T> Future for Instrumented<T> where
T: Future, type Output = <T as Future>::Output;
fn instrument(self, span: Span) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>
impl<T> Future for Instrumented<T> where
T: Future, type Output = <T as Future>::Output;
Instruments this type with the provided Span
, returning an
Instrumented
wrapper. Read more
fn in_current_span(self) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>
impl<T> Future for Instrumented<T> where
T: Future, type Output = <T as Future>::Output;
fn in_current_span(self) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>
impl<T> Future for Instrumented<T> where
T: Future, type Output = <T as Future>::Output;
fn instrument(self, span: Span) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>
impl<T> Future for Instrumented<T> where
T: Future, type Output = <T as Future>::Output;
fn instrument(self, span: Span) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>
impl<T> Future for Instrumented<T> where
T: Future, type Output = <T as Future>::Output;
Instruments this type with the provided Span
, returning an
Instrumented
wrapper. Read more
fn in_current_span(self) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>
impl<T> Future for Instrumented<T> where
T: Future, type Output = <T as Future>::Output;
fn in_current_span(self) -> Instrumented<Self>ⓘNotable traits for Instrumented<T>
impl<T> Future for Instrumented<T> where
T: Future, type Output = <T as Future>::Output;
type Output = T
type Output = T
Should always be Self
pub fn vzip(self) -> V