Ativando um Arquivo EAR para Serviços da Web com o Comando endptEnabler

Use a ferramenta de linha de comandos endptEnabler para ativar um arquivo enterprise archive (EAR) para módulos Enterprise JavaBeans (EJB) que contêm serviços da Web e para especificar se os serviços da Web são expostos usando SOAP sobre Java™ Message Service (JMS) ou SOAP sobre HTTP.

Antes de Iniciar

Antes de realizar essa tarefa, você precisa montar um enterprise Java archive (JAR) ativado para serviços da Web em um arquivo EAR.

Sobre Esta Tarefa

A ferramenta de linha de comandos endptEnabler inclui um ou mais módulos roteadores no arquivo EAR para cada módulo JAR (Java Archive) de enterprise bean ativado pelo serviço da Web com base no JAX-WS (Java API for XML Web Services) ou no JAX-RPC (Java API for XML-based RPC) no arquivo EAR. Um módulo roteador fornece um terminal para o serviço da Web em um módulo JAR de enterprise bean particular.

Cada módulo roteador suporta um transporte específico, como HTTP ou JMS. Um módulo roteador HTTP é um módulo web application archive (WAR) que fornece um terminal HTTP para cada um dos serviços da Web contidos dentro de um módulo JHAR de enterprise bean particular. Da mesma forma, um módulo roteador JMS é um módulo JAR de enterprise bean que contém um Message Driven Bean (MDB) que serve como o listener da mensagem para pedidos destinados para os terminais de serviço da Web.

Se não houver nenhum módulo JAR de enterprise bean no arquivo EAR, não será necessário utilizar essa ferramenta.

Procedimento

  1. [IBM i]Chame o script endptEnabler na linha de comando Qshell a partir do diretório app_server_root/bin. [AIX Solaris HP-UX Linux Windows][z/OS]Chame o comando endptEnabler a partir do diretório install_root/bin.
  2. Insira o nome do arquivo EAR, quando solicitado.
  3. Digite vários valores de entrada, conforme forem pedidos pelo comando endptEnabler. Vários valores de entrada são solicitados a você para cada módulo JAR de enterprise bean que é ativado para serviços da Web no arquivo EAR. Em geral, você aceita os padrões para cada aviso. Para saber sobre as propriedades deste comando, consulte a documentação do comando endptEnabler.
    1. Especifique um módulo roteador HTTP para transportar o seu serviço da Web baseado em EJB. Use a opção -transport http para indicar que o serviço da Web está disponível usando HTTP. Um módulo roteador é criado para cada arquivo JAR enterprise bean que contém serviços da Web JAX-WS ou JAX-RPC.
    2. Especifique um módulo roteador JMS para transportar o seu serviço da Web baseado em EJB. Use a opção -transport jms para indicar que o serviço da Web está disponível usando JMS. Um módulo roteador é criado para cada arquivo JAR enterprise bean que contém serviços da Web JAX-WS ou JAX-RPC.

Resultados

Um módulo roteador HTTP ou JMS é incluído no arquivo EAR para cada módulo JAR enterprise bean dentro do arquivo EAR que contém terminais de serviços da Web. Para HTTP, uma raiz de contexto é configurada para o aplicativo para que o serviço da Web possa ser chamado por meio de um endereço da Web. O endereço da Web usado para chamar o serviço da Web é:
http://host[:port]/<context-root>/services/<port-component-name>

Certifique-se de que você instalou o módulo roteador HTTP ou Sistema de Mensagens Java (JMS) que foi gerado com o comando endptEnabler no mesmo destino dos seus arquivos JAR de enterprise bean de serviços da Web. Esses módulos roteadores HTTP ou JMS estão inclusos em seu aplicativo de serviços da Web e precisam utilizar as bibliotecas de tempo de execução do servidor de aplicativos.

O que Fazer Depois

Implemente o arquivo EAR no servidor de aplicativos. Um arquivo EAR montado que está ativado para serviços da Web é necessário para implementação.

Se estiver usando JMS como um transporte para as suas solicitações de serviço da Web, defina os vários objetos JMS como filas, tópicos ou conexões fábricas, que serão usados pelo seu aplicativo antes de instalar o aplicativo.


Í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_endptenablerendpt
Nome do arquivo: twbs_endptenablerendpt.html