Создание простого веб-сервиса с использованием JBossWS - Установка и настройка необходимого программного обеспечения

ОГЛАВЛЕНИЕ


Установка и настройка необходимого программного обеспечения

Данное руководство требует установку и настройку следующих пакетов программ:

  • JDK 1.5 (или выше).
  • Apache Ant (текущая версия 1.7.1).
  • JBoss App Server (текущая версия 5.0.0 GA).
  • JBossWS (текущая версия 3.0.5 GA).

Также рекомендуется использовать Eclipse IDE (интегрированная среда разработки). Но для этого руководства всю работу можно сделать при помощи простого редактора кода (например, UltraEdit32, Crimson Editor или Notepad++), командной строки и Apache Ant.

Для удобства данное руководство было создано в Windows XP. Однако оно относительно легко перемещается на другие платформы.

Установка JDK и Apache Ant

Установить JDK в Windows XP очень легко, достаточно загрузить установщик MSI, затем установить его по умолчанию в "Program Files" или прямо в "C:\". После установки JDK рекомендуется настроить системные переменные:

  1. Создайте системную среду "JAVA_HOME" и укажите в ней базовый каталог JDK (т.е. C:\Program Files\Java\jdk-1.5.0_17 или C:\jdk-1.5.0_17).
  2. Также добавьте "%JAVA_HOME%\bin" в системную переменную "PATH (путь)".

После настройки системной переменной откройте командную строку и наберите "java –version (версия java)". Вывод покажет версию JDK, установленную в системе. Это позволит проверить успешность установки JDK. После проверки закройте командную строку.

Установить Apache Ant также просто: загрузите исполняемый двоичный файл-архив с вебстраницы проекта Apache Ant (здесь). Затем распакуйте файл-архив в "C:\". Это распакует файл-архив в "C:\apache-ant-1.7.1". "C:\apache-ant-1.7.1" будет базовым каталогом Apache Ant. После распаковки настройте системные переменные следующим образом:

  1. Создайте системную среду "ANT_HOME" и укажите в ней базовый каталог Apache Ant (т.е. C:\apache-ant-1.7.1).
  2. Также добавьте "%ANT_HOME%\bin" в системную переменную "PATH".

После настройки системной переменной выполните проверку, открыв командную строку и введя "ant –version". Если настройка выполнена правильно, вывод покажет версию Apache Ant, установленную в системе.

Установка JBoss и JBossWS

Это руководство учит, как создать веб-сервис, работающий в JBoss. Поэтому обязательно нужно установить и настроить сервер приложений JBoss (текущая версия 5.0.0.GA) и веб-сервисы JBoss (также называются JBossWS, текущая версия 3.0.5.GA). Установочные пакеты (zip архивы) можно найти в следующих местах:

  • Скачать сервер приложений JBoss. На настоящей странице загрузки есть два файла-архива, тот, который работает с JDK 1.5, называется jboss-5.0.0.GA.zip. Другой (jboss-5.0.0.GA-jdk6.zip) работает с JDK 1.6.
  • Скачать веб-сервисы JBoss

Процесс установки JBoss аналогичен установке Apache Ant. Вам лишь нужно распаковать файл-архив, содержащий исполняемые двоичные файлы сервера приложений JBoss в "C:\". Это создаст новый каталог под названием "C:\jboss-5.0.0.GA", являющийся базовым каталогом сервера приложений JBoss. После распаковки создайте системную среду "JBOSS_HOME" и укажите в ней "C:\jboss-5.0.0.GA". Хотя это необязательно, также можно добавить "%JBOSS_HOME%\bin" в системную переменную "PATH".

Последний шаг – установка пакета JBossWS. Выполните следующие шаги:

  1. Сначала распакуйте исполняемый двоичный архив JBossWS в "C:\". Это создаст папку "C:\jbossws-native-bin-dist".
  2. Через проводник Windows зайдите в "C:\jbossws-native-bin-dist". Внутри папки найдите файл "ant.properties.example".
  3. Создайте копию "ant.properties.example", затем переименуйте ее в "ant.properties".
  4. Запустите ваш любимый редактор кода (например, UltraEdit32 или Notepad++), затем откройте файл "ant.properties" для редактирования.
  5. Найдите строку "jboss500.home=@jboss500.home@", замените ее на "jboss500.home=/jboss-5.0.0.GA". Затем сохраните файл и закройте редактор кода.
  6. Откройте командную строку, перейдите в "C:\jbossws-native-bin-dist". Затем исполните команду "ant deploy-jboss500". Когда она успешно завершится, JBossWS будет установлен и правильно настроен для использования.