Компоновка примера BeenThere с помощью утилиты компоновки Ant


Переносимость в J2EE
Перекомпоновка примеров из галереи
Начало работы
Определение структуры каталогов
Перекомпоновка и установка файла Sample

Переносимость в J2EE

Одним из основных преимуществ разработки приложений в J2EE является легкость переноса их на разные платформы.  Все демонстрационные программы Галереи примеров написаны на обычной рабочей станции и работают в системах z/OS без необходимости внесения каких-либо изменений в код Java.   При компоновке приложений J2EE в системах Intel или UNIX, разработчик избавляется от необходимости преобразования файлов EBCDIC в ASCII и наоборот.  Наличие специального инструментария позволяет писать и тестировать приложения на обычной рабочей станции, а затем устанавливать файлы архива EJB (EAR) в системах z/OS.

Перекомпоновка примеров из галереи

Всем клиентам WebSphere Application Server (Application Server) for z/OS доступно также Application Server media for multiplatforms. При установке базового продукта WebSphere Application Server и примеров на одной из платформ, поддерживаемых этим пакетом, вам доступна упомянутая выше галерея. Исключением является случай настраиваемой компоновки (имя-примера > Компоновка с помощью Ant > платформа > Перекомпоновка и установка файла sample.ear), при этом пользователь получает инструкции по перекомпоновке файла EAR для конкретной платформы.  Поскольку текстовые файлы, помещаемые в архив EAR  (XML, xmi, JSP и т.д.), имеют формат ASCII, с ними проще работать в операционных системах стандарта ASCII.   После внесения изменений в файлы с помощью операционной системы стандарта ASCII, файл EAR можно развертывать и устанавливать на платформе z/OS без выполнения преобразования из EBCDIC в ASCII. 



Начало работы

Установите WebSphere Application Server на выбранной платформе, включив установку демонстрационных приложений Application Server.

Прежде, чем изменять или перекомпоновать примеры, создайте резервную копию каталога <корневой-каталог-профайла>. Для этого создайте архив zip с каталогом samples. Теперь для восстановления каталога samples нужно будет просто распаковать файл zip.



Определение структуры каталогов

Структура каталогов данного примера следующая:


корневой-каталог-профайла/samples/src/BeenThere Исходный код примера BeenThere.
корневой-каталог-профайла/samples/lib/BeenThere Файл BeenThere.ear для примера BeenThere.
корневой-каталог-профайла/samples/javadoc/BeenThere Документация Javadoc, полученная из примера BeenThere.
корневой-каталог-профайла/samples/bld/BeenThere Файлы созданных классов. На основе этих файлов создается конечный файл BeenThere.ear. Каталог bld создается после компоновки примера.



Перекомпоновка и установка примера

Ниже приведены инструкции по перекомпоновке примера.


Запуск сценария компоновки примера

Для запуска сценария компоновки примера выполните следующие действия:

  1. Откройте окно командной строки.
  2. С помощью командной строки перейдите в каталог корневой-каталог-профайла/samples/src/BeenThere.
  3. Запустите сценарий компоновки примера:

  4. Введите следующую команду:

    корневой-каталог-профайла\samples\bin\BeenThere\buildBeenThere.bat

    Введите следующую команду:

    . корневой-каталог-профайла/samples/bin/BeenThere/buildBeenThere.sh

    • Если разработка проводилась в системе Windows, введите следующую команду:

      корневой-каталог-профайла\samples\bin\BeenThere\buildBeenThere.bat

    • Если разработка проводилась в системе UNIX или Linux, введите следующую команду:

      . корневой-каталог-профайла/samples/bin/BeenThere/buildBeenThere.sh
    Введите следующую команду:

    . корневой-каталог-профайла/samples/bin/BeenThere/buildBeenThere.sh

Компоновка примера завершена.

Найдите в каталоге корневой-каталог-профайла/samples/bin/BeenThere сценарий buildBeenThere.bat или buildBeenThere.sh. Сценарий настраивает необходимую информацию о пути к классам и запускает утилиту компоновки Ant. Ant считывает файлы build.xml, в которых описано, как компоновать примеры. Документацию по Ant можно найти на Web-сайте Jakarta.

Передача перекомпонованного файла BeenThere.ear

Передача двоичного файла EAR на сервер z/OS выполняется по протоколу FTP в соответствии со следующими инструкциями.

  1. Найдите перекомпонованный файл EAR в каталоге <корневой-каталог-профайла>/samples/lib/BeenThere
  2. Откройте сеанс FTP с WebSphere Application Server для z/OS из платформы разработки
  3. Перейдите в каталог <корневой-каталог-профайла>/samples/lib/BeenThere и выполните следующие команды:
  4. del BeenThere.ear
  5. bin
  6. put BeenThere.ear
  7. quit

Удаление и повторная установка файла BeenThere.ear

Переустановите пример следующим образом:


  1. Откройте в Web-браузере консоль администрирования и введите адрес http://<хост>:9060/ibm/console, где <хост> - имя или IP-адрес системы, в которой работает Администратор развертываний.
  2. Откройте в Web-браузере консоль администрирования и введите адрес http://<хост>:9060/ibm/console, где <хост> - имя или IP-адрес системы, в которой работает Администратор развертываний.
  3. Откройте в Web-браузере консоль администрирования и введите адрес http://<хост>:9080/admin, где <хост> - имя или IP-адрес системы, в которой работает Администратор развертываний.
  4. Откройте в Web-браузере консоль администрирования и введите адрес http://<хост>:9060/ibm/console, где <хост> - имя или IP-адрес системы, в которой работает Администратор развертываний.
  5. Выберите Серверы > Кластеры.
  6. Выберите все кластеры.
  7. Нажмите Остановить.
  8. Нажмите Приложения > Приложения организации.
  9. Выберите приложение BeenThere.
  10. Нажмите Удалить.
  11. Нажмите кнопку Сохранить в верхней части главной панели консоли администрирования.
  12. Нажмите Сохранить.
  13. Выполните действия из раздела Установка файла BeenThere.ear.

В результате на вашем сервере приложений будет развернут перекомпонованный файл BeenThere.ear.