Struct ComponentDataRegisterProxy

pub struct ComponentDataRegisterProxy { /* private fields */ }

Implementations

impl ComponentDataRegisterProxy

pub fn new(channel: AsyncChannel) -> Self

Create a new Proxy for fuchsia.feedback/ComponentDataRegister.

pub fn take_event_stream(&self) -> ComponentDataRegisterEventStream

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

Panics

Panics if the event stream was already taken.

pub fn upsert( &self, data: &ComponentData, ) -> QueryResponseFut<(), DefaultFuchsiaResourceDialect>

Upserts, i.e. updates or inserts, extra component data to be included in feedback reports.

The namespace and each annotation key are used to decide whether to update or insert an annotation. If an annotation is already present for a given key within the same namespace, update the value, otherwise insert the annotation with that key under that namespace.

For instance, assuming these are the data already held by the server (from previous calls to Upsert()):

{
  "bar": { # namespace
    "channel": "stable",
  },
  "foo": { # namespace
    "version": "0.2",
  }
}

then:

Upsert({
  "namespace": "bar",
  "annotations": [
    "version": "1.2.3.45",
    "channel": "beta",
  ]
})

would result in the server now holding:

{
  "bar": { # namespace
    "channel": "beta", # updated
    "version": "1.2.3.45" # inserted
  },
  "foo": { # namespace
    "version": "0.2", # untouched
  }
}

Note that the server will only hold at most MAX_NUM_ANNOTATIONS_PER_NAMESPACE distinct annotation keys per namespace, picking up the latest values.

Trait Implementations

impl Clone for ComponentDataRegisterProxy

fn clone(&self) -> ComponentDataRegisterProxy

Returns a copy of the value.

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

Performs copy-assignment from source.

impl ComponentDataRegisterProxyInterface for ComponentDataRegisterProxy

type UpsertResponseFut = QueryResponseFut<()>

fn upsert(&self, data: &ComponentData) -> Self::UpsertResponseFut

impl Debug for ComponentDataRegisterProxy

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

Formats the value using the given formatter.

impl Proxy for ComponentDataRegisterProxy

type Protocol = ComponentDataRegisterMarker

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.