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:
- Se
estiver a utilizar o contentor servlet Apache Jakarta Tomcat como o seu
servidor, deve instalá-lo, configurar uma instância do mesmo e criar um
projecto da Web de destino, como está descrito em
Criar um servidor Apache Tomcat e projecto da Web
- Criar ou importar um bean para a pasta de origem Java™ do projecto da Web.
Para criar um serviço Web de um bean utilizando o ambiente de tempo de
execução Apache Axis:
- Mude para a perspectiva J2EE (Janela > Abrir Perspectiva > J2EE).
- Na vista Explorador do Projecto, seleccione o
bean criado ou importado para a pasta de origem do seu projecto da Web.
- 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.
- 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.
- 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
- 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 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.
- 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 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
- Página Pacote de Serviço Web para Correlações de
Espaço de Nome: caso tenha seleccionado
Definir correlação personalizada de pacote para espaço
de nome no painel anterior, pode introduzir os seus pares de correlações
personalizados neste painel, fazendo clique em
Adicionar.
- 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 um proxy, selecciona consoante pretenda personalizar o pacote
para as correlações de espaço de nome.
- 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 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.