Struct AnnotationControllerSynchronousProxy

pub struct AnnotationControllerSynchronousProxy { /* private fields */ }

Implementations

impl AnnotationControllerSynchronousProxy

pub fn new(channel: Channel) -> Self

pub fn into_channel(self) -> Channel

pub fn wait_for_event( &self, deadline: MonotonicInstant, ) -> Result<AnnotationControllerEvent, 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 update_annotations( &self, annotations_to_set: Vec<Annotation>, annotations_to_delete: &[AnnotationKey], ___deadline: MonotonicInstant, ) -> Result<AnnotationControllerUpdateAnnotationsResult, Error>

Adds, updates, and removes annotations.

The server is expected to adhere to the following conventions:

• If a key in annotations_to_set is new, a new annotation is added
• If a key in annotations_to_set already exists, the annotation value is updated
• If a key in annotations_to_delete does not exist, it is ignored

The same key cannot appear twice in a call to UpdateAnnotations(). In other words, to set two Annotations with matching keys is illegal, as is an attempt to set an Annotation and also delete it.

If the operation results in an error, the annotations remain unchanged, and will not be partially updated.

• error UpdateAnnotationsError.INVALID_ARGS if the same key exists in both annotations_to_set and annotations_to_delete.
• error UpdateAnnotationsError.INVALID_ARGS if a key in annotations_to_set or annotations_to_delete has an empty namespace.
• error UpdateAnnotationsError.INVALID_ARGS if an AnnotationValue.buffer in annotations_to_set could not be read.
• error UpdateAnnotationsError.TOO_MANY_ANNOTATIONS if the operation results in more than MAX_ANNOTATIONS_PER_ELEMENT annotations existing.

pub fn get_annotations( &self, ___deadline: MonotonicInstant, ) -> Result<AnnotationControllerGetAnnotationsResult, Error>

Returns the current Annotations for the element.

• error GetAnnotationsError if the annotations could not be returned.

pub fn watch_annotations( &self, ___deadline: MonotonicInstant, ) -> Result<AnnotationControllerWatchAnnotationsResult, Error>

Returns the full set of Annotations when one or more of them have changed, or when this method is called by the client for the first time.

This operation does not block other requests from the client, but only one WatchAnnotations request at a time can be made on a connection. If the client makes a second WatchAnnotations request before waiting for the previous request to complete, the connection will be closed.

• error WatchAnnotationsError if the annotations could not be returned.

Trait Implementations

impl Debug for AnnotationControllerSynchronousProxy

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

Formats the value using the given formatter.

impl SynchronousProxy for AnnotationControllerSynchronousProxy

type Proxy = AnnotationControllerProxy

The async proxy for the same protocol.

type Protocol = AnnotationControllerMarker

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.