此内容没有您所选择的语言版本。

21.3. Streaming large messages


HornetQ supports setting the body of messages using input and output streams (java.lang.io).
These streams are then used directly for sending (input streams) and receiving (output streams) messages.
When receiving messages there are two ways to deal with the output stream; you may choose to block while the output stream is recovered using the method ClientMessage.saveOutputStream or alternatively using the method ClientMessage.setOutputstream which will asynchronously write the message to the stream. If you choose the latter the consumer must be kept alive until the message has been fully received.
You can use any kind of stream you like. The most common use case is to send files stored on your disk, but you could also send things such as:
  • JDBC Blobs
  • SocketInputStream
  • Things recovered from HTTPRequests, and so on.
Anything that implements java.io.InputStream for sending messages, or java.io.OutputStream for receiving them can be used.

21.3.1. Streaming over Core API

The following table shows a list of methods available at ClientMessage which are also available through JMS by the use of object properties.
Expand
Table 21.1. org.hornetq.api.core.client.ClientMessage API
Name Description JMS Equivalent Property
setBodyInputStream (InputStream) Set the InputStream used to read a message body when sending it. JMS_HQ_InputStream
setOutputStream (OutputStream) Set the OutputStream that will receive the body of a message. This method does not block. JMS_HQ_OutputStream
saveToOutputStream (OutputStream) Save the body of the message to the OutputStream. It will block until the entire content is transferred to the OutputStream. JMS_HQ_SaveStream
To set the output stream when receiving a core message:
...
ClientMessage msg = consumer.receive(...);

// This will block here until the stream was transferred
msg.saveToOutputStream(someOutputStream); 

ClientMessage msg2 = consumer.receive(...);

// This will not wait the transfer to finish
msg.setOutputStream(someOtherOutputStream); 
...
Copy to Clipboard Toggle word wrap
Set the input stream when sending a core message:
...
ClientMessage msg = session.createMessage();
msg.setInputStream(dataInputStream);
...
Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat