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



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

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

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

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

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

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

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

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

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

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


<каталог-профайла>/samples/src/PlantsByWebSphere Содержит исходный код примера WebSphere Plants.
<каталог-профайла>/samples/lib/PlantsByWebSphere Содержит файлы архивов Web (WAR), файлы архивов Java (JAR) и окончательный архив PlantsByWebSphere.ear примера WebSphere Plants. Этот каталог создается при компоновке примера WebSphere Plants.
<каталог-профайла>/samples/javadoc/PlantsByWebSphere Документация Javadoc. Этот каталог создается при компоновке примера WebSphere Plants.
<каталог-профайла>/samples/bld/PlantsByWebSphere Генерируемые файлы классов. Используйте эти файлы для создания файла PlantsByWebSphere.ear. Этот каталог создается при компоновке примера WebSphere Plants.

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

При установке сервера приложений WebSphere пример Plants устанавливается автоматически. Компоновку примера перед его использованием выполнять не требуется. Ниже описан процесс перекомпоновки примера, а также приведены дополнительные сведения по его изменению.


Запуск сценария компоновки примера
Передача файла PlantsByWebSphere.ear, созданного при перекомпоновке
Удаление и переустановка файла PlantsByWebSphere.ear

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

Для перекомпоновки этого примера убедитесь, что profile_root/bin указан в переменной среды PATH. Запуск сценария для перекомпоновки примера следует выполнять следующим образом:

  1. Откройте окно командной строки.
  2. В окне командной строки перейдите в каталог <каталог-профайла>/samples/src/PlantsByWebSphere.
  3. Запустите сценарий компоновки примера:

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


    <каталог-профайла>\samples\bin\PlantsByWebSphere\buildplantsby.bat


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

      <каталог-профайла>\samples\bin\PlantsByWebSphere\buildplantsby.bat


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

      . <каталог-профайла>/samples/bin/PlantsByWebSphere/buildplantsby.sh

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

Сценарий buildplantsby.bat и buildplantsby.sh в каталоге profile_root/samples/bin/PlantsByWebSphere настраивает путь к классу и запускает утилиту компоновки Ant. Ant анализирует файлы build.xml, которые задают параметры компоновки. Дополнительные сведения о Ant можно найти на web-сайте Jakarta.

Важные сведения   Осуществляется перекомпоновка только тех файлов классов, в которые были внесены изменения. Остальные файлы классов упаковываются в новый архив EAR.

Передача файла PlantsByWebSphere.ear, созданного при перекомпоновке

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

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

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

По умолчанию пример Plants by WebSphere устанавливается в каталог каталог-профайла/installedApps/<узел>, где <узел> - имя узла, в котором установлено приложение. Переустановите пример следующим образом:

  1. Остановите сервер приложений.
  2. Удалите файл EAR примера WebSphere Plants:
    1. Введите следующие команды:

      cd <каталог-профайла>\bin
      setupCmdLine

      cd <каталог-профайла>/bin
      . ./setupCmdLine.sh

      В системе z/OS:
      cd <каталог-профайла>/bin
      . ./setupCmdLine.sh

      В системе iSeries:
      cd <каталог-профайла>/bin
      . ./setupCmdLine

      где <каталог-профайла> - это каталог, в котором установлен профайл.
    2. Введите следующую команду для удаления приложения (каталог-профайла/bin должен находиться в PATH):

      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      В системе z/OS:
      wsadmin.sh -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 

      На платформах iSeries:
      wsadmin -conntype none -lang jython -c "AdminApp.uninstall('PlantsByWebSphere')" 
  3. Переустановите пример WebSphere Plants:
    • Перейдите в каталог каталог-профайла/samples/lib/PlantsByWebSphere.
    • Найдите файл PlantsByWebSphere.ear.
    • Введите следующую команду:

      wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<node>', '-server', '<server>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      где <node> - это имя узла, а <server> - имя сервера для установки примера.

      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<node>', '-server', '<server>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      где <node> - это имя узла, а <server> - имя сервера для установки примера.

      В системе z/OS:
      wsadmin.sh -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<node>', '-server', '<server>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    

      На платформах iSeries:
      wsadmin -conntype none -lang jython -c "AdminApp.install('PlantsByWebSphere.ear',
      	['-appname', 'PlantsByWebSphere', '-usedefaultbindings', '-node', '<node>', '-server', '<server>',
      	'-deployejb', '-deployejb.dbtype', 'DERBY_V10'] )"
      	    
      где <node> - это имя узла, а <server> - имя сервера для установки примера.
  4. Запустите сервер приложений.

 

Установка перекомпонованного файла PlantsByWebsphere.ear на сервере приложений закончена.