Enum ReassemblyStorage 

pub enum ReassemblyStorage {
    InMemory(Vec<u8>),
    OnDisk {
        file: NamedTempFile,
        len: usize,
    },
}

A handle to reassembly data that may be in memory or on disk.

When in memory, behaves like a Vec<u8>. When spilled, data lives in a temporary file and is read back via mmap on demand. The temp file is auto-deleted when this value is dropped.

Variants

InMemory(Vec<u8>)

Data held in memory.

OnDisk

Data flushed to a memory-mapped temporary file.

Fields

file: NamedTempFile

len: usize

Implementations

impl ReassemblyStorage

pub fn new() -> Self

Create new empty in-memory storage.

pub fn len(&self) -> usize

Current byte length of stored data.

pub fn is_empty(&self) -> bool

Whether storage is empty.

pub fn extend_from_slice(&mut self, data: &[u8])

Append data. Works for both in-memory and on-disk storage.

When in-memory, appends to the Vec. When on-disk, appends to the temporary file and updates the tracked length.

pub fn spill_to_disk(&mut self, spill_dir: Option<&Path>) -> Result<usize>

Spill in-memory data to disk, returning the number of bytes freed.

If already on disk or empty, returns 0.

pub fn read_all(&self) -> Result<Vec<u8>>

Read all data back. Works for both in-memory and on-disk storage.

pub fn as_slice(&self) -> Option<&[u8]>

Get a reference to in-memory data. Returns None if spilled.

pub fn is_spilled(&self) -> bool

Whether data is currently on disk.

pub fn in_memory_bytes(&self) -> usize

Bytes currently held in memory (0 if spilled).

pub fn truncate(&mut self, max_len: usize)

Truncate stored data to at most max_len bytes.

For in-memory storage, truncates the Vec. For on-disk storage, only updates the tracked length (the file is not physically truncated).

pub fn drain(&mut self) -> Result<Vec<u8>>

Drain and return data, resetting to empty. Reads from disk if spilled.

Trait Implementations

impl Debug for ReassemblyStorage

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

Formats the value using the given formatter.

impl Default for ReassemblyStorage

fn default() -> Self

Returns the “default value” for a type.