Criar um serviço Web a partir de um bean Java utilizando o ambiente de tempo de execução Apache Axis1

O assistente de Serviços Web auxilia na criação de um novo serviço Web, configurando-o para implementação e implementando o serviço Web num servidor. Uma vez implementado o serviço Web, o assistente auxilia na geração do proxy do cliente e na aplicação de teste para testar o serviço Web. Assim que concluir o teste, pode publicar o seu serviço Web num Registo de Negócio UDDI através da utilização do assistente de Exportação.

Pré-requisitos:
  1. Criar ou importar um bean para a pasta de origem Java™ do projecto da Web. Para importar, seleccione a pasta Recursos Java: src e a partir do menu do ficheiro seleccione Importar > Geral > Sistema de ficheiros e procure onde está o pacote.
Para criar um serviço Web de um bean utilizando o ambiente de tempo de execução Apache Axis1:
  1. Mude para a perspectiva Java (Janela > Abrir perspectiva > Java EE).
  2. Na vista Explorador do Projecto, seleccione o bean criado ou importado para a pasta de origem do seu projecto da Web.
  3. Faça 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 baixo para cima como o tipo do seu serviço Web e introduza a URI para o ficheiro WSDL, WSIL, ou HTML que será utilizado para gerar o serviço.
    1. Seleccione as etapas de desenvolvimento de serviços Web que pretende concluir com a ajuda da escala:
      • Programar: para programar a definição WSDL e a implementação do serviço da Web. Inclui tarefas como criar os módulos que vão conter o código gerado, ficheiros WSDL, descritores de implementação e ficheiros de Java sempre que seja apropriado.
      • Montar: garante que o projecto que alojará os serviços ou o cliente da Web é associado a um EAR sempre que o servidor da aplicação de destino assim o exija.
      • Implementar: cria o código de implementação do serviço.
      • Instalar: instala e configura o módulo e EARs da Web no servidor de destino.
      • Iniciar: inicia o servidor uma vez instalado o serviço. É gerado o ficheiro server-config.wsdd.
      • Testar: fornece várias opções para testar o serviço, como o uso do Explorador de serviços da Web ou ficheiros JSP amostra.
    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 Projecto da Web do Cliente difere do Projecto da Web de Serviço, ou o serviço será substituído pelos artefactos gerados pelo 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 Identidade de Bean Java do Serviço Web: o nome WSDL do serviço Web passará a constar da lista. Dispõe das seguinte opções:
    • Seleccionar os métodos para expor.
    • Seleccionar o estilo de codificação. RPC/Encoded é o estilo de codificação recomendado para o ambiente de tempo de execução. Este método de codificação não declara conformidade com WS-I.
    • Seleccione se pretende personalizar o pacote para as correlações do nome de espaço.
    Faça clique em Seguinte
  6. Página Pacote de serviço Web para correlações de espaço de nomes: se seleccionou Definir correlação personalizada para pacote para espaço de nomes no painel anterior, pode inserir os pares de correlações personalizadas neste painel fazendo clique em Adicionar. Pode igualmente fazer clique em Importar para importar pares de correlação personalizados de um ficheiro .properties. O conteúdo do ficheiro de propriedades tem de ser do formato pacote=espaço de nomes. Terá de abandonar alguns caracteres especiais nos ficheiros de propriedades. Por exemplo, somePackage=http://someNamespace deve ser somePackage=http\://someNamespace. Caso contrário, os dois pontos (:) seriam tratados como delimitador resultando na tentativa de correlacionar somePackage com httpsomeNamespace=somePackage.
  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 um proxy, selecciona consoante pretenda personalizar o pacote para as correlações de espaço de nome.
  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 de Serviço Web: Seleccione se pretende ou não publicar este serviço Web num registo UDDI. Faça clique em Terminar Nota: poderá ser emitido um aviso com a mensagem Ocorreu um erro ao gerar WSDL Java. Classe Não Encontrada: <nome de bean>. Este erro pode ser ignorado sem que daí resulte algum problema.
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.

Importante: Se os seus métodos contêm tipos não suportados pela amostra, tais como matrizes, propriedades indexadas e colecções, os métodos são omitidos na amostra e o utilizador recebe uma mensagem de aviso.

Conceitos relacionados
Criar serviços Web com o ambiente de tempo de execução Apache Axis1