Utilizando HTTP para Transportar Solicitações de Serviços da Web para Aplicativos JAX-WS

É 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.

Por exemplo: [Windows]
app_server_root/bin wsgen.bat  -classpath . -wsdl -servicename {http://mynamespace}MyService example.Stock.MyService 
[AIX][HP-UX][Linux][Solaris]
app_server_root/bin wsgen.sh  -classpath . -wsdl -servicename {http://mynamespace}MyService example.Stock.MyService 
[IBM i]
app_server_root/bin wsgen  -classpath . -wsdl -servicename {http://mynamespace}MyService example.Stock.MyService 
Configurações suportadas Configurações suportadas: As ferramentas de linha de comandos wsimport, wsgen, schemagen e xjc não são suportadas na plataforma z/OS. Essa funcionalidade é permitida pelas ferramentas de montagem fornecidas com o WebSphere Application Server em execução na plataforma z/OS. Consulte sobre essas ferramentas de linha de comandos para aplicativos JAX-WS para saber mais sobre elas.sptcfg

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

  1. 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.
  2. 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.
  3. Implemente o aplicativo de serviços da Web.
  4. 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.

  5. (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.

  6. (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.

  7. 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.

O que Fazer Depois

Publicar o arquivo WSDL.

Ícone que indica o tipo de tópico Tópico de Tarefa



Ícone de registro de data e hora Última atualização: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=twbs_httptransportjaxws
Nome do arquivo: twbs_httptransportjaxws.html