Enum libqaul::messages::IdType

pub enum IdType {
    Unique,
    Grouped(Identity),
}

Specify the id type for a message dispatch

Because libqaul doesn’t implement recipient groups it’s up to a service to create useful categorisations for groups of users. This means that a service might send the same message to different users, that are then receiving technically different messages. This can cause all sorts of issues for services because now the database is keeping track of a message many times (for each user it was sent to).

This is what this type aims to circumvent: a message id can be randomised during delivery, or fixed as a group to ensure that a set of messages are all assigned the same Id.

This comes with some caveats: when inserting into the database, the message Id will already exist, and so further messages will not be stored. If you are using the grouped constraint on an unequal message set (meaning that payloads differ), this will result in data loss!

Variants

Unique

A unique message ID will be generated on dispatch

Grouped(Identity)

Create a grouped message ID constraint

Implementations

impl IdType

pub fn consume(self) -> Identity

pub fn group(id: Identity) -> IdType

Create an ID type that is constrained for a group

pub fn create_group() -> IdType

Create a new message group with a random Id

pub fn unique() -> IdType

Create a new message ID for every message dispatched

Trait Implementations

impl Clone for IdType

pub fn clone(&self) -> IdType

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for IdType

impl Debug for IdType

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for IdType

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

Deserialize this value from the given Serde deserializer.

impl Eq for IdType

impl PartialEq<IdType> for IdType

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Serialize for IdType

pub fn serialize<__S>(
    &self,
    __serializer: __S
) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error> where
    __S: Serializer, 

Serialize this value into the given Serde serializer.

impl StructuralEq for IdType

impl StructuralPartialEq for IdType