Struct RequestOptions

pub struct RequestOptions { /* private fields */ }

A set of options configuring a single request.

Application only use this class directly in mocks, where they may want to verify their application has configured all the right request parameters and options.

All other code uses this type indirectly, via the per-request builders.

Implementations

impl RequestOptions

pub fn set_idempotency(&mut self, value: bool)

Treat the RPC underlying RPC in this method as idempotent.

If a retry policy is configured, the policy may examine the idempotency and the error details to decide if the error is retryable. Typically idempotent RPCs are safe to retry under more error conditions than non-idempotent RPCs.

The client libraries provide a default for RPC idempotency, based on the HTTP method (GET, POST, DELETE, etc.).

pub fn set_default_idempotency(self, default: bool) -> Self

Set the idempotency for the underlying RPC unless it is already set.

If set_idempotency was already called this method has no effect. Otherwise it sets the idempotency. The client libraries use this to provide a default idempotency value.

pub fn set_user_agent<T: Into<String>>(&mut self, v: T)

Prepends this prefix to the user agent header value.

pub fn user_agent(&self) -> &Option<String>

Gets the current user-agent prefix

pub fn set_attempt_timeout<T: Into<Duration>>(&mut self, v: T)

Sets the per-attempt timeout.

When using a retry loop, this affects the timeout for each attempt. The overall timeout for a request is set by the retry policy.

pub fn attempt_timeout(&self) -> &Option<Duration>

Gets the current per-attempt timeout.

pub fn set_retry_policy<V: Into<RetryPolicyArg>>(&mut self, v: V)

Sets the retry policy configuration.

pub fn set_backoff_policy<V: Into<BackoffPolicyArg>>(&mut self, v: V)

Sets the backoff policy configuration.

pub fn set_retry_throttler<V: Into<RetryThrottlerArg>>(&mut self, v: V)

Sets the retry throttling configuration.

pub fn set_polling_policy<V: Into<PollingPolicyArg>>(&mut self, v: V)

Sets the polling policy configuration.

pub fn set_polling_backoff_policy<V: Into<PollingBackoffPolicyArg>>( &mut self, v: V, )

Sets the backoff policy configuration.

Trait Implementations

impl Clone for RequestOptions

fn clone(&self) -> RequestOptions

Returns a copy 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() -> RequestOptions

Returns the “default value” for a type.