Struct MessageContainer 

pub struct MessageContainer { /* private fields */ }

A reference-counted wrapper around a heap-allocated Message trait object.

Why Arc<Box<dyn Message>>?

broadcast_message and room_broadcast_message send the same logical message to every connected user. With a plain Box<dyn Message> this required one clone_box() call (heap allocation + copy) per user. At 1,262 CCU that is 1,262 allocations per broadcast tick.

Wrapping in Arc makes clone() a single atomic refcount increment regardless of how many users share the message. Each connection still serialises the message independently through its own entity converter — the shared data is immutable (only &self methods called on the send path).

to_boxed_any (receive path only) extracts the inner Box<dyn Message> via Arc::try_unwrap; in the rare case the Arc is still shared it falls back to clone_box(), preserving correctness without unsafe code.

Implementations

impl MessageContainer

pub fn new(message: Box<dyn Message>) -> Self

Wraps message in an Arc so it can be cheaply shared across broadcast targets.

pub fn name(&self) -> String

Returns the protocol name of the contained message type.

pub fn bit_length( &self, message_kinds: &MessageKinds, converter: &mut dyn LocalEntityAndGlobalEntityConverterMut, ) -> u32

Returns the serialized bit length of this message given converter for entity references.

pub fn write( &self, message_kinds: &MessageKinds, writer: &mut dyn BitWrite, converter: &mut dyn LocalEntityAndGlobalEntityConverterMut, )

Writes the message’s kind tag and payload bits into writer.

pub fn is_fragment(&self) -> bool

Returns true if this message is a fragment of a larger logical message.

pub fn is_request_or_response(&self) -> bool

Returns true if this message envelope carries a request or response (not a plain message).

pub fn to_boxed_any(self) -> Box<dyn Any>

Converts this container into a Box<dyn Any> for downcasting to the concrete message type.

pub fn kind(&self) -> MessageKind

Returns the MessageKind identifying the concrete message type inside this container.

pub fn relations_waiting(&self) -> Option<HashSet<RemoteEntity>>

Returns the set of remote entities this message is still waiting on, or None if ready.

pub fn relations_complete( &mut self, converter: &dyn LocalEntityAndGlobalEntityConverter, )

Notifies the inner message that all awaited entity relations have been resolved.

Trait Implementations

impl Clone for MessageContainer

fn clone(&self) -> MessageContainer

Returns a duplicate of the value.

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

Performs copy-assignment from source.