Web-службы JAX-RPC |
|
![]() |
Компоновка с помощью Ant | Примеры Web-служб JAX-RPC |
Начало работы |
Определение структуры каталогов, создаваемой при компоновке примеров |
Перекомпоновка и переустановка файла WebServicesSamples.ear |
Одним из основных преимуществ разработки приложений в 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. Этот каталог создается после перекомпоновки примера. |
Файл EAR с JAX-RPC Web services Samples устанавливается вместе с сервером приложений WebSphere. Выполнять компоновку примеров перед их использованием не требуется. Ниже приведены инструкции по перекомпоновке примеров, сопровождающиеся комментариями относительно внесения в них изменений.
Запуск сценария компоновки примеров |
Удаление и повторная установка файла WebServicesSamples.ear |
Для перекомпоновки этого примера убедитесь, что <profile_root>/bin указан в переменной среды PATH. Запуск сценария для перекомпоновки примера следует выполнять следующим образом:
Компоновка примера завершена.
Сценарий buildWebServicesSamples.bat и buildWebServicesSamples.sh в каталоге <profile_root>/samples/bin/WebServicesSamples настраивает путь к классу и запускает утилиту компоновки Ant. Ant анализирует файлы build.xml, которые задают параметры компоновки. Дополнительные сведения о Ant можно найти на web-сайте Jakarta.
Передача двоичного файла EAR на сервер z/OS выполняется по протоколу FTP в соответствии со следующими инструкциями.
По умолчанию пример Web-служб JAX-RPC устанавливается в каталог
<каталог-профайла>/installedApps/<узел>,
где <узел> - имя узла, в котором установлено приложение. Переустановите пример следующим образом:
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')"
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> - имя сервера для установки примера.
Теперь вы перекомпоновали и переустановили приложение примеров Web-служб JAX-RPC. Теперь можно настроить и запустить клиенты Address Book и Stock Quote.