pub struct NeededBlobsProxy { /* private fields */ }

Implementations§

source§

impl NeededBlobsProxy

source

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.pkg/NeededBlobs.

source

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.

source

pub fn open_meta_blob( &self, blob_type: BlobType ) -> QueryResponseFut<NeededBlobsOpenMetaBlobResult>

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.

  • request blob_type the type of the blob to be written. Will be removed once the transition to offline compression is complete.
  • 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.
source

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.
source

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

Opens a blob for writing.

  • request blob_id the blob id describing this blob.
  • request blob_type the type of the blob to be written. Will be removed once the transition to offline compression is complete.
  • 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.
source

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

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.
source

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

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§

source§

impl Clone for NeededBlobsProxy

source§

fn clone(&self) -> NeededBlobsProxy

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from source. Read more
source§

impl Debug for NeededBlobsProxy

source§

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

Formats the value using the given formatter. Read more
source§

impl NeededBlobsProxyInterface for NeededBlobsProxy

§

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

source§

fn open_meta_blob(&self, blob_type: BlobType) -> Self::OpenMetaBlobResponseFut

source§

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

§

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

source§

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

§

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

source§

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

§

type AbortResponseFut = QueryResponseFut<()>

source§

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

source§

impl Proxy for NeededBlobsProxy

§

type Protocol = NeededBlobsMarker

The protocol which this Proxy controls.
source§

fn from_channel(inner: AsyncChannel) -> Self

Create a proxy over the given channel.
source§

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

Attempt to convert the proxy back into a channel. Read more
source§

fn as_channel(&self) -> &AsyncChannel

Get a reference to the proxy’s underlying channel. Read more
§

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

Attempt to convert the proxy back into a client end. Read more
§

fn is_closed(&self) -> bool

Returns true if the proxy has received the PEER_CLOSED signal.
§

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

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

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
§

impl<T> Encode<Ambiguous1> for T

§

unsafe fn encode( self, _encoder: &mut Encoder<'_>, _offset: usize, _depth: Depth ) -> Result<(), Error>

Encodes the object into the encoder’s buffers. Any handles stored in the object are swapped for Handle::INVALID. Read more
§

impl<T> Encode<Ambiguous2> for T

§

unsafe fn encode( self, _encoder: &mut Encoder<'_>, _offset: usize, _depth: Depth ) -> Result<(), Error>

Encodes the object into the encoder’s buffers. Any handles stored in the object are swapped for Handle::INVALID. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

§

impl<T> Instrument for T

§

fn instrument(self, span: Span) -> Instrumented<Self>

Instruments this type with the provided [Span], returning an Instrumented wrapper. Read more
§

fn in_current_span(self) -> Instrumented<Self>

Instruments this type with the current Span, returning an Instrumented wrapper. Read more
source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

§

impl<T> Pointable for T

§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
source§

impl<T> ToOwned for T
where T: Clone,

§

type Owned = T

The resulting type after obtaining ownership.
source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<T> WithSubscriber for T

§

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self>
where S: Into<Dispatch>,

Attaches the provided Subscriber to this type, returning a [WithDispatch] wrapper. Read more
§

fn with_current_subscriber(self) -> WithDispatch<Self>

Attaches the current default Subscriber to this type, returning a [WithDispatch] wrapper. Read more