Enum ParameterLocation 

pub enum ParameterLocation {
    Path,
    Query,
    Header,
    Body,
}

Where an Operation parameter is carried in the outgoing request.

Every variant has exactly one consumer in crate::http::HttpConnector::execute, which is what makes this enum a routing decision rather than a label: Self::Path is read by substitute_path, Self::Query by build_query, Self::Header by build_headers and Self::Body by build_body. A parameter carrying a location whose consumer does not run is a parameter that is silently dropped, which is the defect Phase 128 CR-02 recorded.

Variants

Path

Substituted into the path template (/users/{id}).

Query

Appended to the query string.

Header

Sent as a request header.

Body

Carried as a field of the JSON request body (Phase 128 CR-02).

Only an operation whose method carries a request body (POST / PUT / PATCH — see crate::config::method_carries_request_body) may place a parameter here; crate::tools::build_operation reads that one predicate for BOTH this assignment and Operation::has_request_body, so a Body-located parameter on a body-less request is not constructible.

No OpenAPI in: value maps here — the spec models a request body as a separate requestBody object, not as a parameter — so this variant is reached only from a curated [[tools]] declaration.

Trait Implementations

impl Clone for ParameterLocation

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ParameterLocation

impl Debug for ParameterLocation

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ParameterLocation

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ParameterLocation

impl PartialEq for ParameterLocation

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for ParameterLocation

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ParameterLocation