Struct MultipartConfig 

pub struct MultipartConfig { /* private fields */ }

Available on crate features http and multipart and std only.

Per-field size and part-count constraints for Multipart.

Insert a MultipartConfig as a request extension via a layer to apply project-wide limits, or pass it to Multipart::from_body_with_config for direct programmatic use.

Combining sources is opt-in. When multiple MultipartConfig extensions are inserted on the same request, the extractor reads the most-recently-inserted one — earlier values are not auto-merged. To compose limits across layers (and have the lowest value per field win), call merge_floor explicitly in the inserting middleware before storing the resulting config.

The total payload size is governed by the standard body limit and is not configured here.

Implementations

impl MultipartConfig

pub const DEFAULT_MAX_PARTS: usize = 1000

Default maximum number of parts in a Multipart stream.

pub fn new() -> MultipartConfig

Create a config without per-field byte limits and with the default part limit.

pub fn maybe_with_max_parts(self, max: Option<usize>) -> MultipartConfig

Maximum number of parts accepted in one stream, None for no limit.

Every part counts, whatever its name, content or position. The part past the limit is rejected once its headers are read, before its body.

Defaults to Self::DEFAULT_MAX_PARTS.

pub fn maybe_set_max_parts( &mut self, max: Option<usize>, ) -> &mut MultipartConfig

Maximum number of parts accepted in one stream, None for no limit.

Every part counts, whatever its name, content or position. The part past the limit is rejected once its headers are read, before its body.

Defaults to Self::DEFAULT_MAX_PARTS.

pub fn with_max_parts(self, max: usize) -> MultipartConfig

Maximum number of parts accepted in one stream, None for no limit.

Every part counts, whatever its name, content or position. The part past the limit is rejected once its headers are read, before its body.

Defaults to Self::DEFAULT_MAX_PARTS.

pub fn set_max_parts(&mut self, max: usize) -> &mut MultipartConfig

Maximum number of parts accepted in one stream, None for no limit.

Every part counts, whatever its name, content or position. The part past the limit is rejected once its headers are read, before its body.

Defaults to Self::DEFAULT_MAX_PARTS.

pub fn without_max_parts(self) -> MultipartConfig

Maximum number of parts accepted in one stream, None for no limit.

Every part counts, whatever its name, content or position. The part past the limit is rejected once its headers are read, before its body.

Defaults to Self::DEFAULT_MAX_PARTS.

pub fn unset_max_parts(&mut self) -> &mut MultipartConfig

Maximum number of parts accepted in one stream, None for no limit.

Every part counts, whatever its name, content or position. The part past the limit is rejected once its headers are read, before its body.

Defaults to Self::DEFAULT_MAX_PARTS.

pub fn maybe_with_default_field_limit( self, limit: Option<u64>, ) -> MultipartConfig

Default per-field byte limit applied when no field-specific limit overrides it.

pub fn maybe_set_default_field_limit( &mut self, limit: Option<u64>, ) -> &mut MultipartConfig

Default per-field byte limit applied when no field-specific limit overrides it.

pub fn with_default_field_limit(self, limit: u64) -> MultipartConfig

Default per-field byte limit applied when no field-specific limit overrides it.

pub fn set_default_field_limit(&mut self, limit: u64) -> &mut MultipartConfig

Default per-field byte limit applied when no field-specific limit overrides it.

pub fn without_default_field_limit(self) -> MultipartConfig

Default per-field byte limit applied when no field-specific limit overrides it.

pub fn unset_default_field_limit(&mut self) -> &mut MultipartConfig

Default per-field byte limit applied when no field-specific limit overrides it.

pub fn with_field_limit( self, name: impl Into<Cow<'static, str>>, limit: u64, ) -> MultipartConfig

Set a byte limit for a specific field by name.

pub fn set_field_limit( &mut self, name: impl Into<Cow<'static, str>>, limit: u64, ) -> &mut MultipartConfig

Set a byte limit for a specific field by name.

pub fn merge_floor(&mut self, other: &MultipartConfig)

Merge another configuration into this one using a floor: for every limit set in either source, keep the lower value.

Trait Implementations

impl Clone for MultipartConfig

fn clone(&self) -> MultipartConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for MultipartConfig

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

Formats the value using the given formatter.

impl Default for MultipartConfig

fn default() -> MultipartConfig

Returns the “default value” for a type.

impl Extension for MultipartConfig

impl HttpExtension for MultipartConfig