Struct rustic_hal::resource::OneOrMany

pub struct OneOrMany<T> { /* fields omitted */ }

A Simple wrapper around a vector to allow custom serialization when only 1 element is contained.

example

In the example below, the vector serializes to json as an object if it contains only one value, but as an array if more than one.

use rustic_hal::resource::OneOrMany;
use rustic_hal::HalLink;

use serde_json::to_string;
let mut v = OneOrMany::new();
v.push(&HalLink::new("http://test.com"));

assert_eq!(to_string(&v).unwrap(), r#"{"href":"http://test.com"}"#);

v.push(&HalLink::new("http://test2.com"));

assert_eq!(to_string(&v).unwrap(), r#"[{"href":"http://test.com"},{"href":"http://test2.com"}]"#);

Methods

impl<T> OneOrMany<T> where     T: Sized + Clone,

pub fn new() -> OneOrMany<T>

create a new empty object

pub fn force_many(self) -> Self

Force to be serialized as array, even if only one element

pub fn len(&self) -> usize

retrieve the length of the wrapped vector

pub fn is_empty(&self) -> bool

pub fn single(&self) -> Option<&T>

Retrieves a single element if possible.

pub fn many(&self) -> &Vec<T>

Returns an immutable reference to the contained links

pub fn push(&mut self, newval: &T)

Add an element to the wrapped vector.

pub fn with(self, newval: &T) -> Self

Adds an element to the vector in a chainable way

Trait Implementations

impl<T: Clone> Clone for OneOrMany<T>

fn clone(&self) -> OneOrMany<T>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<T: Debug> Debug for OneOrMany<T>

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

Formats the value using the given formatter.

impl<T> Serialize for OneOrMany<T> where     T: Serialize + Clone,

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error> where     S: Serializer,

Serialize this value into the given Serde serializer.

impl<'de, T> Deserialize<'de> for OneOrMany<T> where     T: Deserialize<'d> + Clone,

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

Deserialize this value from the given Serde deserializer.