O assistente Serviço da Web auxilia na criação de um bean de esboço
a partir de um documento WSDL existente. O bean de esboço 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 você substitui editando o bean.
Pré-requisitos:
- Se você estiver usando o contêiner de servlet Apache Jakarta Tomcat
como seu servidor, precisará instalá-lo, configurar uma instância dele e criar
um projeto da Web destinado a ele conforme descrito em Criando um servidor Apache Tomcat e um projeto da Web
- Crie ou importe um arquivo WSDL para a pasta Conteúdo da Web do projeto da Web.
Você só pode utilizar um
arquivo WSDL que contenha um elemento de serviço.
Para criar um serviço da Web a partir de um arquivo WSDL usando o ambiente de tempo de execução
Apache Axis 1.0:
- Mude para a perspectiva J2EE ( Janela > Abrir Perspectiva
> J2EE).
- Na visualização do Project Explorer, selecione o arquivo WSDL que você criou ou
importou para a pasta Conteúdo da Web de seu projeto da Web.
- Clique em Arquivo > Novo > Outro. Selecione
Serviços da Web para exibir os diversos assistentes de
serviços da Web. Selecione o assistente Serviço da Web. Clique em Avançar.
- Página Serviços da Web: selecione Serviço da Web Java bean Descendente como
o tipo do serviço da Web, e selecione o artefato do qual o serviço irá
ser criado.
- Selecione os estágios de desenvolvimento de serviços da Web que você deseja concluir
usando a barra deslizante:
- Desenvolver: isto criará o código do serviço
- Montar:
- Implementar: isto criará o código de implementação para o serviço
- Instalar: isto instalará o serviço no servidor escolhido
- Iniciar: isto iniciará o servidor depois que o serviço tiver sido instalado
nele
- Testar: isto fornecerá diversas opções para testar o serviço
- Selecione o servidor: o servidor padrão é exibido. Se você quiser
implementar o serviço em um servidor diferente, clique no link para especificar
um servidor diferente.
- Selecione o tempo de execução: o tempo de execução padrão é exibido. Se você quiser
implementar o serviço em um tempo de execução diferente, clique no link para especificar
um tempo de execução diferente.
- Selecione o projeto do serviço: o projeto que contém o projeto
selecionado no espaço de trabalho é exibido. Para selecionar um projeto e EAR diferentes,
clique no link do projeto. Assegure-se
de que o projeto selecionado como o Projeto de Cliente da Web seja diferente do Projeto
de Serviço da Web, ou o serviço será sobrescrito pelos artefatos gerados do cliente.
- Se você quiser criar um cliente, selecione o tipo de proxy a ser
gerado e repita as etapas acima para o cliente.
- Publique o serviço da Web: isto ativará o Web Services Explorer
para publicar o serviço da Web em um registro UDDI.
- Monitorar o serviço da Web: isto enviará o tráfego do serviço da Web
através do Monitor TCP/IP, o que permite observar o tráfego SOAP gerado pelo serviço da Web
e testar esse tráfego para conformidade com WS-I. Alternativamente,
é possível configurar manualmente um monitor TCP/IP conforme descrito em Usando o Monitor TCP/IP para Testar Serviços da Web
- Página Configuração de Java de Esboço de Serviços da Web: selecione a
pasta na qual o Java gerado irá ser armazenado. Se quiser revisar
ou editar os mapeamentos entre pacotes e espaços de nomes, selecione a caixa de opções Definir
mapeamento padrão para espaço de nomes para pacote. Clique em Avançar.
- Página Mapeamento de Espaço de Nomes do Serviço da Web para Pacote: se você selecionou
Definir mapeamento customizado para pacote para espaço de nomes na
página anterior, poderá inserir os pares de mapeamento customizado neste painel
clicando em Incluir. Clique em Avançar.
- Página Teste do Serviço da Web: se você selecionou testar o serviço da Web,
selecione o recurso de teste para o serviço da Web gerado.Isso abrirá
o serviço da Web no Web Services Explorer. Selecione a operação que deseja
testar, digite as informações necessárias e clique em Ir.
O resultado será exibido na área de janela Status. Clique em Avançar.
- Página Proxy do Serviço da Web: se você tiver selecionado gerar um proxy,
esta página mostra as opções para o proxy. Ele lista a pasta na qual o proxy
será gerado, e você pode opcionalmente criar mapeamentos customizados entre espaços de nomes
e pacotes. Clique em Avançar.
- Página Teste do Cliente do Serviço da Web: Use esta página para selecionar as seguintes
opções:
- Selecione o recurso de teste. Você pode testar o proxy gerado
no Web Service Explorer ou pode gerar uma JSP de amostra do serviço da Web.
- Se você selecionou testar o proxy por meio de uma JSP, poderá selecionar
a pasta na qual a JSP estará localizada e os métodos que serão
incluídos na JSP.
- Selecione Executar teste no servidor para iniciar o
servidor automaticamente.
- Página Publicação do Serviço da Web: se você tiver selecionado publicar o
serviço da Web em um registro UDDI, use esta página para ativar o Web Services Explorer
e selecione o registro UDDI no qual o serviço da Web irá ser publicado. Clique em Concluir.
Depois que o serviço da Web for criado,
o seguinte pode ocorrer, dependendo das opções selecionadas:
- Se você selecionou testar o proxy gerado usando JSPs do serviço da Web,
o proxy será ativado em um navegador da Web na seguinte URL: http://localhost: porta/ WebProjectClient/sampleBeanName/ WebServiceName/TestClient.jsp Você pode utilizar
esse aplicativo de amostra para testar o serviço da Web selecionando um método, digitando um
valor para o método e clicando em Chamar. O resultado do
método será exibido na área de janela de resultados.
- Se você tiver selecionado testar o serviço da Web usando o Web Services Explorer,
o Explorer será aberto. Selecione a operação que deseja testar, digite as informações
necessárias e clique em Ir. O resultado será exibido na área de janela Status.
- Se você tiver selecionado publicar o serviço da Web, o Web Services Explorer
será ativado exibindo a página necessária para publicar o serviço da Web. Siga as
instruções em Publicando o Serviço da Web para concluir
esta tarefa.