Enum 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

fn clone(&self) -> IdType

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for IdType

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

Formats the value using the given formatter.

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

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 PartialEq for IdType

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for IdType

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 Copy for IdType

impl Eq for IdType

impl StructuralPartialEq for IdType