send_data Method

Publishes a message with a raw data payload.

Syntax

def send_data(destination: str, data: bytes) -> None: ...

Remarks

This method publishes a STOMP message with a raw data payload to the specified Destination. The on_message_out event will fire after the message has been sent.

The STOMP specification does not place any restrictions on Destination names. Instead, each STOMP server is free to define its own requirements for, and/or interpretations of, a Destination name; for example, a server might prohibit certain characters, require a specific format, or interpret some patterns in a special manner. Be sure to consult the documentation for your STOMP server to determine how to build proper Destination names.

In addition to the payload, the outgoing messages will include:

• All user-defined headers held by the Header* properties.
• If the transaction_id property is populated, the transaction Id that it specifies (which associates the message with that transaction).

Note that the STOMP specification defines a number of standard headers necessary for implementing the STOMP protocol. When constructing an outgoing message, the class silently ignores any user-defined headers that are already set by the class.

If request_receipts is enabled when this method is called, the class will request that the server send back a receipt to confirm it has received the message. Refer to request_receipts for more information.

Note that no content type is defined for raw data payload messages; so the content_type property is ignored by this method.

Send String Message Example

stomp1.SendMessage("test/a/b", "Hello, world!");

Send Binary Message Example

byte[] fileContent = File.ReadAllBytes("C:\test\stuff.dat");
stomp1.SendData("test/a/b", fileContent);