Gerar um proxy de cliente Java e uma aplicação exemplo de um documento WSDL através da utilização do ambiente de tempo de execução Axis

O assistente Cliente de Serviço Web auxilia na geração de um proxy de bean Java™ e de uma aplicação de amostra. A aplicação exemplo da Web demonstra como codificar um ficheiro de proxy.

Pré-requisitos:

  1. Se estiver a utilizar um contentor servlet Apache Jakarta Tomcat como seu servidor, tem de o instalar, configurar uma instância sua e criar um projecto da Web por ele visado, como está descrito em Criar um Servidor Apache Tomcat e um projecto da Web
  2. Localize e importe um documento WSDL para o projecto da Web. Apenas pode utilizar um ficheiro WSDL que contenha um elemento de serviço.
Para gerar um proxy de cliente Java e uma aplicação exemplo a partir de um documento WSDL localizado:
  1. Mude para a perspectiva J2EE (Janela > Abrir Perspectiva > J2EE).
  2. Na vista Navegador, seleccione o projecto da Web no qual pretende gerar um aplicação de amostra.
  3. Clique em Ficheiro > Novo > Outros. Seleccione Serviços Web de forma a apresentar os diversos assistentes de serviços Web. Seleccione o assistente Cliente de Serviço Web. Faça clique em Seguinte.
  4. Página Serviços Web:
    1. Introduza o URI para o ficheiro WSDL, WSIL ou HTML que será utilizado para gerar o cliente.
    2. Seleccione o tipo de proxy a ser gerado
    3. Seleccione as etapas de desenvolvimento de serviços Web que pretende concluir com a ajuda da escala:
      • Desenvolver: cria o código do cliente
      • Montar:
      • Implementar: cria o código de implementação para o cliente
      • Instalar: instala o cliente no servidor escolhido
      • Iniciar: inicia o servidor assim que o cliente é instalado nesse serviço
      • Testar: fornece várias opções para testar o cliente
    4. Seleccione o seu servidor: é apresentado o servidor predefinido. Se pretende implementar o seu cliente num servidor diferente, faça clique na ligação para especificar um servidor diferente.
    5. Seleccione o seu tempo de execução: é apresentado o tempo de execução predefinido.Se pretende implementar o seu cliente num tempo de execução diferente, faça clique na ligação para especificar um tempo de execução diferente.
    6. Seleccione o projecto do cliente: é apresentado o projecto que contém o projecto seleccionado no seu espaço de trabalho. Para seleccionar um projecto diferente e de Aplicação Empresarial (EAR - Enterprise Archive), faça clique na ligação do projecto. Certifique-se de que o projecto seleccionado como o Projecto da Web de Cliente é diferente do Projecto da Web de Serviço, caso contrário, o serviço será substituído pelos artefactos gerados do cliente.
    7. Supervisionar o serviço Web: esta acção envia o tráfego do serviço Web através do Supervisor TCP/IP, o que permite observar o tráfego SOAP gerado pelo serviço Web e testar este tráfego para obter conformidade WS-I. Alternativamente, pode definir manualmente um Monitor TCP/IP como está descrito em Utilizar o Monitor TCP/IP para testar serviços Web
  5. Página Proxy de Serviço Web: Este painel apresenta as opções para o proxy. Enumera a pasta na qual o proxy irá ser gerado, sendo que, opcionalmente, o utilizador pode criar correlações personalizadas entre os espaços de nome e os pacotes.
  6. Página Espaço de Nome do Serviço Web para Correlações do Pacote: caso tenha seleccionado Definir correlação personalizada de espaço de nome para o pacote na página anterior, pode introduzir os seus pares de correlações personalizados nesta página, fazendo clique em Adicionar.
  7. Página Teste de Cliente de Serviço Web: Esta página é apresentada caso seleccione testar o seu cliente. Seleccione a função de teste que utilizará para testar o proxy e os métodos que pretende que sejam incluídos no mesmo. Tenha em consideração que o Cliente de Teste Universal (UTC - Universal Test Client) apenas é compatível com clientes de serviços Web implementados em servidores WebSphere®.
  8. Clique em Terminar.Caso tenha seleccionado testar o proxy, o cliente de teste será aberto numa janela do browser.

O proxy do bean Java gerado faculta uma interface de chamada de procedimento remoto para o serviço Web. A aplicação da Web da amostra demonstra como codificar o ficheiro proxy.

Após ter gerado o seu proxy de cliente Java, pode testar os métodos do serviço Web através do proxy, ao utilizar JSPs de amostra de Serviços Web ou o cliente de teste Universal.

Para obter mais informações sobre como criar um projecto Web, consulte a documentação do desenvolvimento de aplicações Web.