Gerando um Proxy de Cliente Java e um Aplicativo de Amostra a Partir de um Documento WSDL Usando o ambiente de Tempo de Execução Axis

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:

  1. 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
  2. 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:
  1. Mude para a perspectiva J2EE ( Janela > Abrir Perspectiva > J2EE).
  2. Na visualização Navegador, selecione o projeto da Web no qual você deseja gerar um aplicativo de amostra.
  3. 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.
  4. Página Serviços da Web:
    1. Digite o URI para o arquivo WSDL, WSIL ou HTML que será utilizado para gerar o cliente.
    2. Selecione o tipo de proxy a ser gerado
    3. 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
    4. 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.
    5. 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.
    6. 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.
    7. 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
  5. 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.
  6. 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.
  7. 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.
  8. 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.

Para obter mais informações sobre como criar um projeto da Web, consulte a documentação de desenvolvimento de aplicativo da Web.