Struct SharedEntity 

pub struct SharedEntity { /* private fields */ }

One copy of a cached entity: fields shared with every other copy that has the same ones, plus this copy’s _version.

It reads and compares as the whole entity it stands for, _version included: Self::to_value rebuilds that entity, and equality, field access (EntityFields) and indexing see it too. It serializes exactly as that entity does, without rebuilding it.

Implementations

impl SharedEntity

pub fn new(entity: Value) -> Self

Hold entity unshared.

pub fn version(&self) -> Option<&Value>

The entity’s _version, if it has one.

pub fn shares_fields_with(&self, other: &SharedEntity) -> bool

Whether other shares this entity’s fields rather than holding a copy of its own. Sharing says nothing about _version.

pub fn to_value(&self) -> Value

The whole entity, as an owned value.

pub fn into_value(self) -> Value

The whole entity, copying the fields only if another holder shares them.

Trait Implementations

impl Clone for SharedEntity

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for SharedEntity

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for SharedEntity

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

Deserialize this value from the given Serde deserializer.

impl EntityFields for SharedEntity

fn field(&self, name: &str) -> Option<&Value>

The top-level field name, if the entity is an object that has it.

fn whole(&self) -> Cow<'_, Value>

The whole entity. Borrowed whenever it can be.

impl From<SharedEntity> for Value

fn from(entity: SharedEntity) -> Self

Converts to this type from the input type.

impl From<Value> for SharedEntity

fn from(entity: Value) -> Self

Converts to this type from the input type.

impl Index<&str> for SharedEntity

Reads a field the way indexing a Value does: Null when it is absent.

type Output = Value

The returned type after indexing.

fn index(&self, field: &str) -> &Value

Performs the indexing (container[index]) operation.

impl PartialEq for SharedEntity

Equal when the whole entities are: _version and every other field.

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for SharedEntity

Serializes exactly as SharedEntity::to_value would, in any format, without building that value: _version is written where rebuilding the entity would have put it.

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

Serialize this value into the given Serde serializer.