Struct ReadObjectResponse 

pub struct ReadObjectResponse { /* private fields */ }

The result of a ReadObject request.

Objects can be large, and must be returned as a stream of bytes. This struct also provides an accessor to retrieve the object’s metadata.

Implementations

impl ReadObjectResponse

pub fn from_source<T, S>(object: ObjectHighlights, source: T) -> Self

where T: Into<Payload<S>> + Send + Sync + 'static, S: StreamingSource + Send + Sync + 'static,

Create a ReadObjectResponse, given a data source.

Use this method to mock the return type of Storage::read_object.

Example

let object = ObjectHighlights::default();
let response = ReadObjectResponse::from_source(object, "payload");

pub fn object(&self) -> ObjectHighlights

Get the highlights of the object metadata included in the response.

To get full metadata about this object, use crate::client::StorageControl::get_object.

Example

let object = client
    .read_object("projects/_/buckets/my-bucket", "my-object")
    .send()
    .await?
    .object();
println!("object generation={}", object.generation);
println!("object metageneration={}", object.metageneration);
println!("object size={}", object.size);
println!("object content encoding={}", object.content_encoding);

pub async fn next(&mut self) -> Option<Result<Bytes>>

Stream the next bytes of the object.

When the response has been exhausted, this will return None.

Example

let mut resp = client
    .read_object("projects/_/buckets/my-bucket", "my-object")
    .send()
    .await?;
while let Some(next) = resp.next().await {
    println!("next={:?}", next?);
}

Trait Implementations

impl Debug for ReadObjectResponse

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

Formats the value using the given formatter.