Struct TaskMessage 

pub struct TaskMessage {

    pub id: TaskId,
    pub task_name: String,
    pub queue: String,
    pub payload: Value,
    pub state: TaskState,
    pub retries: u32,
    pub max_retries: u32,
    pub created_at: DateTime<Utc>,
    pub updated_at: DateTime<Utc>,
    pub eta: Option<DateTime<Utc>>,
    pub headers: HashMap<String, String>,
    pub parent_id: Option<TaskId>,
    pub correlation_id: Option<String>,
    pub group_id: Option<String>,
    pub group_total: Option<u32>,
    pub chord_callback: Option<Box<TaskMessage>>,
}

A task message that flows through the broker.

Fields

id: TaskId

Unique task identifier.

task_name: String

Registered task name (e.g., “send_email”).

queue: String

Target queue name.

payload: Value

Serialized task payload.

state: TaskState

Current task state.

retries: u32

Current retry count.

max_retries: u32

Maximum allowed retries.

created_at: DateTime<Utc>

When the message was created.

updated_at: DateTime<Utc>

When the message was last updated.

eta: Option<DateTime<Utc>>

Optional ETA — earliest time the task should execute.

headers: HashMap<String, String>

Arbitrary headers for middleware / tracing propagation.

parent_id: Option<TaskId>

Parent task ID for workflow tracking.

correlation_id: Option<String>

Correlation ID for tracing an entire workflow.

group_id: Option<String>

Group ID this task belongs to.

group_total: Option<u32>

Total number of tasks in the group.

chord_callback: Option<Box<TaskMessage>>

Chord callback to enqueue when all group members complete.

Implementations

impl TaskMessage

pub fn new( task_name: impl Into<String>, queue: impl Into<String>, payload: Value, ) -> TaskMessage

Create a new task message with defaults.

pub fn with_max_retries(self, max_retries: u32) -> TaskMessage

Set max retries.

pub fn with_eta(self, eta: DateTime<Utc>) -> TaskMessage

Set ETA.

pub fn with_header( self, key: impl Into<String>, value: impl Into<String>, ) -> TaskMessage

Add a header.

pub fn with_parent_id(self, parent_id: TaskId) -> TaskMessage

Set parent task ID for workflow tracking.

pub fn with_correlation_id( self, correlation_id: impl Into<String>, ) -> TaskMessage

Set correlation ID for tracing an entire workflow.

pub fn with_group( self, group_id: impl Into<String>, group_total: u32, ) -> TaskMessage

Set group metadata.

pub fn with_chord_callback(self, callback: TaskMessage) -> TaskMessage

Set chord callback.

Trait Implementations

impl Clone for TaskMessage

fn clone(&self) -> TaskMessage

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TaskMessage

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for TaskMessage

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for TaskMessage

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.