Enum RedirectRefusal 

#[non_exhaustive]
pub enum RedirectRefusal {
    Credentials,
    Body,
    Payload,
    TooMany,
}

Why a redirect was refused rather than followed.

The rules live with the transport that applies them; this is the half of them a caller can branch on. Each variant renders the clause the error message carries, so refusal.to_string() is what the user is told.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Credentials

The request carries credentials, and the redirect leaves the origin they were addressed to.

The one this crate exists to report. A same-origin redirect is followed instead: the token reaches no host it was not already going to.

Body

The request body cannot be sent a second time.

A redirect is followed by sending the same request to the address it named: same method, same payload. So a body is no reason to refuse one — a bodiless POST, which is most of API v4, goes wherever it is pointed, and a body held in memory goes with it.

A body that is a stream cannot. write_table from an iterator and every raw_command_upload read their body as it is sent, so by the time the 3xx arrives some of it has already gone and there is nothing to rewind. Sending what is left would be a different request; sending nothing is the expensive failure this refuses — a write_table that arrived carrying no rows is answered much like one that succeeded.

Payload

The request carries data, and the redirect leaves the origin it was addressed to.

RedirectRefusal::Credentials asked again about the other thing a caller chooses a host for. A token is not the only thing worth withholding from a host nobody named: a table’s rows are the caller’s own data, and a Location header is the far end of the connection asking for them to be sent somewhere else. So this one does not wait for a token to be present.

A redirect that stays on the origin is followed, body and all — the bytes were already going there. And a body of length zero is not data: Content-Length: 0 gives nothing away, so most of API v4 is unaffected.

TooMany

The redirects did not end.

This client follows a bounded number of same-origin hops; a balancer pointing at itself is a loop, not a route.

Trait Implementations

impl Clone for RedirectRefusal

fn clone(&self) -> RedirectRefusal

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for RedirectRefusal

impl Debug for RedirectRefusal

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

Formats the value using the given formatter.

impl Display for RedirectRefusal

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

Formats the value using the given formatter.

impl Eq for RedirectRefusal

impl Error for RedirectRefusal

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl PartialEq for RedirectRefusal

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for RedirectRefusal