Компоновка примеров Web-служб JAX-RPC с помощью утилиты компоновки Ant


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

Переносимость в 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.

Создайте резервную копию каталога <каталог-профайла>/samples/src/WebServicesSamples перед внесением изменений или перекомпоновкой примеров.

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

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

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

Перекомпоновка и переустановка файла WebServicesSamples.ear.

Файл EAR с JAX-RPC Web services Samples устанавливается вместе с сервером приложений WebSphere. Выполнять компоновку примеров перед их использованием не требуется. Ниже приведены инструкции по перекомпоновке примеров, сопровождающиеся комментариями относительно внесения в них изменений.

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

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

Выполнение сценария компоновки примеров

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

  1. Откройте окно командной строки.
  2. В командной строке перейдите в каталог <profile_root>/samples/src/WebServicesSamples.
  3. Запустите сценарий компоновки примера:
  4. Введите buildWebServiceSamples в командной строке.
    • При использовании Windows в качестве платформы разработки введите buildWebServiceSamples в командной строке.
    • При использовании UNIX или Linux в качестве платформы разработки введите buildWebServiceSamples.sh в командной строке.

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

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

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

Перенос перекомпонованного файла WebServicesSamples.ear

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

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

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

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

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

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

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

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

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

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

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

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

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

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

  3. Установите пример заново:
    • Перейдите в каталог <каталог-профайла>/samples/lib/WebServicesSamples.
    • Найдите файл WebServicesSamples.ear
    • Введите следующие команды:

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

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

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

Теперь вы перекомпоновали и переустановили приложение примеров Web-служб JAX-RPC. Теперь можно настроить и запустить клиенты Address Book и Stock Quote.