互操作性
Stomp
Stomp是一个基于文本的协议。使用Stomp协议的
客户端可以与Stomp的代理(broker)进行通迅。
Stomp客户端支持多种语言和平台,因此
它有着很好的互操作性。
内建Stomp支持
HornetQ内建支持Stomp功能。要使用Stomp发送与接收消息,必须配置一个NettyAcceptor,
其中的protocol参数值应设为stomp:
<acceptor name="stomp-acceptor">
<factory-class>org.hornetq.core.remoting.impl.netty.NettyAcceptorFactory</factory-class> <param key="protocol" value="stomp"/>
<param key="port" value="61613"/>
</acceptor>
有了上述的配置,HornetQ就可以在端口61613(这是Stomp代理的默认端口)接受Stomp连接了。
stomp例子展示了如何在HornetQ中配置Stomp。
限制
消息的通知不是事务性的。ACK信号不能作为事务的一部分来传输(如果设置了transaction
属性,它将被忽略)。
Stomp目标与HornetQ的地址和队列的映射
Stomp客户端在消息发送和订阅中使用的是目标(destination)。目标名称是简单的字符串,对应的是服务
器端的目的地。不同服务器对这种映射有着不同的实现。
在HornetQ中这些目标被映射为地址和队列。
当一个Stomp客户端发送一个消息(使用SEND信号)到一个目标时,这个目标被映射到一个地址。
如果一个Stomp客户端订阅(或解除订阅)一个目标时(使用SUBSCRIBE或
UNSUBSCRIBE),这个目标被映射到一个HornetQ的队列。
Stomp与JMS的互操作性
使用JMS目标
正如解释的那样,JMS的目标同样映射到HornetQ的地址与队列。如果你使用
Stomp向JMS的目标发送消息,那么Stomp的目标必须要遵照相同的命名规则:
如果向JMS队列发送数据或订阅它,则队列的名称前缀必须是jms.queue.。
例如,如果向名为orders的JMS队列发送消息,Stomp客户端必须发送以下信息:
SEND
destination:jms.queue.orders
hello queue orders
^@
如果向JMS 话题(topic)发送或订阅消息,话题名称前缀必须是jms.topic.。
例如,如果订阅名为 stocks的JMS话题,Stomp客户端必须发送以下信息:
SUBSCRIBE
destination:jms.topic.stocks
^@
使用JMS或核心接口发送和接收Stomp消息
Stomp基本上是一个基于文本的协议。为了使用更简单,我们的Stomp实现通过检查content-length的值
来决定如何将一个Stomp消息映射成一个JMS消息或核心消息。
如果在Stomp消息中没有content-length头,它将被映射为一个JMS的
TextMessage,或者是一个核心消息,其消息体的缓存是一个SimpleString。
如果Stomp消息中有content-length,则它被映射为一个JMS的
BytesMessage,或者是一个核心消息,其消息体缓存中是一个字节数组byte[]。
从一个JMS消息或核心消息映射为Stomp消息时遵从同样的逻辑。一个Stomp客户端可以通过检查
content-length来决定消息体的类型(字符串或字节)。
通过Web Sockets使用Stomp
HornetQ还支持通过Web Sockets使用Stomp。任何支持
Web Socket的浏览器中可以利用HornetQ来发送和接收Stomp消息。
要使用些功能,必须配置一个NettyAcceptor,并设置protocol
的值为stomp_ws:
<acceptor name="stomp-ws-acceptor">
<factory-class>org.hornetq.core.remoting.impl.netty.NettyAcceptorFactory</factory-class>
<param key="protocol" value="stomp_ws"/>
<param key="port" value="61614"/>
</acceptor>
使用上面配置,HornetQ在URL路径/stomp下端口61614接收Stomp连接。
浏览器然后就可以连接到ws://<server>:61614/stomp,使用Web Socket来发送和接收
Stomp消息了。
为了简化客户端的开发,在GitHub
上提供了一个JavaScript库(参见文档)。
stomp-websockets例子给出一如何配置HornetQ服务器以使浏览器和Java应用程序通过一个JMS话题
进行消息的传递。
StompConnect
StompConnect是一个Stomp代理服务器,
它可以将Stomp协议转换为标准的JMS接口调用。因此,通过StompConnect的作用HornetQ可以作为一个Stomp代理,
与任何一个Stomp客户端通迅。这些客户端可以由C、C++、C#及.net等语言实现。
要运行StompConnect首先要启动HornetQ服务以及JNDI服务。
Stomp需要jndi.properties文件要在classpath中。该文件
应有如下类似的内容:
java.naming.factory.initial=org.jnp.interfaces.NamingContextFactory
java.naming.provider.url=jnp://localhost:1099
java.naming.factory.url.pkgs=org.jboss.naming:org.jnp.interfaces
要确保该文件与StompConnect的jar包以及HornetQ的jar文件都在classpath中。最后,运行
java org.codehaus.stomp.jms.Main。