Struct lotus_script::message::Message

pub struct Message { /* private fields */ }

Represents a message that can be sent between scripts or from the engine.

Example

#[derive(Serialize, Deserialize)]
struct TestMessage {
    value: i32,
}

impl MessageType for TestMessage {
    fn id() -> &'static str {
        "test_message"
    }
}

fn handle(message: &Message) {
    message.handle::<TestMessage>(|m| {
       log::info!("Received message: {}", m.value);
       Ok(())
    }).expect("message handle failed");
}

Implementations

impl Message

pub fn new<T: MessageType>(value: T) -> Self

Creates a new message with the given value.

pub fn id(&self) -> &str

Returns the message type ID.

pub fn value<T: MessageType>(&self) -> Result<T, MessageValueError>

Returns the message value as the given type. Returns a MessageValueError if the message has a different type.

pub fn has_type<T: MessageType>(&self) -> bool

Returns true if the message has the given type.

pub fn handle<T: MessageType>( &self, f: impl FnOnce(T) -> Result<(), Box<dyn Error>> ) -> Result<bool, MessageHandleError>

Handle the message with the given handler function. Returns Ok(true) if the message was handled, Ok(false) if the message has a different type, or Err if the message could not be deserialized or the handler function returned an error. The handler function should return Ok(()) if the message was handled successfully.

pub fn send(&self, _target: MessageTarget)

Sends the message to the given target.