Serviços da Web do JAX-RPC |
|
![]() |
Construir com Ant | Amostras de Serviços da Web do JAX-RPC |
Introdução |
Identificando a Estrutura de Diretórios da Construção de Amostras |
Reconstruindo e Reinstalando o Arquivo WebServicesSamples.ear |
Um dos maiores benefícios do desenvolvimento de aplicativos em
uma plataforma J2EE é a portabilidade. Todos os programas de
Amostra na Galeria de Amostras são desenvolvidos em uma estação de
trabalho e executados em sistemas z/OS sem alteração de uma linha do
código Java. Ao construir aplicativos J2EE em
sistemas Intel ou UNIX, um desenvolvedor pode eliminar os desafios
das
conversões de arquivos EBCDIC para ASCII ou ASCII para EBCDIC.
A disponibilidade das ferramentas facilita aos desenvolvedores
gravar e testar em uma estação de trabalho de desenvolvimento e
instalar os arquivos EAR (Enterprise Archive) nos sistemas z/OS.
Cada WebSphere Application Server (servidor de aplicativos) para o cliente
do z/OS tem direito à mídia do Application Server para multiplataformas. Se você instalar o produto base WebSphere
Application Server e as Amostras em uma das plataformas suportadas
por este pacote, você verá a mesma galeria. A única exceção é
que, ao clicar em nome_da_amostra > Construir com Ant > plataforma > Reconstruindo e Instalando o Arquivo sample.ear, você obterá instruções
para reconstruir o arquivo EAR nessa plataforma. Como os
arquivos de texto em um arquivo EAR (XML, xmi, arquivos JSP
(JavaServer Pages) e assim por diante) devem estar em um
formato ASCII, é mais fácil editar estes arquivos em uma máquina
ASCII. Se fizer alterações em uma máquina
ASCII, você poderá reinstalar o arquivo EAR resultante na plataforma z/OS sem um EBCDIC para conversão ASCII.
Instale o WebSphere Application Server na plataforma distribuída de sua escolha e indique a instalação dos aplicativos de Amostra do Application Server.
Faça uma cópia backup do diretório <raiz_do_perfil>/samples/src/WebServicesSamples antes de tentar modificar ou reconstruir as amostras.
As Amostras são instaladas nos seguintes diretórios:
<raiz_do_perfil>/samples/src/WebServicesSamples | Contém o código-fonte da Amostra para as Amostras AddressBook e Stock Quote. |
<raiz_do_perfil>/samples/lib/WebServicesSamples | Contém os arquivos WAR (Web Archive), os arquivos JAR (Java Archive) e o arquivo WebServicesSamples.ear final para Amostras. Esse diretório é criado após a amostra ser reconstruída. |
<raiz_do_perfil>/samples/javadoc/WebServicesSamples | Contém a documentação Javadoc das Amostras. Esse diretório é criado após a amostra ser reconstruída. |
<raiz_do_perfil>/samples/bld/WebServicesSamples | Contém os arquivos de classe gerados. Esses arquivos de classe são utilizados para gerar o arquivo WebServicesSamples.ear final. Este diretório será criado após esta amostra ser reconstruída. |
O arquivo EAR (Enterprise Archive) de Amostras de serviços da Web do JAX-RPC é fornecido quando o WebSphere Application Server é instalado. Não é necessário construir as Amostras antes de utilizá-las. As instruções a seguir
descrevem as etapas para reconstruir as Amostras, com informações adicionais
para modificações.
Executando o Script de Construção de Amostras |
Removendo e Reinstalando o Arquivo WebServicesSamples.ear |
Para reconstruir esta amostra, verifique se <raiz_do_perfil>/bin está em sua variável de ambiente PATH.Siga estas etapas para executar o script de construção de Amostra, que reconstrói a Amostra:
Agora a Amostra foi construída.
O script buildWebServicesSamples.bat e buildWebServicesSamples.sh no diretório <raiz_do_perfil>/samples/bin/WebServicesSamples configuram as informações do caminho de classe apropriadas e executam o utilitário de construção Ant. O Ant lê os arquivos build.xml, que descrevem como construir a Amostra. Consulte o Web site do Jakarta para obter a documentação adicional do Ant.
Utilize o FTP (File Transfer Protocol) para transferir o arquivo EAR binário para o servidor z/OS, utilizando as instruções a seguir.
Por padrão, a Amostra de Serviços da Web do JAX-RPC é instalada no diretório
<raiz_do_perfil>/installedApps/<cell name>, em que <cell name> é o nome da célula onde seu aplicativo está instalado.
Reinstale a Amostra conforme descrito nas etapas a seguir:
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', '<nó>', '-server', '<servidor>', '-deployejb' ] )"em que <nó> é o nome do nó e <servidor> é o nome do servidor onde a amostra deve ser instalada.
wsadmin.sh -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear', ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<nó>', '-server', '<servidor>', '-deployejb' ] )"em que <nó> é o nome do nó e <servidor> é o nome do servidor onde a amostra deve ser instalada.
wsadmin.sh -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear', ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<nó>', '-server', '<servidor>', '-deployejb' ] )"em que <nó> é o nome do nó e <servidor> é o nome do servidor onde a amostra deve ser instalada.
wsadmin -conntype none -lang jython -c "AdminApp.install('WebServicesSamples.ear', ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<nó>', '-server', '<servidor>', '-deployejb' ] )"em que <nó> é o nome do nó e <servidor> é o nome do servidor onde a amostra deve ser instalada.
Agora você reconstruiu e reinstalou o aplicativo de Amostras de Serviços da Web do JAX-RPC. Você pode configurar e executar os clientes das amostras Address Book e Stock Quote.