Home  > 

Class messaging-handler

The primary messaging event handler. It allows users to intercept and change Proton behaviors.

Related: Method container.constructor

Implementations: C, C++, Java, Python

Common-case application events

MethodSummaryInputsOutputs
on-container-start The container event loop is startedcontainer
on-container-stop The container event loop is stoppedcontainer
on-message A message is receiveddelivery, message
on-sendable A message can be sentsender

Endpoint lifecycle

MethodSummaryInputsOutputs
on-connection-open The remote peer opened the connectionconnection
on-connection-close The remote peer closed the connectionconnection
on-connection-error The remote peer closed the connection with an error conditionconnection
on-session-open The remote peer opened the sessionsession
on-session-close The remote peer closed the sessionsession
on-session-error The remote peer closed the session with an error conditionsession
on-sender-open The remote peer opened the sendersender
on-sender-detach The remote peer detached the sendersender
on-sender-close The remote peer closed the sendersender
on-sender-error The remote peer closed the sender with an error conditionsender
on-receiver-open The remote peer opened the receiverreceiver
on-receiver-detach The remote peer detached the receiverreceiver
on-receiver-close The remote peer closed the receiverreceiver
on-receiver-error The remote peer closed the receiver with an error conditionreceiver

Deliveries

Delivery states represent the current status or final outcome of a message transfer. Settlement state determines when a peer can safely consider the transfer resolved.

AMQP: Conceptual overview

MethodSummaryInputsOutputs
on-tracker-accept The receiving end accepted a deliverytracker
on-tracker-reject The receiving end rejected a deliverytracker
on-tracker-release The receiving end released a deliverytracker
on-tracker-modify The receiving end modified a deliverytracker
on-tracker-settle The receiving end settled a deliverytracker
on-delivery-settle The sending end settled a deliverydelivery

Flow control

Related: Method receiver.drain

MethodSummaryInputsOutputs
on-sender-drain-start The remote end of the sender requested drainingsender
on-receiver-drain-finish The remote end of the receiver completed drainingreceiver

Error handling

MethodSummaryInputsOutputs
on-error The fallback error handlererror-condition

Transport lifecycle

MethodSummaryInputsOutputs
on-transport-open The underlying network channel openedtransport
on-transport-close The underlying network channel closedtransport
on-transport-error The underlying network channel closed with an error conditiontransport