Struct UploadSession 

pub struct UploadSession { /* private fields */ }

Available on crate feature fs only.

The push-style form for event-driven servers: hand each body chunk to push as reads complete, then finish.

Dropping a session without finish deletes every file it stored. captured_token is available as soon as the token field ends, so the token can be verified while files are still arriving.

Examples

use form_net::{Limits, NoInspector, Policy, Store, UploadSession};

let store = Store::temp()?;
let body = b"--X\r\nContent-Disposition: form-data; name=a\r\n\r\n1\r\n--X--";
let mut session = UploadSession::new(b"multipart/form-data; boundary=X", &Limits::DEFAULT, &Policy::DEFAULT, &store)?;
for chunk in body.chunks(5) {
    session.push(chunk, &mut NoInspector)?;
}
let upload = session.finish(&mut NoInspector)?;
assert_eq!(upload.field("a"), Some("1"));

Implementations

impl UploadSession

pub fn new( content_type: &[u8], limits: &Limits, policy: &Policy, store: &Store, ) -> Result<Self, FormError>

A session for one request body.

Errors

UnsupportedMediaType and the boundary errors of FormKind::detect; InvalidLimits.

pub fn push<I: Inspector>( &mut self, chunk: &[u8], inspector: &mut I, ) -> Result<(), FormError>

Feeds one chunk; consumes all of it or fails.

Errors

Every multipart error, Refused, Io, Store, Limit { Disk }; Poisoned after an error.

pub fn finish<I: Inspector>( self, inspector: &mut I, ) -> Result<Upload, FormError>

Ends the body and returns the upload.

Errors

Syntax { Truncated } if the close delimiter was not seen; as push.

pub fn captured_token(&self) -> Option<&str>

The token field’s value, once its part has ended.

pub fn bytes_seen(&self) -> u64

Body bytes consumed so far.

Trait Implementations

impl Debug for UploadSession

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

Formats the value using the given formatter.