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
- 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.
- 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).
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
- Inicie uma ferramenta de montagem. Leia sobre como iniciar a ferramenta de montagem na documentação do Rational Application Developer.
- 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.
- Importe a implementação de cliente e os artefatos gerados pela ferramenta de linha de comandos para a ferramenta de montagem.
- 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.
- 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
Exemplo
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...
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.