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
importar, seleccione a pasta Recursos Java: src e a partir do menu do ficheiro
seleccione 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:
- Mude para a perspectiva Java (Janela > Abrir perspectiva
> Java EE).
- 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:
- 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 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 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.
- 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.