Serviços da Web do Jax-WS |
|
![]() |
Construir com Ant | Amostras dos 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 |
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.
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.
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.
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. |
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 |
Removendo e Reinstalando o Arquivo JaxWSServicesSamples.ear |
Para recriar o arquivo EAR de amostras dos serviços da Web do JAX-WS, execute as seguintes etapas:
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.
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-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:
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')"
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.
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.