Stomp::send
stomp_send
(PECL stomp >= 0.1.0)
Stomp::send -- stomp_send — Sends a message
Description
Object oriented style (method):
Procedural style:
Sends a message to the Message Broker.
Parameters
-
link
-
Procedural style only: The stomp link identifier returned by stomp_connect().
-
destination
-
Where to send the message
-
msg
-
Message to send.
-
headers
-
Associative array containing the additional headers (example: receipt).
Return Values
Returns TRUE
on success or FALSE
on failure.
Notes
Note:
A transaction header may be specified, indicating that the message acknowledgment should be part of the named transaction.
Stomp is inherently asynchronous. Synchronous communication can be implemented adding a receipt header. This will cause methods to not return anything until the server has acknowledged receipt of the message or until read timeout was reached.
Examples
See stomp_ack().
- Функция Stomp::abort() - Отменяет выполнение текущей транзакции
- Функция Stomp::ack() - Подтверждает получение сообщения
- Функция Stomp::begin() - Создает транзакцию
- Функция Stomp::commit() - Выполняет текущую транзакцию
- Функция Stomp::__construct() - Открывает соединение
- Функция Stomp::__destruct() - Закрывает Stomp-соединение
- Функция Stomp::error() - Возвращает последнюю ошибку Stomp
- Функция Stomp::getReadTimeout() - Возвращает время максимального ожидания операции чтения
- Функция Stomp::getSessionId() - Возвращает идентификатор текущей сессии Stomp
- Функция Stomp::hasFrame() - Проверяет, возможно ли чтение фрейма
- Функция Stomp::readFrame() - Выполняет операцию чтения следующего фрейма
- Функция Stomp::send() - Отправляет сообщение
- Функция Stomp::setReadTimeout() - Устанавливает предельное время ожидания операции чтения
- Функция Stomp::subscribe() - Регистрирует подписку на указанную рассылку
- Функция Stomp::unsubscribe() - Удаляет существующую подписку
Коментарии
Without a receipt header your application will fire messages potentially faster than the broker can receive them at. The broker may issue failure notices however STOMP being asynchronous your client won't get to see it.
Without a receipt ActiveMQ (5.5.0) with ProducerFlowControl turned on drops messages (even persistent ones) and my application knows nothing about it (send() returned true). With receipt header specified the STOMP library handles the wait for the receipt acknowledgement for you - you are essentially automatically throttled.