O Assistente Cliente de Serviço da Web auxilia na geração de um proxy de Java bean
e e um aplicativo de amostra. O aplicativo da Web de amostra demonstra como
codificar um arquivo de proxy.
Pré-requisitos:
- Se você estiver usando o contêiner de servlet Apache Jakarta Tomcat
como seu servidor, precisará instalá-lo, configurar uma instância dele e criar
um projeto da Web destinado a ele conforme descrito em Criando um servidor Apache Tomcat e um projeto da Web
- Descubra e importe um documento WSDL para o projeto da Web. Você só pode utilizar um
arquivo WSDL que contenha um elemento de serviço.
Para gerar um proxy de cliente Java e um aplicativo de amostra
a partir de um documento WSDL descoberto:
- Mude para a perspectiva J2EE ( Janela > Abrir Perspectiva
> J2EE).
- Na visualização Navegador, selecione o projeto da Web no qual
você deseja gerar um aplicativo de amostra.
- Clique em Arquivo > Novo > Outro. Selecione
Serviços da Web para exibir os diversos assistentes de
serviços da Web. Selecione o assistente do Cliente de Serviço da
Web. Clique em Avançar.
- Página Serviços da Web:
- Digite o URI para o arquivo WSDL, WSIL ou HTML que será utilizado para
gerar o cliente.
- Selecione o tipo de proxy a ser gerado
- Selecione os estágios de desenvolvimento de serviços da Web que você deseja concluir
usando a barra deslizante:
- Desenvolver: isto criará o código do cliente
- Montar:
- Implementar: isto criará o código de implementação para o cliente
- Instalar: isto instalará o cliente no servidor escolhido
- Iniciar: isto iniciará o servidor depois que o cliente tiver sido instalado
nele
- Testar: isto fornecerá diversas opções para testar o cliente
- Selecione o servidor: o servidor padrão é exibido. Se você quiser
implementar o cliente em um servidor diferente, clique no link para especificar
um servidor diferente.
- Selecione o tempo de execução: o tempo de execução padrão é exibido. Se você quiser
implementar o cliente em um tempo de execução diferente, clique no link para especificar
um tempo de execução diferente.
- Selecione o projeto do cliente: o projeto que contém o projeto
selecionado no espaço de trabalho é exibido. Para selecionar um projeto e EAR diferentes,
clique no link do projeto. Assegure-se
de que o projeto selecionado como o Projeto de Cliente da Web seja diferente do Projeto
de Serviço da Web, ou o serviço será sobrescrito pelos artefatos gerados do cliente.
- Monitorar o serviço da Web: isto enviará o tráfego do serviço da Web
através do Monitor TCP/IP, o que permite observar o tráfego SOAP gerado pelo serviço da Web
e testar esse tráfego para conformidade com WS-I. Alternativamente,
é possível configurar manualmente um monitor TCP/IP conforme descrito em Usando o Monitor TCP/IP para Testar Serviços da Web
- Página Proxy do Serviço da Web: este painel mostra as opções para o proxy.
Ele lista a pasta na qual o proxy será gerado, e você pode opcionalmente criar
mapeamentos customizados entre espaços de nomes e pacotes.
- Página Mapeamento de Espaço de Nomes do Serviço da Web para Pacote: se você selecionou
Definir mapeamento customizado para espaço de nomes para pacote na
página anterior, poderá inserir os pares de mapeamento customizado nesta página
clicando em Incluir.
- Página Teste de Cliente do Serviço da Web: esta página é exibida se você selecionou
testar o cliente. Selecione o recurso de teste que você utilizará para testar o
proxy e os métodos que deseja que sejam incluídos no proxy. Observe que o
UTC (Universal Test Client) só é compatível com clientes de serviço da Web implementados
em servidores WebSphere.
- Clique em Concluir. Se você tiver selecionado testar
o proxy, o cliente de teste será aberto em uma janela do navegador.
O proxy de Java gerado fornece uma interface de chamada de
procedimento remoto para o serviço da Web. O exemplo de aplicativo da Web demonstra como codificar o arquivo de proxy.
Depois de gerar o proxy de cliente Java,
você poderá testar os métodos do serviço da Web por meio do proxy usando
JSPs de amostra de Serviços da Web ou o cliente de teste universal.
- Se você selecionou testar o proxy gerado usando JSPs do serviço da Web,
o proxy será ativado em um navegador da Web na seguinte URL: http://localhost: porta/ WebProjectClient/sampleBeanName/ WebServiceName/TestClient.jsp Você pode utilizar
esse aplicativo de amostra para testar o serviço da Web selecionando um método, digitando um
valor para o método e clicando em Chamar. O resultado do
método será exibido na área de janela de resultados.
- Se você tiver selecionado testar o serviço da Web usando o Web Services Explorer,
o Explorer será aberto. Selecione a operação que deseja testar, digite as informações
necessárias e clique em Ir. O resultado será exibido na área de janela Status.
Para obter mais informações sobre como criar um projeto da Web, consulte a
documentação de desenvolvimento de aplicativo da Web.