Struct Session 

pub struct Session { /* private fields */ }

Represents a session with Objectstore, tied to a specific Usecase and Scope within it.

Create a Session using Client::session or Scope::session.

Implementations

impl Session

pub fn object_url(&self, object_key: &str) -> Url

Generates a GET url to the object with the given key.

This can then be used by downstream services to fetch the given object. NOTE however that the service does not strictly follow HTTP semantics, in particular in relation to Accept-Encoding.

impl Session

pub fn delete(&self, key: &str) -> DeleteBuilder

Deletes the object with the given key.

impl Session

pub fn get(&self, key: &str) -> GetBuilder

Retrieves the object with the given key.

impl Session

pub fn many(&self) -> ManyBuilder

Creates a ManyBuilder associated with this session.

A ManyBuilder can be used to enqueue multiple operations, which the client can choose to send as batch requests via a dedicated endpoint, minimizing network overhead.

impl Session

pub fn put(&self, body: impl Into<Bytes>) -> PutBuilder

Creates or replaces an object using a [Bytes]-like payload.

pub fn put_stream(&self, body: ClientStream) -> PutBuilder

Creates or replaces an object using a streaming payload.

pub fn put_read<R>(&self, body: R) -> PutBuilder

where R: AsyncRead + Send + Sync + 'static,

Creates or replaces an object using an [AsyncRead] payload.

pub fn put_file(&self, file: File) -> PutBuilder

Creates or replaces an object using the contents of a file.

The file is attempted to be read when the request is sent. It’s therefore possible for the file to be moved or changed in the meantime. If you want to avoid this possibility, use one of the other functions to supply a payload directly instead.

Trait Implementations

impl Clone for Session

fn clone(&self) -> Session

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Session

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

Formats the value using the given formatter.