Struct PackageResolverSynchronousProxy

pub struct PackageResolverSynchronousProxy { /* private fields */ }

Implementations

impl PackageResolverSynchronousProxy

pub fn new(channel: Channel) -> Self

pub fn into_channel(self) -> Channel

pub fn wait_for_event( &self, deadline: MonotonicInstant, ) -> Result<PackageResolverEvent, Error>

Waits until an event arrives and returns it. It is safe for other threads to make concurrent requests while waiting for an event.

pub fn resolve( &self, package_url: &str, dir: ServerEnd<DirectoryMarker>, ___deadline: MonotonicInstant, ) -> Result<PackageResolverResolveResult, Error>

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>, ___deadline: MonotonicInstant, ) -> Result<PackageResolverResolveWithContextResult, Error>

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, ___deadline: MonotonicInstant, ) -> Result<PackageResolverGetHashResult, Error>

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 Debug for PackageResolverSynchronousProxy

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

Formats the value using the given formatter.

impl SynchronousProxy for PackageResolverSynchronousProxy

type Proxy = PackageResolverProxy

The async proxy for the same protocol.

type Protocol = PackageResolverMarker

The protocol which this Proxy controls.

fn from_channel(inner: Channel) -> Self

Create a proxy over the given channel.

fn into_channel(self) -> Channel

Convert the proxy back into a channel.

fn as_channel(&self) -> &Channel

Get a reference to the proxy’s underlying channel.

fn is_closed(&self) -> Result<bool, Status>

Returns true if the proxy has received the PEER_CLOSED signal.