Gerando um cliente de serviço da web a partir de um documento WSDL usando o ambiente de tempo de execução do IBM® WebSphere JAX-WS

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

  1. Alterne para a perspectiva Java EE (Janela > Abrir Perspectiva > Java EE).
  2. 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.
  3. Página Serviços da Web: selecione o arquivo WSDL que você usa para gerar o cliente. Você pode, opcionalmente, fazer o seguinte:
    1. 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.
    2. 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
    3. 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.
    4. 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.
    5. 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.
  4. 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.
  5. 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.
  6. 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.
  7. 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.
  8. 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.
Icon that indicates the type of topic Task topic
Timestamp icon Last updated: last_date

File name: tsampappjaxws.html