Struct stam::AnnotationBuilder

pub struct AnnotationBuilder<'a> { /* private fields */ }

This is the builder that builds Annotation. The actual building is done by passing this structure to AnnotationStore::annotate(), there is no build() method for this builder.

Implementations

impl<'a> AnnotationBuilder<'a>

pub fn new() -> Self

pub fn with_id(self, id: String) -> Self

pub fn with_selector(self, selector: Selector) -> Self

Sets the annotation target using an already existing selector Use [Self.with_target()] or one of the target_ shortcut methods instead if you still need to build the target selector

pub fn with_target(self, selector: SelectorBuilder<'a>) -> Self

Set the target to be a crate::resources::TextResource. Creates a Selector::ResourceSelector Sets the annotation target. Instantiates a new selector. Use [Self.with_target()] instead if you already have a selector. Under the hood, this will invoke select() to obtain a selector.

pub fn with_data( self, annotationset: Item<'a, AnnotationDataSet>, key: Item<'a, DataKey>, value: DataValue ) -> Self

Associate data with the annotation. If you provide a public key ID that does not exist yet, it’s crate::DataKey will be created.

You may use this (and similar methods) multiple times. Do note that multiple data associated with the same annotation is considered inter-dependent, use multiple annotations instead if each it interpretable independent of the others.

pub fn with_data_with_id( self, dataset: Item<'a, AnnotationDataSet>, key: Item<'a, DataKey>, value: DataValue, id: Item<'a, AnnotationData> ) -> Self

Use this method instead of Self::with_data() if you want to assign a public identifier (last argument)

pub fn with_data_by_id( self, dataset: Item<'a, AnnotationDataSet>, id: Item<'a, AnnotationData> ) -> Self

This references existing AnnotationData, in a particular [`AnnotationDataSet’], by Id. Useful if you have an Id or reference instance already.

pub fn with_data_builder(self, builder: AnnotationDataBuilder<'a>) -> Self

Lower level method if you want to create and pass [`AnnotationDataBuilder’] yourself rather than use the other with_data_*() shortcut methods.

pub fn from_json_file( filename: &str, config: &Config ) -> Result<Self, StamError>

Reads a single annotation in STAM JSON from file

pub fn from_json_str(string: &str) -> Result<Self, StamError>

Reads a single annotation in STAM JSON from string

Trait Implementations

impl<'a> Debug for AnnotationBuilder<'a>

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

Formats the value using the given formatter.

impl<'a> Default for AnnotationBuilder<'a>

fn default() -> Self

Returns the “default value” for a type.

impl<'de, 'a> Deserialize<'de> for AnnotationBuilder<'a>

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.