Struct RequestOptions 

pub struct RequestOptions { /* private fields */ }

Extra headers and query parameters for one call, applied after everything the generated code sets.

A generated operation takes them with .options(&options); RequestBuilder::options applies them to a request of your own. One value can be reused for many calls.

• A header replaces every value the request has under the same name: generated headers, authentication and Content-Type included. A name set twice on the options keeps both values (see RequestOptions::headers).
• Query parameters are appended after the generated ones; a name the request already has is sent twice.

use timvw_rust_runtime::RequestOptions;

let options = RequestOptions::new()
    .header("x-request-source", "batch")?
    .query(&[("trace", "1")])?;
assert_eq!(options.header_map()["x-request-source"], "batch");
assert_eq!(options.query_pairs(), [("trace".to_owned(), "1".to_owned())]);

Implementations

impl RequestOptions

pub fn new() -> Self

No extra headers or query parameters.

pub fn header<K, V>(self, name: K, value: V) -> Result<Self, Error>

where HeaderName: TryFrom<K>, <HeaderName as TryFrom<K>>::Error: Into<Error>, HeaderValue: TryFrom<V>, <HeaderValue as TryFrom<V>>::Error: Into<Error>,

Sets a header, replacing a value set before under the same name. Fails, with an error whose is_builder() is true, on an invalid name or value.

pub fn headers(self, headers: HeaderMap) -> Self

Adds every header of a map, replacing the values set before under its names. A name with several values in headers keeps them all, and so does the request they are applied to.

pub fn query<T: Serialize + ?Sized>(self, query: &T) -> Result<Self, Error>

Appends query parameters, serialized as application/x-www-form-urlencoded: a sequence of pairs, a map or a struct, as RequestBuilder::query takes them. Fails, with an error whose is_builder() is true, on a value that is not a flat list of pairs.

pub fn header_map(&self) -> &HeaderMap

The headers.

pub fn query_pairs(&self) -> &[(String, String)]

The query parameters, decoded, in order.

pub fn is_empty(&self) -> bool

Whether there are no headers and no query parameters.

Trait Implementations

impl Clone for RequestOptions

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for RequestOptions

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

Formats the value using the given formatter.

impl Default for RequestOptions

fn default() -> Self

Returns the “default value” for a type.