Criando Amostras dos Serviços da Web do JAX-WS com a Ferramenta de Construção Ant


Portabilidade do J2EE
Recriando as Amostras de Serviços da Web do JAX-WS
Introdução
Identificando a Estrutura de Diretórios da Construção de Amostras
Reconstruindo e Reinstalando o Arquivo JaxWSServicesSamples.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 nos sistemas z/OS sem alteração de uma linha de código Java.  Ao criar aplicativos J2EE em Intel ou sistemas operacionais como AIX ou Linux, um desenvolvedor pode eliminar os desafios das conversões de arquivos EBCDIC para ASCII ou de 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.

Recriando as Amostras de JAX-WS

Cada cliente do WebSphere Application Server para z/OS tem direito à mídia do Application Server para várias plataformas. Se você instala o produto base WebSphere Application Server e as amostras em uma das plataformas suportadas por este pacote, a galeria que você vê é a mesma. No entanto, há uma diferença. Quando você clica em nome_da_amostra > Construir com Ant > plataforma > Recriando e Instalando o Arquivo, as instruções para recriar o arquivo EAR são específicas para sua plataforma.  Como os arquivos de texto em um arquivo EAR , como arquivos XML, xmi ou JavaServer Pages (JSP), 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. No painel Instalar Aplicativos de Amostra, selecione Instalar os Aplicativos de Amostra.

Faça uma cópia de backup do diretório <raiz_do_perfil>/samples/src/JaxWSServicesSamples antes de tentar modificar ou recriar 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/JaxWSServicesSamples Contém o código-fonte de amostra para as amostras de Ping, Echo e MTOM.
<raiz_do_perfil>/samples/lib/JaxWSServicesSamples Contém os arquivos WAR, os arquivos JAR e o arquivo final JaxWSServicesSamples.ear das amostras. Este diretório será criado após esta amostra ser reconstruída.
<raiz_do_perfil>/samples/javadoc/JaxWSServicesSamples Contém a documentação Javadoc das Amostras. Este diretório será criado após esta amostra ser reconstruída.
<raiz_do_perfil>/samples/bld/JaxWSServicesSamples Contém os arquivos de classe gerados. Esses arquivos de classe são usados para gerar o arquivo final JaxWSServicesSamples.ear. Este diretório será criado após esta amostra ser reconstruída.

Reconstruindo e Reinstalando o Arquivo JaxWSServicesSamples.ear

O arquivo EAR (Enterprise Archive) das Amostras de Serviços da Web do JAX-WS é 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 JaxWSServicesSamples.ear Recriado
Removendo e Reinstalando o Arquivo JaxWSServicesSamples.ear

Executando o Script de Construção de Amostras

Para recriar o arquivo EAR de amostras dos serviços da Web do JAX-WS, execute as seguintes etapas:

  1. Verifique se <raiz_do_perfil>/bin está em sua variável de ambiente PATH.
  2. Vá para o diretório <raiz_do_perfil>/samples/src/JaxWSServicesSamples.
  3. Execute o script de criação de amostras.
    • Em plataformas Windows, digite buildJaxWSSamples na linha de comandos.
    • Em plataformas como AIX ou Linux, digite buildJaxWSSamples.sh na linha de comandos.

Agora a Amostra foi construída.

Os scripts buildJaxWSSamples estão localizados no diretório <raiz_do_perfil>/bin. 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 Apache Ant para obter a documentação adicional do utilitário 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 JaxWSServicesSamples.ear Recriado

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 recriado no diretório <raiz_do_perfil>/samples/lib/JaxWSServicesSamples.
  2. Abra uma sessão de FTP para o WebSphere Application Server para z/OS da plataforma de desenvolvimento.
  3. Vá para o diretório <raiz_do_perfil>/samples/lib/JaxWSServicesSamples.
  4. Exclua o arquivo JaxWSServicesSamples.ear existente. Digite o comando: del JaxWSServicesSamples.ear
  5. Para transferir o arquivo no formato binário, digite o comando: bin
  6. Mova o JaxWSServicesSamples.ear recriado de sua plataforma de implementação para o servidor de aplicativos de destino. Digite o comando: put JaxWSServicesSamples.ear
  7. Finalize a sessão de FTP. Digite quit.

Removendo e Reinstalando o Arquivo JaxWSServicesSamples.ear

Por padrão, a Amostra de Serviços da Web do JAX-WS é 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-WS:
    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('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. Reinstale a Amostra:
    • Vá para o diretório <raiz_do_perfil>/samples/lib/JaxWSServicesSamples
    • Localize o arquivo JaxWSServicesSamples.ear
    • Digite o seguinte:

      wsadmin -conntype none -lang jython -c "AdminApp.install('JaxWSServicesSamples.ear',
                  ['-appname', 'JaxWSServicesSamples', '-usedefaultbindings', '-node', '<nó>',
                  '-server', '<servidor>' ] )"
                
      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('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<nó>',
                  '-server', '<servidor>' ] )"
                
      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('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<nó>',
                  '-server', '<servidor>' ] )"
                
      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('JaxWSServicesSamples.ear',
                  ['-appname', 'WebServicesSamples', '-usedefaultbindings', '-node', '<nó>',
                  '-server', '<servidor>' ] )"
                
      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-WS. Você pode configurar e executar os clientes de amostras Ping, Echo e MTOM.