Эта глава покажет как использовать Java Messaging Service (JMS) в JBoss. Это не учебник по JMS вообще, но учебник по использованию JMS в JBoss. Для начала изучения JMS пожалуйста почитайте Спецификацию JMS или учебник по JMS.

Недавно поддержка JMS в JBoss претерпела несколько серьёзных изменений, в результате появилось несколько известных различий между версиями 2.2.x, 2.4.x и версией, которая находится в разработке. Эта глава описывает версии 2.2.x. Возможности, которые доступны только в последних версиях будут помечены соответствующим номером версии, прямо в тексте или в заголовке. В ранних версиях этой главы номер версии 2.5.x указывал на возможности, доступные только в разрабатываемой версии JBoss. С тех пор, после выхода JBossMQ 1.0beta, всё, что говорилось про 2.5.x теперь подходит и для 2.4.1. Ссылки на 2.5.x были удалены из этой главы. Примеры описывающие возможности версии 2.4.1, всё ещё содержат “"25"” в именах файлов. Новые возможности, добавленные в JBoss3.0 будут описаны в следующих версиях этой главы.

Примеры, приведённые в этой главе малы и нужны только для того, чтобы показать как использовать JMS в принципе. Почти все они основаны на шаблоне программирования “Hello World” :). Все примеры могут быть запущены с помощью предоставленного build-файла для Ant.

Загрузите файл documentation-example.zip и разверните его где-нибудь. Соберите и запустите примеры из директории examples/build. Все исходные файлы примеров для JMS доступны в под-директориях examples/org/jboss/docs/jms. Из чего следует, что любое упоминание об исходных файлах должно относится к директории examples.

Чтобы иметь возможность собрать и запустить примеры этой документации, должны быть установлены следующие переменные среды окружения:

Директория Ant bin и директория JDK bin должна быть в переменной PATH, как это описано в разделе “Установка Ant” в первых главах этого руководства.

Так как различные примеры работают с различными версиями JBoss, то Вы должны быть уверены, что переменная JBOSS_DIST указывает на необходимую версию JBoss для конкретного примера.

Когда всё сделано, то вы сможете собрать примеры JMS:

cd examples/build
ant jms-compile

Когда будете использовать примеры кода, то лучше брать их из исходных файлов а не из примеров в этой документации; исходные файлы проверены во время компиляции и во время работы, но текст в мануале, хоть и выглядит похоже, прошёл только визуальную проверку.

Для некоторых примеров в директории org/jboss/docs/jms/bin Вы можете найти скрипты Unix и пакетные файлы (.bat), которые помогут вам увидеть файлы, которые должны быть включены в classpath.

Все файлы, которые содержат код отличающийся от кода для JBoss версии 2.2.x будут названы соответственно версии JBoss. Это может быть исходный файл Java, дескриптор развертывания (deployment descriptor) или скрипт.