Struct WireLimits

Source

pub struct WireLimits { /* private fields */ }

Expand description

Shared limits applied to one complete wire decode.

Implementations§

Source §

impl WireLimits

Source

pub const DEFAULT_MAX_INPUT_BYTES: usize = 1_048_576

Default maximum complete JSON input length.

Source

pub const DEFAULT_MAX_DEPTH: usize = 64

Default maximum recursive wire depth.

Source

pub const DEFAULT_MAX_NODES: usize = 100_000

Default maximum decoded node count.

Source

pub const DEFAULT_MAX_COLLECTION_ITEMS: usize = 4_096

Default maximum elements in one collection.

Source

pub const DEFAULT_MAX_MAP_ENTRIES: usize = 4_096

Default maximum entries in one map.

Source

pub const DEFAULT_MAX_STRING_BYTES: usize

Default maximum bytes in one decoded string.

Source

pub const DEFAULT_MAX_NUMERIC_BYTES: usize = 4_096

Default maximum UTF-8 bytes in one decoded numeric representation.

Source

pub const fn new(max_input_bytes: usize) -> Self

Creates shared wire limits with the specified input-byte bound.

Source

pub const fn with_max_depth(self, max_depth: usize) -> Self

Sets the maximum recursive wire depth.

Source

pub const fn with_max_nodes(self, max_nodes: usize) -> Self

Sets the maximum decoded node count.

Source

pub const fn with_max_collection_items( self, max_collection_items: usize, ) -> Self

Sets the maximum elements in one collection.

Source

pub const fn with_max_map_entries(self, max_map_entries: usize) -> Self

Sets the maximum entries in one map.

Source

pub const fn with_max_string_bytes(self, max_string_bytes: usize) -> Self

Sets the maximum bytes in one decoded string.

Source

pub const fn with_max_numeric_bytes(self, max_numeric_bytes: usize) -> Self

Sets the maximum UTF-8 bytes in one decoded numeric representation.

Source

pub const fn max_input_bytes(self) -> usize

Returns the maximum complete input length.

Source

pub const fn max_depth(self) -> usize

Returns the maximum recursive depth.

Source

pub const fn max_nodes(self) -> usize

Returns the maximum decoded node count.

Source

pub const fn max_collection_items(self) -> usize

Returns the maximum elements in one collection.

Source

pub const fn max_map_entries(self) -> usize

Returns the maximum entries in one map.

Source

pub const fn max_string_bytes(self) -> usize

Returns the maximum bytes in one decoded string.

Source

pub const fn max_numeric_bytes(self) -> usize

Returns the maximum UTF-8 bytes in one decoded numeric representation.

Source

pub fn begin( self, input_bytes: usize, ) -> Result<WireBudget, ValueWireDecodeError>

Checks a complete input length and starts a shared accounting session.

Source

pub fn begin_json( self, input: &[u8], ) -> Result<WireBudget, ValueWireDecodeError>

Preflights one complete JSON document before decoding its runtime representation, then starts a semantic accounting session.

The preflight validates complete-input size and JSON syntax while traversing the document without materializing a JSON tree. Runtime resource limits are charged by the returned budget after decoding so embedded protocol wrappers do not consume value-node or depth headroom.

§Errors

Returns an input-size or JSON syntax error before the caller deserializes its concrete wire DTO. Semantic resource errors are returned by the budget after the DTO has been materialized. Normal decode paths should use Self::begin and let their Serde decoder validate syntax once.

Source