pub struct MultipartUpload<'a> { /* private fields */ }Expand description
Chunked multipart upload simulation.
Mimics the semantics of S3/GCS multipart uploads:
- Create an upload session via
MultipartUpload::new(store, key). - Upload parts with
upload_part(part_number, data). - Finalise with
complete()which concatenates parts and stores the object.
Parts may be uploaded in any order; they are sorted by part number on complete.
Any part number ≥ 1 is valid.
Implementations§
Source§impl<'a> MultipartUpload<'a>
impl<'a> MultipartUpload<'a>
Sourcepub fn new(store: &'a dyn ObjectStore, key: ObjectKey) -> Self
pub fn new(store: &'a dyn ObjectStore, key: ObjectKey) -> Self
Create a new multipart upload session.
Sourcepub fn with_min_part_size(self, size: usize) -> Self
pub fn with_min_part_size(self, size: usize) -> Self
Set the minimum part size advisory (default: 5 MiB). Parts smaller than this will be accepted but a warning can be emitted.
Sourcepub fn upload_part(&mut self, part_number: u16, data: Vec<u8>) -> Result<()>
pub fn upload_part(&mut self, part_number: u16, data: Vec<u8>) -> Result<()>
Upload a single part.
Part numbers must be in [1, 10_000].
Parts are buffered in memory until complete() is called.
Sourcepub fn part_count(&self) -> usize
pub fn part_count(&self) -> usize
Return the number of parts currently uploaded.
Sourcepub fn total_bytes(&self) -> usize
pub fn total_bytes(&self) -> usize
Return the total bytes buffered so far.
Sourcepub fn complete(self) -> Result<UploadResult>
pub fn complete(self) -> Result<UploadResult>
Finalise the upload: sort parts by part number, concatenate, and store.
Consumes self.
Auto Trait Implementations§
impl<'a> !RefUnwindSafe for MultipartUpload<'a>
impl<'a> !UnwindSafe for MultipartUpload<'a>
impl<'a> Freeze for MultipartUpload<'a>
impl<'a> Send for MultipartUpload<'a>
impl<'a> Sync for MultipartUpload<'a>
impl<'a> Unpin for MultipartUpload<'a>
impl<'a> UnsafeUnpin for MultipartUpload<'a>
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
Source§impl<T> Instrument for T
impl<T> Instrument for T
Source§fn instrument(self, span: Span) -> Instrumented<Self>
fn instrument(self, span: Span) -> Instrumented<Self>
Source§fn in_current_span(self) -> Instrumented<Self>
fn in_current_span(self) -> Instrumented<Self>
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§impl<T> IntoRequest<T> for T
impl<T> IntoRequest<T> for T
Source§fn into_request(self) -> Request<T>
fn into_request(self) -> Request<T>
Wrap the input message
T in a tonic::RequestSource§impl<T> Pointable for T
impl<T> Pointable for T
Source§impl<T> PolicyExt for Twhere
T: ?Sized,
impl<T> PolicyExt for Twhere
T: ?Sized,
impl<T> Read<Exclusive, BecauseExclusive> for Twhere
T: ?Sized,
Source§impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
Source§fn to_subset(&self) -> Option<SS>
fn to_subset(&self) -> Option<SS>
The inverse inclusion map: attempts to construct
self from the equivalent element of its
superset. Read moreSource§fn is_in_subset(&self) -> bool
fn is_in_subset(&self) -> bool
Checks if
self is actually part of its subset T (and can be converted to it).Source§fn to_subset_unchecked(&self) -> SS
fn to_subset_unchecked(&self) -> SS
Use with care! Same as
self.to_subset but without any property checks. Always succeeds.Source§fn from_subset(element: &SS) -> SP
fn from_subset(element: &SS) -> SP
The inclusion map: converts
self to the equivalent element of its superset.