Struct DataPayload 

pub struct DataPayload { /* private fields */ }

Payload for a single dataset item.

In-memory payloads can only be constructed through checked constructors so large datasets do not accidentally bypass DatasetLimits.

Implementations

impl DataPayload

pub fn bytes(bytes: Vec<u8>, limits: &DatasetLimits) -> AppResult<Self>

Create a bounded in-memory payload with explicit limits.

pub fn bytes_default(bytes: Vec<u8>) -> AppResult<Self>

Create a bounded in-memory payload using DatasetLimits::default.

pub fn file(path: impl Into<PathBuf>) -> Self

Create a file-backed payload for streaming large data.

pub fn is_bytes(&self) -> bool

Returns true when this payload is memory-backed.

pub fn as_file(&self) -> Option<&Path>

Borrow the file path when this is a file-backed payload.

pub fn len(&self) -> AppResult<u64>

Return the payload size in bytes when it can be determined.

pub fn is_empty(&self) -> AppResult<bool>

Return true when the payload has zero bytes.

pub fn read_bytes_bounded(&self, limits: &DatasetLimits) -> AppResult<Vec<u8>>

Read a payload into memory only if it is within configured bounds.

pub fn write_to_path( &self, path: &Path, limits: &DatasetLimits, ) -> AppResult<u64>

Write the payload to path, streaming file payloads without materializing them.

Trait Implementations

impl Clone for DataPayload

fn clone(&self) -> DataPayload

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for DataPayload

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

Formats the value using the given formatter.