Construindo a Amostra de BeenThere com a Ferramenta de Construção Ant


Portabilidade do J2EE
Reconstruindo as Amostras Fornecidas nesta Galeria
Informações Iniciais
Identificando a Estrutura de Diretórios
Reconstruindo e Instalando a Amostra

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 (Application Server) 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 quando você clicar em Construa Você Mesmo, obterá instruções para reconstruir o arquivo EAR nesta 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 você fizer alterações em uma máquina ASCII, será possível implementar e instalar 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> antes de tentar modificar ou reconstruir as amostras. Crie um arquivo zip do diretório samples. Você pode restaurar o diretório samples para seu estado original extraindo o arquivo zip.



Identificando a Estrutura de Diretórios

A estrutura do diretório de construção da amostra é a seguinte:


raiz_do_perfil/samples/src/BeenThere Contém o código fonte para a Amostra de BeenThere.
raiz_do_perfil/samples/lib/BeenThere Contém o arquivo BeenThere.ear para a amostra de BeenThere.
raiz_do_perfil/samples/javadoc/BeenThere Contém a documentação Javadoc que é gerada quando a Amostra de BeenThere é construída.
raiz_do_perfil/samples/bld/BeenThere Contém os arquivos de classe gerados. Utilize esses arquivos de classe para gerar o arquivo final BeenThere.ear. O diretório bld é criado após a reconstrução da Amostra de BeenThere.



Reconstruindo e Instalando a Amostra

Os seguintes diretórios descrevem as etapas para reconstruir a Amostra.


Executando o Script de Construção de Amostra

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, mude para o diretório raiz_do_perfil/samples/src/BeenThere.
  3. Execute o script de construção de Amostra:

  4. Digite o seguinte comando:

    raiz_do_perfil\samples\bin\BeenThere\buildBeenThere.bat

    Digite o seguinte comando:

    . raiz_do_perfil/samples/bin/BeenThere/buildBeenThere.sh

    • Em plataformas de desenvolvimento Windows, digite o seguinte comando:

      raiz_do_perfil\samples\bin\BeenThere\buildBeenThere.bat

    • Em plataformas de desenvolvimento UNIX e Linux, digite o seguinte comando:

      . raiz_do_perfil/samples/bin/BeenThere/buildBeenThere.sh
    Digite o seguinte comando:

    . raiz_do_perfil/samples/bin/BeenThere/buildBeenThere.sh

Agora a Amostra foi construída.

Localize o script buildBeenThere.bat ou o buildBeenThere.sh no diretório raiz_do_perfil/samples/bin/BeenThere. Os scripts definem as informações apropriadas do caminho da classe e executam o utilitário de construção Ant. O utilitário Ant lê os arquivos build.xml, que descrevem como construir as Amostras. Consulte o Web site do Jakarta para obter a documentação adicional do Ant.

Transferindo o Arquivo BeenThere.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/BeenThere
  2. Abra uma sessão de FTP para o WebSphere Application Server para z/OS a partir da plataforma de desenvolvimento
  3. Mude para o diretório <raiz_do_perfil>/samples/lib/BeenThere
  4. del BeenThere.ear
  5. bin
  6. put BeenThere.ear
  7. quit

Removendo e Reinstalando o Arquivo BeenThere.ear

Reinstale a Amostra conforme descrito nas etapas a seguir:


  1. Ative o Console Administrativo, abrindo um navegador da Web e indo para http://<nome_do_host>:9060/ibm/console em que <nome_do_host> é o nome do host ou endereço IP no qual o gerenciador de implementação está em execução.
  2. Ative o Console Administrativo, abrindo um navegador da Web e indo para http://<nome_do_host>:9060/ibm/console em que <nome_do_host> é o nome do host ou endereço IP no qual o gerenciador de implementação está em execução.
  3. Ative o Console Administrativo, abrindo um navegador da Web e indo para http://<nome_do_host>:9080/admin em que <nome_do_host> é o nome do host ou endereço IP no qual o gerenciador de implementação está em execução.
  4. Ative o Console Administrativo, abrindo um navegador da Web e indo para http://<nome_do_host>:9060/ibm/console em que <nome_do_host> é o nome do host ou endereço IP no qual o gerenciador de implementação está em execução.
  5. Clique em Servidores > Clusters.
  6. Selecione todos os clusters.
  7. Clique em Parar.
  8. Clique em Aplicativos > Aplicativos Corporativos.
  9. Selecione o aplicativo BeenThere.
  10. Clique em Desinstalar.
  11. Clique em Salvar no topo do painel principal no Console Administrativo.
  12. Clique em Salvar.
  13. Complete as etapas de Instalando um Arquivo BeenThere.ear.

O arquivo BeenThere.ear reconstruído agora está implementado para o Application Servers.