Montando um Arquivo JAR do Cliente Ativado para serviços da Web em um Arquivo EAR

Agora que você gerou os artefatos do seu aplicativo, é necessário montar esses artefatos para criar um arquivo enterprise archive (EAR) que é usado no aplicativo de serviços da Web.

Antes de Iniciar

Para Java™ API para aplicativos de serviços da Web XML-Based Web Services (JAX-WS), são necessários os artefatos móveis gerados pela ferramenta de linha de comandos wsimport ao iniciar a partir de um arquivo WSDL para concluir essa tarefa. A ferramenta wsimport processa um arquivo WSDL como entrada e gera os seguintes artefatos portáteis:
  • SEI (Interface de Terminal de Serviço)
  • Classe de Serviço
  • Classe de exceção que é mapeada a partir da classe wsdl:fault (se houver uma)
  • O JAXB (Java Architecture for XML Binding) gerou valores de tipo que são classes Java mapeadas a partir dos tipos de esquema XML
  • Um módulo cliente montado que contenha a implementação, todas as classes geradas pela ferramenta de linha de comandos wsimport e o descritor de implementação ejb-jar.xml ou o descritor de implementação application-client.xml. Esse módulo pode ser:
    • Um módulo cliente aplicativo que contenha o arquivo META-INF/application-client.xml.
    • Um módulo EJB (Enterprise JavaBeans) que contenha o arquivo META-INF/ejb-jar.xml.
Para Java API para aplicativos de serviço da Web XML-based RPC (JAX-RPC), você precisa dos seguintes artefatos que são gerados a partir da ferramenta de linha de comandos WSDL2Java para concluir essa tarefa:
  • Um módulo cliente montado que contenha a implementação, todas as classes geradas pela ferramenta de linha de comandos WSDL2Java e o descritor de implementação ejb-jar.xml ou o descritor de implementação application-client.xml. Esse módulo pode ser:
    • Um módulo cliente aplicativo que contenha o arquivo META-INF/application-client.xml.
    • Um módulo EJB (Enterprise JavaBeans) que contenha o arquivo META-INF/ejb-jar.xml.
  • O arquivo da WSDL que foi utilizado para desenvolver o cliente.
  • Os gabaritos para os descritores de implementação ibm-webservicesclient-ext.xmi e ibm-webservicesclient-bnd.xmi, se tiverem sido utilizados.
  • Um descritor de implementação de mapeamento de JAX-RPC (Java API for XML-based remote procedure call).
Restrição: Não inclua o símbolo # no nome dos arquivos que são empacotados em um archive de aplicativo. Devido ao processamento interno, o servidor do aplicativos não conseguirá implementar corretamente o aplicativo se o símbolo # for incluído em um nome do arquivo dentro do archive de aplicativo. Se essa falha ocorrer, poderá haver uma exceção quando o aplicativo estiver sendo processado. Além disso, partes do aplicativo poderão estar ausentes depois que o aplicativo for implementado. Para resolver esse problema, renomeie quaisquer nomes de arquivos no archive do aplicativo para que eles não contenham esse símbolo.

Sobre Esta Tarefa

É possível usar ferramentas do conjunto incluídas com o WebSphere Application Server para montar aplicativos de clientes ativados para serviços da Web.

Monte o código e os artefatos do cliente que possibilitem ao aplicativo cliente acessar um serviço da Web com as etapas fornecidas:

Procedimento

  1. Inicie uma ferramenta de montagem. Leia sobre como iniciar a ferramenta de montagem na documentação do Rational Application Developer.
  2. Se você ainda não fez isso, configure a ferramenta de montagem para que ela funcione em módulos Java EE. Você precisa ter certeza de que as categorias Java EE e Web estejam ativadas. Leia sobre como configurar a ferramenta de montagem na documentação do Rational Application Developer.
  3. Importe a implementação de cliente e os artefatos gerados pela ferramenta de linha de comandos para a ferramenta de montagem.
  4. Migre os arquivos JAR criados com a ferramenta de montagem Rational Application Developer. Para migrar os arquivos, importe seus arquivos JAR para a ferramenta de montagem. Leia sobre como migrar artefatos de código para uma ferramenta de montagem na documentação do Rational Application Developer.
  5. Monte o arquivo JAR em um arquivo EAR (Enterprise Archive) utilizando técnicas típicas de montagem se o cliente for executado em um contêiner.

Resultados

Você montou os artefatos necessários para ativar o aplicativo cliente para serviços da Web em um arquivo EAR.

Exemplo

Este exemplo do processo de montagem utiliza o arquivo JAR AddressBookClient.jar e o arquivo EAR AddressBookClient.ear:
META-INF/MANIFEST.MF
META-INF/application-client.xml
META-INF/wsdl/AddressBook.wsdl
META-INF/AddressBook_mapping.xml

com/ibm/websphere/samples/webservices/addr/Address.class
com/ibm/websphere/samples/webservices/addr/AddressBook.class
com/ibm/websphere/samples/webservices/addr/AddressBookClient.class
com/ibm/websphere/samples/webservices/addr/AddressBookService.class
...outras classes geradas...
Após a montagem do arquivo AddressBookClient.jar no arquivo AddressBookClient.ear, o arquivo AddressBookClient.ear conterá os seguintes arquivos:
META-INF/MANIFEST.MF 
AddressBookClient.jar 
META-INF/application.xml

O que Fazer Depois

Para Java API para aplicativos XML-Based Web Services (JAX-WS), você está pronto para implementar o aplicativo cliente dos serviços da Web.

Para Java API para aplicativos XML-based RPC (JAX-RPC), você precisa configurar as ligações do descritor de implementação com uma ferramenta do conjunto para que o cliente possa se comunicar com um serviço da Web que esteja implementado em um servidor.


Í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_assembclient
Nome do arquivo: twbs_assembclient.html