É possível desenvolver um serviço da Web Java™ API for XML-Based Web Services call (JAX-WS) acessível para HTTP quando você já tem um objeto JavaBeans para ativar como um serviço da Web.
Antes de Iniciar
Você deve ter um objeto JAX-WS JavaBeans anotado para ativar como um serviço da Web. Opcionalmente, é possível executar o comando wsgen para criar um arquivo Web Services Description Language (WSDL) a partir do seu componente JAX-WS JavaBeans anotado. É necessário especificar a opção
-wsdl com o comando wsgen para criar o arquivo WSDL.
Para saber mais sobre o desenvolvimento de um serviço da Web JAX-WS usando anotações, leia sobre o desenvolvimento de artefatos Java para aplicativos JAX-WS usando JavaBeans.
Sobre Esta Tarefa
O servidor de aplicativos suporta o uso de HTTP para transportar solicitações de cliente de serviços da Web. Com HTTP, os seus clientes e servidores de serviços da Web podem se comunicar por meio de mensagens SOAP. SOAP é o protocolo de comunicação subjacente usado em serviços da Web que suporta os Serviços da Web para as especificações Java Platform, Enterprise Edition
(Java EE) e Java API for XML-Based Web Services call (JAX-WS).
HTTP é o transporte mais comumente usado para serviços da Web.
Procedimento
- Inclua uma ligação HTTP e um endereço SOAP no arquivo WSDL.
O arquivo WSDL de um serviço da Web deve incluir uma ligação HTTP e um endereço SOAP, que especifica uma sequência URL de terminal HTTP, que é acessível no transporte HTTP. Uma ligação HTTP é um elemento
wsdl:binding que contém um elemento soap:binding com um atributo de transporte
que termina em soap/http.
Além da ligação HTTP, um elemento wsdl:port que faça referência
à ligação HTTP deve ser incluído no elemento wsdl:service no arquivo
WSDL.
O elemento wsdl:port contém um elemento soap:address
com um atributo de local que especifica a cadeia URL de terminal HTTP.
Ao desenvolver o serviço da Web, é possível usar um marcador como file:unspecified_location para a sequência URL do terminal.
Nota: Se você implementar um componente JavaBeans como um serviço da Web sem um arquivo WSDL, um arquivo WSDL é automaticamente gerado para o componente.
- Para aplicativos de serviços da Web JAX-WS, nenhuma configuração de transporte HTTP é necessária. As configurações de transporte HTTP são geradas dinamicamente pelo servidor de
aplicativos. O arquivo web application archive {WAR) precisa apenas do objetoJavaBeans juntamente com o arquivo WSDL opcional adequadamente instalado.
- Implemente o aplicativo de serviços da Web.
- Configure a Segurança para o Transporte HTTP.
Para
configurar um transporte HTTP seguro, conecte a política
Transporte SSL ao aplicativo.
Para especificar o token de transporte de
autenticação básica, utilize o console de administração para configurar os
atributos do ID de usuário e senha na ligação de Transporte HTTP.
- (Opcional) Configure o gerenciamento de sessões HTTP.
O gerenciamento de sessão HTTP possibilita aos aplicativos de serviço da Web JAX-WS aparecerem dinâmicos para usuários do aplicativo.
- (Opcional) Configure
o listener de resposta assíncrona para clientes JAX-WS.
É
possível usar o listener de resposta assíncrona no Thin Client para JAX-WS
e em ambiente de aplicativo cliente para receber respostas para pedidos que são
chamados de forma assíncrona.
- Configure
as informações da URL do nó de extremidade para as ligações de HTTP.
O
publicador WSDL utiliza essa cadeia URL parcial para produzir a
URL HTTP real para cada componente de porta definido no arquivo
EAR (Enterprise Archive). O arquivo WSDL publicado pode ser usado por clientes que precisam chamar o serviço da Web.
Resultados
Você tem um objetoJavaBeans que usa HTTP para transportar solicitações de cliente de serviços da Web JAX-WS.