Struct PackageResolverProxy

pub struct PackageResolverProxy { /* private fields */ }

Implementations

impl PackageResolverProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.pkg/PackageResolver.

pub fn take_event_stream(&self) -> PackageResolverEventStream

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

Panics

Panics if the event stream was already taken.

pub fn resolve( &self, package_url: &str, dir: ServerEnd<DirectoryMarker>, ) -> QueryResponseFut<PackageResolverResolveResult, DefaultFuchsiaResourceDialect>

Populates or updates the cache of a package using an absolute package URL.

Ensures that a package, and any transitive subpackages, are on the local filesystem.

• request package_url the absolute package URL for a package. The following link describes the format: https://fuchsia.dev/fuchsia-src/concepts/packages/package_url. Resource paths are not allowed.
• request dir a request for a directory that will be resolved when the package has been successfully cached.
• returns a resolved_context, which can be passed to ResolveWithContext, with a relative URL, to resolve a subpackage of this package.

• error indicates failure. See ResolveError for values and error scenarios.

pub fn resolve_with_context( &self, package_url: &str, context: &ResolutionContext, dir: ServerEnd<DirectoryMarker>, ) -> QueryResponseFut<PackageResolverResolveWithContextResult, DefaultFuchsiaResourceDialect>

Populates or updates the cache of a package using either an absolute or a relative package URL. If relative, the package will be resolved relative to the supplied context.

Ensures that a package is on the local filesystem.

• request package_url the absolute or relative package URL for a package. If absolute, the context is ignored, and the behavior is identical to calling Resolve(). A relative package_url is a subpackage name.
• request context a ResolutionContext associated with a previously resolved package, for resolving subpackages relative to that package.
• request dir a request for a directory that will be resolved when the package has been successfully cached.
• returns a resolved_context, which can be passed to a subsequent call to ResolveWithContext, with a relative URL, to resolve a subpackage of this package or subpackage.

• error indicates failure. See ResolveError for values and error scenarios.

pub fn get_hash( &self, package_url: &PackageUrl, ) -> QueryResponseFut<PackageResolverGetHashResult, DefaultFuchsiaResourceDialect>

Determines the hash of a package.

• request package_url the package URL for a package.

• response meta_far_blob_id the hash of the package.

• error a zx_status value indicating failure. One of the following:
  • ZX_ERR_INTERNAL if the resolver encountered an otherwise unspecified error while handling the request.
  • ZX_ERR_NOT_FOUND if the package does not exist in the repository specified by package_url.
  • ZX_ERR_BAD_STATE if the resolver does not know about the repository specified by package_url.

Trait Implementations

impl Clone for PackageResolverProxy

fn clone(&self) -> PackageResolverProxy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for PackageResolverProxy

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

Formats the value using the given formatter.

impl PackageResolverProxyInterface for PackageResolverProxy

type ResolveResponseFut = QueryResponseFut<Result<ResolutionContext, ResolveError>>

type ResolveWithContextResponseFut = QueryResponseFut<Result<ResolutionContext, ResolveError>>

type GetHashResponseFut = QueryResponseFut<Result<BlobId, i32>>

fn resolve( &self, package_url: &str, dir: ServerEnd<DirectoryMarker>, ) -> Self::ResolveResponseFut

fn resolve_with_context( &self, package_url: &str, context: &ResolutionContext, dir: ServerEnd<DirectoryMarker>, ) -> Self::ResolveWithContextResponseFut

fn get_hash(&self, package_url: &PackageUrl) -> Self::GetHashResponseFut

impl Proxy for PackageResolverProxy

type Protocol = PackageResolverMarker

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.