Struct NeededBlobsProxy

pub struct NeededBlobsProxy { /* private fields */ }

Implementations

impl NeededBlobsProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.pkg/NeededBlobs.

pub fn take_event_stream(&self) -> NeededBlobsEventStream

Get a Stream of events from the remote end of the protocol.

Panics

Panics if the event stream was already taken.

pub fn open_meta_blob( &self, ) -> QueryResponseFut<NeededBlobsOpenMetaBlobResult, DefaultFuchsiaResourceDialect>

Opens the package’s metadata blob for writing. GetMissingBlobs() should not be called until writing the meta blob or this request responds with false.

If the package was already cached, server will close the channel with a ZX_OK epitaph.

• response writer is used to write the blob. If writer is absent, the blob is already cached and so does not need to be written.

• error an OpenBlobError indicating failure. Clients may retry this request, though the server end may abort this cache operation on errors it considers to be fatal.

pub fn get_missing_blobs( &self, iterator: ServerEnd<BlobInfoIteratorMarker>, ) -> Result<(), Error>

Returns an iterator of blobs that are not present on the system that must be written using the OpenBlob request before the package will be fully cached.

Client should call OpenMetaBlob, and write it if needed, before calling GetMissingBlobs.

A client should make this request no more than once per NeededBlobs connection. Once all blobs yielded by this iterator are written, the package open request will complete.

New items may be added to the obtained BlobInfoIterator as the client calls OpenBlob, so, to guaranatee termination of the iterator, clients should call OpenBlob concurrently with reading the iterator.

• request iterator a request for an iterator of BlobInfo of blobs that the client should try to write.

pub fn open_blob( &self, blob_id: &BlobId, ) -> QueryResponseFut<NeededBlobsOpenBlobResult, DefaultFuchsiaResourceDialect>

Opens a blob for writing.

• request blob_id the blob id describing this blob.

• response writer is used to write the blob. If writer is absent, the blob is already cached and so does not need to be written.

• error an OpenBlobError indicating failure. Clients may retry this request, though the server end may abort this cache operation on errors it considers to be fatal.

pub fn blob_written( &self, blob_id: &BlobId, ) -> QueryResponseFut<NeededBlobsBlobWrittenResult, DefaultFuchsiaResourceDialect>

Indicates that a blob opened by Open[Meta]Blob has been successfully written.

A client should call this once the blob has been fully written using the writer returned by Open[Meta]Blob.

• request blob_id the blob id describing this blob.

• error a BlobWrittenError indicating failure. Clients may retry the Open[Meta]Blob request that prompted this call, though the server end may abort this cache operation on errors it considers to be fatal.

pub fn abort(&self) -> QueryResponseFut<(), DefaultFuchsiaResourceDialect>

Aborts this caching operation for the package.

Any open blobs and any missing blobs iterator will be closed. Any dir provided to the associated [PackageCache.Get] request will also be closed. Once this request is acknowledged, this channel will be closed.

Note, dropping this NeededBlobs channel without writing all needed blobs will also abort the package cache operation. However, this API provides the ability to wait for the operation to be torn down.

Trait Implementations

impl Clone for NeededBlobsProxy

fn clone(&self) -> NeededBlobsProxy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for NeededBlobsProxy

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

Formats the value using the given formatter.

impl NeededBlobsProxyInterface for NeededBlobsProxy

type OpenMetaBlobResponseFut = QueryResponseFut<Result<Option<Box<BlobWriter>>, OpenBlobError>>

type OpenBlobResponseFut = QueryResponseFut<Result<Option<Box<BlobWriter>>, OpenBlobError>>

type BlobWrittenResponseFut = QueryResponseFut<Result<(), BlobWrittenError>>

type AbortResponseFut = QueryResponseFut<()>

fn open_meta_blob(&self) -> Self::OpenMetaBlobResponseFut

fn get_missing_blobs( &self, iterator: ServerEnd<BlobInfoIteratorMarker>, ) -> Result<(), Error>

fn open_blob(&self, blob_id: &BlobId) -> Self::OpenBlobResponseFut

fn blob_written(&self, blob_id: &BlobId) -> Self::BlobWrittenResponseFut

fn abort(&self) -> Self::AbortResponseFut

impl Proxy for NeededBlobsProxy

type Protocol = NeededBlobsMarker

The protocol which this Proxy controls.

fn from_channel(inner: AsyncChannel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Result<AsyncChannel, Self>

Attempt to convert the proxy back into a channel.

fn as_channel(&self) -> &AsyncChannel

Get a reference to the proxy’s underlying channel.

fn into_client_end(self) -> Result<ClientEnd<Self::Protocol>, Self>

Attempt to convert the proxy back into a client end.

fn is_closed(&self) -> bool

Returns true if the proxy has received the PEER_CLOSED signal.

fn on_closed(&self) -> OnSignals<'_, Unowned<'_, Handle>>

Returns a future that completes when the proxy receives the PEER_CLOSED signal.