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


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

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

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

Перекомпоновка примеров JAX-WS

Все серверы WebSphere Application Server, работающие в системах z/OS, называются Мультиплатформенными серверами приложений. Галерея одинакова на всех поддерживаемых платформах. Однако есть одно исключение: при выборе имя-примера > Компоновка с помощью Ant > платформа > Перекомпоновка и установка файла пользователь получает инструкции по перекомпоновке файла EAR для конкретной платформы.   Поскольку текстовые файлы, помещаемые в архив EAR  (XML, xmi, JSP и т.д.), имеют формат ASCII, с ними проще работать в операционных системах стандарта ASCII.   После внесения изменений в файлы с помощью операционной системы стандарта ASCII, файл EAR можно переустановить на платформе z/OS без выполнения преобразования из EBCDIC в ASCII.  

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

Установите WebSphere Application Server и примеры приложений в распределенной системе. На панели Установить примеры приложений выберите переключатель Установить примеры приложений.

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

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

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

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

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

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

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

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

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

Для перекомпоновки файла EAR примеров Web-служб JAX-WS выполните следующие действия:

  1. Убедитесь, что в переменной PATH присутствует элемент <каталог-профайла>/bin.
  2. Перейдите в каталог <каталог-профайла>/samples/src/JaxWSServicesSamples.
  3. Запустите сценарий компоновки примеров.
    • На платформе Windows введите buildJaxWSSamples в командной строке.
    • На платформе AIX или Linux введите buildJaxWSSamples.sh в командной строке.

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

Сценарии buildJaxWSSamples находятся в каталоге <каталог-профайла>/bin. Сценарий настраивает необходимую информацию о пути к классам и запускает утилиту компоновки Ant. Последнее, на основе правил, описанных в файлах build.xml, выполняет компоновку примеров. Дополнительные сведения об утилите Ant можно найти на Web-сайте Apache.

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

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

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

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

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

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

  1. Остановите сервер приложений.
  2. Удалите файл EAR примера Web-служб JAX-WS:
    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('JaxWSServicesSamples')" 

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

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

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

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

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

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

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

Приложение JAX-WS Web services Samples перекомпоновано и переустановлено. Теперь можно настроить и запустить примеры клиентов Ping, Echo и MTOM.