JBoss Messaging é o novo provider para mensagens JMS da JBoss e veio para substituir seu antecessor JBossMQ. Ele atende a spec 1.1 de JMS, sendo que seu foco está em manter a performance e escalabilidade com alto throughput e latencia baixa.
Podemos utiliza-lo em JBoss 4.2.x ou superior, sendo que é necessário retirar o JBossMQ antes de instala-lo, não há a possibilidade de usar os 2 providers na mesma configuração. O Messaging será o provider default do JBoss AS a partir da versão 5, que atualmente está em Beta3.
O JBoss messaging está atualmente na versão 1.4.0.SP3, sendo que já está sendo utilizado em produção em diversas empresas.
Para utiliza-lo na versão 4.2.x do JBoss, basta seguir os passos abaixo:
- Acesse http://labs.jboss.com/jbossmessaging/downloads/ fazendo download de JBoss Messaging 1.4.0 Service Pack 3 (binary distribution) que é um arquivo .zip (jboss-messaging-1.4.0.SP3.zip).
- Descompacte-o em qualquer lugar.
- Certifique-se que seu JBoss não possui alterações em sua configuração DEFAULT
- Entre no diretório em que vc descompactou o jboss-messaging, entre no diretório util e digite ant -f release-admin.xml.
- Se fez tudo certo até agora, irá aparecer algo como:
[bmachado@bmachado util]$ ant -f release-admin.xml
Buildfile: release-admin.xml
default:
validate-jboss:
prevent-messaging-overwrite:
validate-messaging-artifact:
create-server-config:
[echo] Creating JBoss Messaging configuration 'messaging' for /usr/local/jboss-4.2.0.GA based on configuration 'default' with jboss-messaging.sar
[mkdir] Created dir: /usr/local/jboss-4.2.0.GA/server/messaging
[copy] Copying 320 files to /usr/local/jboss-4.2.0.GA/server/messaging
expand-sar:
[unjar] Expanding: /home/bmachado/Desktop/jboss-messaging-1.4.0.SP3/jboss-messaging.sar into /usr/local/jboss-4.2.0.GA/server/messaging/deploy/jboss-messaging.sar
[copy] Copying 1 file to /usr/local/jboss-4.2.0.GA/server/messaging/lib
[copy] Copying 2 files to /usr/local/jboss-4.2.0.GA/server/messaging/conf/props
[copy] Copying 1 file to /usr/local/jboss-4.2.0.GA/server/messaging/deploy
[copy] Copying 1 file to /usr/local/jboss-4.2.0.GA/server/messaging/deploy
BUILD SUCCESSFUL
Total time: 3 seconds
Com isso seu Messaging já estará instalado da forma mais básica que existe. Ele criará uma nova configuração em server/default chamada messaging. Veja server/default/messaging.
Para testa-lo, suba seu JBoss, entrando no diretório $JBOSS_HOME/bin e executando o comando .
/run.sh -c messaging para startar a nova configuração.
Em seguida, entre no diretório do messaging que foi descompactado, haverá diversos exemplos para teste. Entre no
jboss-messaging-1.4.0.SP3/examples/queue e digite ant.
Se tudo estiver ok, será exibida a seguinte mensagem no seu console:
Buildfile: build.xml
identify:
[echo] ###########################################################################
[echo] # Running the QUEUE example #
[echo] ###########################################################################
[echo] The queue: testQueue
[echo] The client jar: ../..//jboss-messaging-client.jar
sanity-check:
init:
compile:
run:
[java] Queue /queue/testQueue exists
[java] The message was successfully sent to the testQueue queue
[java] Received message: Hello!
[java] The example connected to JBoss Messaging version 1.4.0.SP3 (1.4)
[java]
[java] #####################
[java] ### SUCCESS! ###
[java] #####################
BUILD SUCCESSFUL
Total time: 3 seconds
Note a mensagem:
The example connected to JBoss Messaging version 1.4.0.SP3 (1.4).Pronto, você já está executando mensageria usando JBoss Messaging em sua configuração mais básica.