Criar uma estrutura de bean Java de um documento WSDL utilizando o ambiente de tempo de execução Apache Axis

O assistente de Serviços Web auxilia na criação de uma estrutura de bean de um documento WSDL existente. A estrutura do bean 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 será substituída ao editar o bean.

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. Criar ou importar um ficheiro WSDL para a pasta Conteúdo da Web do projecto da Webt. Apenas pode utilizar um ficheiro WSDL que contenha um elemento de serviço.
Para criar um serviço Web de um ficheiro WSDL utilizando o ambiente de tempo de execução Apache Axis 1.0:
  1. Mude para a perspectiva J2EE (Janela > Abrir Perspectiva > J2EE).
  2. Na vista Explorador de Projecto, seleccione o ficheiro WSDL criado ou importado para a pasta de Conteúdo Web do seu projecto da Web.
  3. Clique em Ficheiro > Novo > Outros. Seleccione Serviços Web de forma a apresentar os diversos assistentes de serviços Web. Seleccione o assistente Serviço Web. Faça clique em Seguinte.
  4. Página Serviços Web: seleccione Serviço Web de bean Java de cima para baixo como o seu tipo de serviço Web e seleccione o artefacto a partir do qual será criado o serviço.
    1. Seleccione as etapas de desenvolvimento de serviços Web que pretende concluir com a ajuda da escala:
      • Desenvolver: cria o código do serviço
      • Montar:
      • Implementar: cria o código de implementação para o serviço
      • Instalar: instala o serviço no servidor escolhido
      • Iniciar: inicia o servidor assim que o serviço é instalado nesse serviço
      • Testar: fornece várias opções para testar o serviço
    2. Seleccione o seu servidor: é apresentado o servidor predefinido. Se pretende implementar o seu serviço num servidor diferente, faça clique na ligação para especificar um servidor diferente.
    3. Seleccione o seu tempo de execução: é apresentado o tempo de execução predefinido.Se pretende implementar o seu serviço num tempo de execução diferente, faça clique na ligação para especificar um tempo de execução diferente.
    4. Seleccione o projecto do serviço: é 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.
    5. Se pretende criar um cliente, seleccione o tipo de proxy a ser gerado e repita os passos acima mencionados para o cliente.
    6. Publicar o serviço Web: esta acção lança o Explorador de Serviços Web para publicar o seu serviço Web para um registo UDDI.
    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 Configuração do Bean Java™ da Estrutura de Serviços Web: Seleccione a pasta na qual será armazenado o bean Java gerado. Se pretende rever ou editar as correlações entre pacotes e espaços de nomes, seleccione a lista de selecção Definir correlação personalizada para o espaço de nome para o pacote. Faça clique em Seguinte.
  6. Página Espaço de Nome do Serviço Web para Correlações do Pacote: caso tenha seleccionado Definir correlação personalizada do pacote para espaço de nome no painel anterior, pode introduzir os seus pares de correlações personalizados, fazendo clique em Adicionar. Faça clique em Seguinte.
  7. Página Teste de Serviço Web: Se seleccionou a opção de testar o serviço Web, seleccione a função de teste para o serviço Web gerado. O serviço Web será aberto no Explorador de Serviços Web. Seleccione a operação que pretende testar, introduza as informações necessárias e faça clique em Continuar. Os resultados serão apresentados na área de janela Estado. Faça clique em Seguinte.
  8. Página Proxy de Serviço Web: caso tenha seleccionado gerar um proxy, esta página apresenta as opções para o mesmo. Enumera a pasta na qual o proxy irá ser gerado, sendo que o utilizador pode criar correlações personalizadas entre os espaços de nome e os pacotes. Faça clique em Seguinte.
  9. Página Teste de Cliente de Serviço Web: Utilize esta página para seleccionar as seguintes opções:
    1. Seleccione a função do seu teste. Pode testar o proxy gerado no Explorador de Serviços Web ou pode gerar um serviço Web JSP de amostra.
    2. Caso tenha seleccionado testar o proxy através de um JSP, pode seleccionar a pasta onde vai ficar localizado o JSP assim como os métodos que serão incluídos no JSP.
    3. Seleccione Executar teste no servidor para iniciar o servidor automaticamente.
  10. Página Publicação do Serviço Web: Caso tenha seleccionado publicar o seu serviço Web num registo UDDI, utilize esta página para lançar o Explorador de Serviços Web e seleccione o registo UDDI no qual será publicado o serviço Web. Faça clique em Terminar.
Após a criação do serviço Web, poderá ocorrer o seguinte, dependendo das opções seleccionadas:
  • Caso tenha seleccionado testar o proxy gerado, utilizando JSPs de serviços Web, o proxy é lançado num browser da Web na URL seguinte: http://localhost: port/ WebProjectClient/sampleBeanName/ WebServiceName/TestClient.jsp Pode utilizar esta aplicação de amostra para testar o serviço Web, seleccionando um método, introduzindo um valor para o método e fazendo clique em Invocar. O resultado do método será apresentado na área de janela de resultados.
  • Caso tenha seleccionado testar o serviço Web através da utilização do Explorador de Serviços Web, o Explorador é aberto. Seleccione a operação que pretende testar, introduza as informações necessárias e faça clique em Continuar. Os resultados serão apresentados na área de janela Estado.
  • Caso tenha seleccionado publicar o serviço Web, o Explorador de Serviços Web é iniciado com a apresentação da página necessária à publicação do seu serviço Web. Siga as instruções em Publicar o serviço Web para concluir esta tarefa.