quinta-feira, 27 de dezembro de 2007

JBoss Messaging

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:
  1. 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).
  2. Descompacte-o em qualquer lugar.
  3. Certifique-se que seu JBoss não possui alterações em sua configuração DEFAULT
  4. Entre no diretório em que vc descompactou o jboss-messaging, entre no diretório util e digite ant -f release-admin.xml.
  5. 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.

Um comentário:

Java disse...

Bruno, parabéns pelo artigo!

Abraços.

Walyson amaral.