O assistente de Serviços Web auxilia na criação de uma estrutura de bean
de um documento WSDL existente. O bean de estrutura 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:
- 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
- Criar ou importar um ficheiro WSDL para a pasta Conteúdo da Web do projecto da Web.
Apenas pode utilizar um ficheiro WSDL que contenha um elemento de serviço.
Para criar um serviço web a partir de um ficheiro WSDL utilizando o ambiente de tempo de execução Axis1 da Apache:
- Mude para a perspectiva Java (Janela > Abrir perspectiva
> Java EE).
- Na vista Explorador de Projecto, seleccione o ficheiro
WSDL criado ou importado para a pasta de Conteúdo Web do seu projecto da Web.
- 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.
- 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.
- 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.
- 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.
- 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.
- 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.
- Se pretende criar um cliente, seleccione o
tipo de proxy a ser gerado e repita os passos acima mencionados para o
cliente.
- 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.
- 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
- 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.
- Página Espaço de nomes de serviço Web para correlações de pacotes: 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 espaço de nomes=pacote.
Terá de abandonar alguns caracteres especiais nos ficheiros de propriedades.
Por exemplo, http://someNamespace=somePackage deve ser http\://someNamespace=somePackage.
Caso contrário, os dois pontos (:) seriam tratados como delimitador resultando na tentativa
de correlacionar http com //someNamespace=somePackage.
- 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.
- 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.
- Página Teste de Cliente de Serviço Web: Utilize
esta página para seleccionar as seguintes opções:
- 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.
- 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.
- Seleccione Executar teste no servidor
para iniciar o servidor automaticamente.
- 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.