Criando um Esboço de Java Bean a Partir de um Documento WSDL Usando o Ambiente de Tempo de Execução Apache Axis

O assistente Serviço da Web auxilia na criação de um bean de esboço a partir de um documento WSDL existente. O bean de esboço contém um conjunto de métodos que correspondem às operações descritas no documento WSDL. Quando o bean é criado, cada método tem uma implementação trivial que você substitui editando o bean.

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. Crie ou importe um arquivo WSDL para a pasta Conteúdo da Web do projeto da Web. Você só pode utilizar um arquivo WSDL que contenha um elemento de serviço.
Para criar um serviço da Web a partir de um arquivo WSDL usando o ambiente de tempo de execução Apache Axis 1.0:
  1. Mude para a perspectiva J2EE ( Janela > Abrir Perspectiva > J2EE).
  2. Na visualização do Project Explorer, selecione o arquivo WSDL que você criou ou importou para a pasta Conteúdo da Web de seu projeto da Web.
  3. Clique em Arquivo > Novo > Outro. Selecione Serviços da Web para exibir os diversos assistentes de serviços da Web. Selecione o assistente Serviço da Web. Clique em Avançar.
  4. Página Serviços da Web: selecione Serviço da Web Java bean Descendente como o tipo do serviço da Web, e selecione o artefato do qual o serviço irá ser criado.
    1. 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 serviço
      • Montar:
      • Implementar: isto criará o código de implementação para o serviço
      • Instalar: isto instalará o serviço no servidor escolhido
      • Iniciar: isto iniciará o servidor depois que o serviço tiver sido instalado nele
      • Testar: isto fornecerá diversas opções para testar o serviço
    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.
    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 serviço: 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.
    5. Se você quiser criar um cliente, selecione o tipo de proxy a ser gerado e repita as etapas acima para o cliente.
    6. Publique o serviço da Web: isto ativará o Web Services Explorer para publicar o serviço da Web em um registro UDDI.
    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 Configuração de Java de Esboço de Serviços da Web: selecione a pasta na qual o Java gerado irá ser armazenado. Se quiser revisar ou editar os mapeamentos entre pacotes e espaços de nomes, selecione a caixa de opções Definir mapeamento padrão para espaço de nomes para pacote. Clique em Avançar.
  6. Página Mapeamento de Espaço de Nomes do Serviço da Web para Pacote: se você selecionou Definir mapeamento customizado para pacote para espaço de nomes na página anterior, poderá inserir os pares de mapeamento customizado neste painel clicando em Incluir. Clique em Avançar.
  7. Página Teste do Serviço da Web: se você selecionou testar o serviço da Web, selecione o recurso de teste para o serviço da Web gerado.Isso abrirá o serviço da Web no Web Services Explorer. 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. Clique em Avançar.
  8. Página Proxy do Serviço da Web: se você tiver selecionado gerar um proxy, esta página 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. Clique em Avançar.
  9. Página Teste do Cliente do Serviço da Web: Use esta página para selecionar as seguintes opções:
    1. Selecione o recurso de teste. Você pode testar o proxy gerado no Web Service Explorer ou pode gerar uma JSP de amostra do serviço da Web.
    2. Se você selecionou testar o proxy por meio de uma JSP, poderá selecionar a pasta na qual a JSP estará localizada e os métodos que serão incluídos na JSP.
    3. Selecione Executar teste no servidor para iniciar o servidor automaticamente.
  10. Página Publicação do Serviço da Web: se você tiver selecionado publicar o serviço da Web em um registro UDDI, use esta página para ativar o Web Services Explorer e selecione o registro UDDI no qual o serviço da Web irá ser publicado. Clique em Concluir.
Depois que o serviço da Web for criado, o seguinte pode ocorrer, dependendo das opções selecionadas:
  • 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.
  • Se você tiver selecionado publicar o serviço da Web, o Web Services Explorer será ativado exibindo a página necessária para publicar o serviço da Web. Siga as instruções em Publicando o Serviço da Web para concluir esta tarefa.