Struct EngineProxy

pub struct EngineProxy { /* private fields */ }

Implementations

impl EngineProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.pkg.rewrite/Engine.

pub fn take_event_stream(&self) -> EngineEventStream

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

Panics

Panics if the event stream was already taken.

pub fn start_edit_transaction( &self, transaction: ServerEnd<EditTransactionMarker>, ) -> Result<(), Error>

Begins a rule edit transaction.

• request transaction a request for an [EditTransaction].

pub fn list(&self, iterator: ServerEnd<RuleIteratorMarker>) -> Result<(), Error>

Returns an iterator over all rewrite rules.

• request iterator a request for an iterator.

pub fn list_static( &self, iterator: ServerEnd<RuleIteratorMarker>, ) -> Result<(), Error>

Returns an iterator over all static (immutable) rewrite rules. These rules are handled as lower priority than dynamic rules and cannot be modified (although they can be overridden) by [EditTransaction]s.

• request iterator a request for an iterator.

pub fn test_apply( &self, url: &str, ) -> QueryResponseFut<EngineTestApplyResult, DefaultFuchsiaResourceDialect>

Rewrites the given url with the current rewrite rule set, returning the rewritten url. If no rules match or a rule matches but performs an identity transformation, this API returns url unchanged.

This API is intended only for reflecting on rule side effects. Using this API to pre-apply the rules, then passing the result to [fuchsia.pkg/PackageResolver.Resolve] would apply the rules twice.

• request url the url to rewrite.

• response rewritten the rewritten url.

• error a zx_status value indicating failure. One of the following:
  • ZX_ERR_INVALID_ARGS if url is not a valid fuchsia-pkg:// URL. See fuchsia-pkg URL.

Trait Implementations

impl Clone for EngineProxy

fn clone(&self) -> EngineProxy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for EngineProxy

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

Formats the value using the given formatter.

impl EngineProxyInterface for EngineProxy

type TestApplyResponseFut = QueryResponseFut<Result<String, i32>>

fn start_edit_transaction( &self, transaction: ServerEnd<EditTransactionMarker>, ) -> Result<(), Error>

fn list(&self, iterator: ServerEnd<RuleIteratorMarker>) -> Result<(), Error>

fn list_static( &self, iterator: ServerEnd<RuleIteratorMarker>, ) -> Result<(), Error>

fn test_apply(&self, url: &str) -> Self::TestApplyResponseFut

impl Proxy for EngineProxy

type Protocol = EngineMarker

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.