Construindo as Amostras de Serviços da Web do JAX-RPC com a ferramenta de construção Ant


Portabilidade do J2EE
Reconstruindo as Amostras Fornecidas nesta Galeria
Introdução
Identificando a Estrutura de Diretórios da Construção de Amostras
Reconstruindo e Reinstalando o Arquivo WebServicesSamples.ear

Portabilidade do J2EE

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.

Reconstruindo as Amostras Fornecidas nesta Galeria

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.  

Introdução

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.

Identificando a Estrutura de Diretórios da construção de 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.

Reconstruindo e Reinstalando o Arquivo WebServicesSamples.ear

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

Transferindo o Arquivo WebServicesSamples.ear Reconstruído
Removendo e Reinstalando o Arquivo WebServicesSamples.ear

Executando o Script de Construção de Amostras

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:

  1. Abra um prompt de comandos.
  2. Na linha de comandos, vá para o diretório <raiz_do_perfil>/samples/src/WebServicesSamples.
  3. Execute o script de construção de Amostra:
  4. Digite buildWebServiceSamples na linha de comandos.
    • Em plataformas de desenvolvimento Windows, digite buildWebServiceSamples na linha de comandos.
    • Em plataformas de desenvolvimento UNIX e Linux, digite buildWebServiceSamples.sh na linha de comandos.

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.

Informações Importantes Durante o processo de construção, apenas os arquivos de classe que possuem alterações são reconstruídos. Os arquivos de classe restantes são empacotados novamente em um novo arquivo EAR.

Transferindo o Arquivo WebServicesSamples.ear Reconstruído

Utilize o FTP (File Transfer Protocol) para transferir o arquivo EAR binário para o servidor z/OS, utilizando as instruções a seguir.

  1. Localize o arquivo EAR reconstruído no diretório <raiz_do_perfil>/samples/lib/WebServicesSamples
  2. Abra uma sessão de FTP para o WebSphere Application Server para z/OS a partir da plataforma de desenvolvimento
  3. Vá para o diretório <raiz_do_perfil>/samples/lib/WebServicesSamples
  4. del WebServicesSamples.ear
  5. bin
  6. put WebServicesSamples.ear
  7. quit

Removendo e Reinstalando o Arquivo WebServicesSamples.ear

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:

  1. Pare o servidor de aplicativos.
  2. Remova o arquivo EAR da amostra de serviços da Web do JAX-RPC:
    1. Digite os seguintes comandos:

      cd <raiz_do_perfil>\bin
      setupCmdLine

      cd <raiz_do_perfil>/bin
      . ./setupCmdLine.sh

      cd <raiz_do_perfil>/bin
      . ./setupCmdLine.sh

      cd <raiz_do_perfil>/bin
      . ./setupCmdLine

      em que <raiz_do_perfil> representa o diretório de instalação do perfil.
    2. Digite o seguinte comando para desinstalar o aplicativo (<raiz_do_perfil>/bin deve estar em 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. Reinstale a Amostra:
    • Mude para o diretório <raiz_do_perfil>/samples/lib/WebServicesSamples
    • Localize o arquivo WebServicesSamples.ear
    • Digite o seguinte:

      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.
  4. Inicie o servidor de aplicativos.

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.