Enum AnnotationControllerRequest

pub enum AnnotationControllerRequest {
    UpdateAnnotations {
        annotations_to_set: Vec<Annotation>,
        annotations_to_delete: Vec<AnnotationKey>,
        responder: AnnotationControllerUpdateAnnotationsResponder,
    },
    GetAnnotations {
        responder: AnnotationControllerGetAnnotationsResponder,
    },
    WatchAnnotations {
        responder: AnnotationControllerWatchAnnotationsResponder,
    },
}

An interface to create, read, update, and delete annotations, typically on an element or its view.

Variants

UpdateAnnotations

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.

Fields

annotations_to_set: Vec<Annotation>

annotations_to_delete: Vec<AnnotationKey>

responder: AnnotationControllerUpdateAnnotationsResponder

GetAnnotations

Returns the current Annotations for the element.

• error GetAnnotationsError if the annotations could not be returned.

Fields

responder: AnnotationControllerGetAnnotationsResponder

WatchAnnotations

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.

Fields

responder: AnnotationControllerWatchAnnotationsResponder

Implementations

impl AnnotationControllerRequest

pub fn into_update_annotations( self, ) -> Option<(Vec<Annotation>, Vec<AnnotationKey>, AnnotationControllerUpdateAnnotationsResponder)>

pub fn into_get_annotations( self, ) -> Option<AnnotationControllerGetAnnotationsResponder>

pub fn into_watch_annotations( self, ) -> Option<AnnotationControllerWatchAnnotationsResponder>

pub fn method_name(&self) -> &'static str

Name of the method defined in FIDL

Trait Implementations

impl Debug for AnnotationControllerRequest

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

Formats the value using the given formatter.