Enum RequestBody 

pub enum RequestBody {
    Empty,
    Bytes(Bytes),
    Text(String),
    Json(Vec<u8>),
    Form(String),
    Stream {
        stream: RequestBodyStream,
        content_length: Option<u64>,
    },
}

Public request body model.

Streaming variants are non-cloneable and cannot be replayed implicitly. Redirect/retry paths must fail closed when replay would be required instead of cloning a stream into an empty request body. Cloning of in-memory variants remains cheap.

Variants

Empty

Bytes(Bytes)

Text(String)

Json(Vec<u8>)

Form(String)

Stream

Fields

stream: RequestBodyStream

content_length: Option<u64>

Implementations

impl RequestBody

pub fn empty() -> Self

pub fn is_empty(&self) -> bool

pub fn is_streaming(&self) -> bool

true when the body is a non-materialized streaming producer.

pub fn content_length(&self) -> Option<u64>

Advertised Content-Length for sized streams (and trivially the in-memory length for materialized variants).

pub fn into_bytes(self) -> Result<Bytes>

Materialize an in-memory body to Bytes. Streaming bodies fail closed with a clear error rather than being silently buffered.

Trait Implementations

impl Clone for RequestBody

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 RequestBody

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

Formats the value using the given formatter.

impl Default for RequestBody

fn default() -> RequestBody

Returns the “default value” for a type.

impl From<&[u8]> for RequestBody

fn from(value: &[u8]) -> Self

Converts to this type from the input type.

impl From<&str> for RequestBody

fn from(value: &str) -> Self

Converts to this type from the input type.

impl From<Bytes> for RequestBody

fn from(value: Bytes) -> Self

Converts to this type from the input type.

impl From<String> for RequestBody

fn from(value: String) -> Self

Converts to this type from the input type.

impl From<Vec<u8>> for RequestBody

fn from(value: Vec<u8>) -> Self

Converts to this type from the input type.