Struct MessageContext 

pub struct MessageContext {
    pub source_name: Arc<Name>,
    pub destination_name: Option<Arc<Name>>,
    pub payload_type: String,
    pub metadata: HashMap<String, String>,
    pub input_connection: u64,
    pub identity: String,
}

Generic message context for language bindings (UniFFI-compatible)

Provides routing and descriptive metadata needed for replying, auditing, and instrumentation across different language bindings. This type is exported to foreign languages via UniFFI.

Fields

source_name: Arc<Name>

Fully-qualified sender identity

destination_name: Option<Arc<Name>>

Fully-qualified destination identity (may be empty for broadcast/group scenarios)

payload_type: String

Logical/semantic type (defaults to “msg” if unspecified)

metadata: HashMap<String, String>

Arbitrary key/value pairs supplied by the sender (e.g. tracing IDs)

input_connection: u64

Numeric identifier of the inbound connection carrying the message

identity: String

Identity contained in the message

Implementations

impl MessageContext

pub fn new( source: Name, destination: Option<Name>, payload_type: String, metadata: HashMap<String, String>, input_connection: u64, identity: String, ) -> Self

Create a new MessageContext

pub fn source_as_slim_name(&self) -> SlimName

Get the source name as a SlimName (for internal use)

pub fn from_proto_message( msg: ProtoMessage, ) -> Result<(Self, Vec<u8>), SessionError>

Build a MessageContext plus the raw payload bytes from a low-level ProtoMessage. Returns an error if the message type is unsupported (i.e. not a publish payload).

On success:

• The context captures source/destination identities
• payload_type defaults to “msg” if unset
• metadata is copied from the underlying protocol envelope
• The returned Vec<u8> is the raw application payload

Trait Implementations

impl Clone for MessageContext

fn clone(&self) -> MessageContext

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<UT> ConvertError<UT> for MessageContext

fn try_convert_unexpected_callback_error( e: UnexpectedUniFFICallbackError, ) -> Result<Self>

impl Debug for MessageContext

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

Formats the value using the given formatter.

impl<UT> FfiConverter<UT> for MessageContext

const TYPE_ID_META: MetadataBuffer

Type ID metadata, serialized into a MetadataBuffer.

type FfiType = RustBuffer

The low-level type used for passing values of this type over the FFI.

fn lower(v: Self) -> RustBuffer

Lower a rust value of the target type, into an FFI value of type Self::FfiType.

fn try_lift(buf: RustBuffer) -> Result<Self>

Lift a rust value of the target type, from an FFI value of type Self::FfiType.

fn write(obj: Self, buf: &mut Vec<u8>)

Write a rust value into a buffer, to send over the FFI in serialized form.

fn try_read(buf: &mut &[u8]) -> Result<Self>

Read a rust value from a buffer, received over the FFI in serialized form.

impl<UT> Lift<UT> for MessageContext

type FfiType = <MessageContext as FfiConverter<UT>>::FfiType

fn try_lift(v: Self::FfiType) -> Result<Self>

fn try_read(buf: &mut &[u8]) -> Result<Self>

fn try_lift_from_rust_buffer(v: RustBuffer) -> Result<Self, Error>

Convenience method

impl<UT> LiftRef<UT> for MessageContext

type LiftType = MessageContext

impl<UT> LiftReturn<UT> for MessageContext

type ReturnType = <MessageContext as Lift<UT>>::FfiType

FFI return type for trait interfaces

fn try_lift_successful_return(v: Self::ReturnType) -> Result<Self>

Lift a successfully returned value from a trait interface

fn lift_foreign_return( ffi_return: Self::ReturnType, call_status: RustCallStatus, ) -> Self

Lift a foreign returned value from a trait interface

fn lift_error(_buf: RustBuffer) -> Self

Lift a Rust value for a callback interface method error result

fn handle_callback_unexpected_error(e: UnexpectedUniFFICallbackError) -> Self

Lift a Rust value for an unexpected callback interface error

impl<UT> Lower<UT> for MessageContext

type FfiType = <MessageContext as FfiConverter<UT>>::FfiType

fn lower(obj: Self) -> Self::FfiType

fn write(obj: Self, buf: &mut Vec<u8>)

fn lower_into_rust_buffer(obj: Self) -> RustBuffer

Convenience method

impl<UT> LowerError<UT> for MessageContext

fn lower_error(obj: Self) -> RustBuffer

Lower this value for scaffolding function return

impl<UT> LowerReturn<UT> for MessageContext

type ReturnType = <MessageContext as Lower<UT>>::FfiType

The type that should be returned by scaffolding functions for this type.

fn lower_return(v: Self) -> Result<Self::ReturnType, RustCallError>

Lower the return value from an scaffolding call

fn handle_failed_lift( error: LiftArgsError, ) -> Result<Self::ReturnType, RustCallError>

Lower the return value for failed argument lifts

impl PartialEq for MessageContext

fn eq(&self, other: &MessageContext) -> 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<UT> TypeId<UT> for MessageContext

const TYPE_ID_META: MetadataBuffer

impl StructuralPartialEq for MessageContext