O assistente de cliente de serviço da web auxilia na geração
de um proxy Java™ bean e um aplicativo
de amostra. O aplicativo da web amostra demonstra como codificar um
arquivo de proxy.
Antes de Iniciar
Pré-requisitos:
- Se você estiver usando o WebSphere Application Server, é altamente
recomendado que você inicie o servidor antes de executar o assistente de serviço da web,
porque pode levar vários minutos para iniciar o WebSphere Application Server dependendo
da velocidade de seu computador. Para iniciar o servidor, selecione-o na
visualização Servidores (Janela > Mostrar Visualização > Servidores),
clique com o botão direito e selecione Iniciar.
- Descubra ou importe um documento WSDL para a área de trabalho. É possível
usar um arquivo WSDL que conté um elemento de serviço. É possível usar um arquivo WSDL
estático a partir de sua área de trabalho, um arquivo WSDL que reside em uma URL ou,
se você tiver um bean anotado que age como um serviço da web JAX-WS
em sua área de trabalho, o arquivo WSDL produzido dinamicamente pelo WebSphere Application
Server Feature Pack para o tempo de execução de Serviços da Web. Este WSDL pode ser localizado na
URL: http://localhost:port/service_project_name/service_nameService?wsdl.
Por exemplo, no serviço da web JAX-WS da lista de endereços que é criado
no tutorial e amostras que acompanham o Feature Pack para serviços da web,
o arquivo WSDL dinâmico estaria localizado nesta URL: http://localhost:9082/jwsAddressBook/AddressBookService?wsdl.
Restrição: Se você deseja executar um cliente de serviço da web Java simples fora
de qualquer contêiner J2EE, deverá gerar o cliente de serviço da web em
um projeto Java simples. O assistente
de serviço da web não pode criar um projeto Java simples.
O formulário mais próximo é um projeto de utilitário, no entanto, a execução de um cliente de serviço da web Java simples (sem contêiner)
a partir de um projeto de utilitário não é suportada. Você deve criar um projeto Java simples antes de executar
o assistente de cliente de serviço da web. O nível de conformidade do Compilador do JDK para o
projeto Java simples deve ser configurado com a versão Java na qual o WebSphere
Application Server é executado.
Sobre Esta Tarefa
Para gerar um proxy de cliente Java e um aplicativo de amostra
a partir de um documento WSDL descoberto:
Procedimento
- Alterne para a perspectiva Java EE
(Janela > Abrir Perspectiva > Java EE).
- Clique em Arquivo > Novo > Outro. Selecione Serviços da Web para
exibir os diversos assistentes de serviço da web. Selecione o assistente do Cliente de Serviço da
Web. Clique em Avançar.
- Página Serviços da Web: selecione o arquivo WSDL que você usa para
gerar o cliente. Você pode, opcionalmente, fazer o seguinte:
- Selecione os estágios de desenvolvimento de cliente de serviço da web
que você deseja concluir usando a régua de controle. Isso configura vários valores
padrão nos painéis de assistente restantes.
- Desenvolver: desenvolve a definição de WSDL e a implementação do
cliente de serviço da web. Isto inclui tarefas como criar os módulos,
que contêm o código gerado, arquivos WSDL, descritores de implementação
e arquivos Java, quando apropriado.
- Montar: assegura que o projeto que hospeda o cliente de serviço da web
seja associado a um EAR quando requerido pelo servidor de aplicativos de
destino.
- Implementar: cria o código de implementação para o cliente.
- Instalar: instala e configura o módulo da web e EARs no
servidor de destino. Se quaisquer mudanças nos terminais do arquivo WSDL forem necessárias,
elas serão feitas nesse estágio.
- Iniciar: iniciará o servidor assim que o cliente tiver sido instalado
nele.
- Testar: fornece várias opções para testar o serviço, tal como
usar o Web Service Explorer ou JSPs de amostra.
- Selecione o servidor: o servidor padrão é exibido.
Se você quiser
implementar o serviço em um servidor diferente, clique no link para especificar
um servidor diferente.
Esta
tarefa suporta os ambientes de tempo de execução do servidor a seguir:
- WebSphere Application Server V7.0 ou posterior
- WebSphere Application
Server Liberty V8.5.5
- Selecione o tempo de execução: o tempo de execução padrão é exibido.
Se você quiser
implementar o serviço 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 é selecionado
na área de trabalho é exibido. Para selecionar um projeto e EAR
diferentes, clique no link do projeto. É possível selecionar um projeto da web,
um projeto EJB, um projeto Java
ou um projeto do cliente do aplicativo Java EE
como o local para o código do cliente. Assegure que o projeto
selecionado como o Projeto de Cliente da Web seja diferente do Projeto
da Web de Serviço, ou que o serviço seja sobrescrito pelos artefatos gerados do cliente.
Para serviços da web JAX-WS, os projetos de servidor e cliente podem compartilhar
o mesmo EAR.
- Monitorar o serviço da web: envia o tráfego do serviço da web
por meio 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. Como alternativa, é possível configurar manualmente um monitor TCP/IP
conforme descrito em Usando o Monitor TCP/IP para Testar Serviços da Web.
- Página de Configuração do Cliente de Serviço da Web do WebSphere
JAX-WS:
- Pasta de Saída: Selecione a pasta na qual você deseja que as classes Java do cliente sejam geradas ou
aceite o padrão.
- Pacote de destino: O assistente de cliente de serviços da web gera um número
de arquivos Java a partir do WSDL
especificado. Por padrão, ele cria um nome de pacote que é baseado no namespace
que é especificado no arquivo WSDL. Para substituir esse comportamento padrão,
você pode especificar seu próprio nome de pacote para o namespace no arquivo
WSDL.
- Gerar cliente móvel: Selecionar essa caixa de seleção permite que você mova
seu código do cliente de serviço da web de uma máquina para outra
ou de uma instância do WebSphere Application
Server para outra. Se essa opção for selecionada, o documento WSDL e
todo o esquema XML e outros documentos WSDL dos quais ele depende serão
copiados no projeto do cliente sob WEB-INF/wsdl e um file:relativeURL apontando
para essa cópia será, então, injetado no bloco de inicialização estático da classe
de Serviço do JAX-WS.
- Ativar chamada assíncrona para cliente gerado: Se você selecionar
para ativar um cliente assíncrono, para cada método no serviço da web,
mais dois métodos são criados. Esses métodos são métodos de pesquisa e de retorno
de chamada, que permitem que o cliente funcione assincronamente.
- Especificar arquivos de ligação do JAX-WS ou JAXB: Se você criou arquivos de ligação
customizada JAX-WS ou JAXB, selecione essa caixa de seleção para usá-los para criar
este serviço da web.
- Customizar nome da classe do proxy cliente: Você pode aceitar o nome de proxy padrão
ou digitar seu próprio nome.
- Gerar descritor de implementação do serviço da web: Para serviços da web JAX-WS,
informações de implementação são geradas dinamicamente pelo tempo de execução; descritores
de implementação estáticos não são mais necessários. A seleção desta caixa
de seleção os gera.
- Permitir extensões do fornecedor: Se você selecionar essa caixa de
seleção, a opção -extension será incluída no comando wsgen ou wsimport.
A opção -extension especifica se deve-se ativar
ou aceitar extensões customizadas para a funcionalidade não determinada pela
especificação JAX-WS. O uso das extensões pode resultar em aplicativos não portáteis ou que não interoperam com outras implementações.
Para obter detalhes, consulte os tópicos Comando wsgen para aplicativos JAX-WS e Comando wsimport para aplicativos JAX-WS
disponíveis no Centro de Informações para o WebSphere Application Server.
- Página de declaração de ligação customizada: Se você optou por
fornecer um arquivo de ligação do JAX-WS ou JAXB na página anterior, poderá
navegar para onde eles estão localizados.
- Página de configuração de geração de proxy: Se você selecionou customizar o nome da classe de proxy do cliente, utilize essa página para especificar um nome de classe de proxy para cada porta.
- Página de Teste do Cliente de Serviços da Web:
- Testar o proxy gerado: Se selecionado, o cliente de amostra é ativado
em um navegador da web que permite testar a função.
- Selecione o recurso de teste. É possível testar o proxy gerado no Web Service Explorer ou é possível gerar JPSs JAX-WS 2.0 de amostra.
- Pasta: Se você selecionou para testar o proxy por meio de uma JSP, poderá
selecionar a pasta na qual a JSP está localizada, e você pode selecionar os
métodos que são incluídos na JSP.
- Métodos: Selecionar os métodos a serem expostos. Se você selecionou para ativar
chamada assíncrona, os métodos assíncronos deverão ser listados
também.
- Executar teste no servidor: inicia o servidor para você automaticamente.
- Clique em Concluir. Se você selecionou para testar o proxy,
o cliente de teste é aberto em uma janela do navegador.
Resultados
O proxy do Java bean 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, é possível testar os métodos do serviço da web por meio do proxy, usando JSPs de amostra de serviços da web ou o Web Services Explorer.
- Se você selecionou para testar o serviço da web usando o Web
Services Explorer, o Explorer será aberto. Selecione a operação que você deseja
testar, insira as informações necessárias e clique em Ir. O resultado
é exibido na área de janela Status.
- Se você selecionou para testar um thin client Java,
a saída de sistema da execução de seu thin client Java será mostrada na visualização Console.
É possível executar o thin client Java
clicando em Executar na caixa de diálogo Configurações
de Execução. Como um aplicativo Java simples,
o cliente usa um JAR de contêiner de tempo de execução thin client do
WebSphere Application Server correspondente.