Serviços da Web do JAX-RPC |
|
|
![]() |
|
Configurar e Executar | Notas Técnicas | Javadoc | Construir com Ant | |
Para uma discussão sobre serviços da Web, consulte a documentação IBM WebSphere Web services no Centro de Informações. |
|
A Amostra AddressBook ilustra o acesso ao Serviço da Web de várias maneiras. A amostra inclui dois clientes e quatro variações do mesmo bean AddressBook. Os dois clientes são um cliente J2SE (Java 2 Standard Edition) e um cliente J2EE (Java 2 Enterprise Edition). Cada cliente aplica as quatro variações do bean AddressBook que são implementadas no servidor. Localizando Código-fonteVocê pode localizar o código-fonte da amostra AddressBook nos subdiretórios de raiz_do_perfil/samples/src/WebServicesSamples. O código-fonte para cada um dos quatro beans do aplicativo AddressBook está em um subdiretório denominado conforme mostrado na tabela abaixo. O código-fonte do cliente J2SE simples está no diretório Clients/simpleClients/samples/address. O código-fonte do cliente aplicativo J2EE está em Clients/applicationClients/AddressBookClient. Clientes do z/OS: A árvore de códigos fonte para as Amostras não é fornecida na plataforma z/OS, pois os aplicativos de Amostra não são construídos na plataforma z/OS. As quatro variações dos beans de aplicativo ilustram diferentes abordagens para desenvolver um aplicativo ativado para os serviços da Web. Há dois EJBs (Enterprise JavaBeans), cada um construído utilizando uma abordagem diferente. Uma abordagem demonstra a construção de um bean de serviços da Web iniciando com um arquivo WSDL (Web Service Definition Language) e utiliza a ferramenta WSDL2Java para gerar o código ou ligações Java. Os artefatos desse EJB incluem "W2JE" para diferenciá-los das outras versões. Um segundo bean corporativo será construído iniciando com um EJB implementado e utilizando a ferramenta Java2WSDL para gerar seu arquivo WSDL. O arquivo WSDL é utilizado para gerar os descritores de implementação. Os artefatos desse bean corporativo são designados com "J2WE". De modo semelhante, os artefatos dos dois JavaBeans contêm a cadeia "J2WB" ou "W2JB" indicando a abordagem específica. A tabela a seguir mostra como os quatro beans AddressBook são denominados. | |
Porta | Diretório | Classe da Implementação | Demonstra |
---|---|---|---|
AddressBookW2JE | addrEJBTopDown | AddressBookSoapBindingImpl.java | Um bean corporativo Serviço da Web desenvolvido iniciando com um arquivo WSDL e utilizando a ferramenta WSDL2Java para gerar o código Java para o bean corporativo. |
AddressBookJ2WE | addrEJBBottomUp | AddressBookBeanImpl.java | Um bean corporativo Serviço da Web desenvolvido iniciando com um bean e utilizando a ferramenta Java2WSDL para gerar um arquivo WSDL a partir do qual os descritores de implementação são criados. |
AddressBookJ2WB | addrBeanBottomUp | AddressBookBean.java | Um JavaBean Serviço da Web desenvolvido iniciando com um bean e utilizando a ferramenta Java2WSDL para gerar um arquivo WSDL a partir do qual os descritores de implementação são criados. |
AddressBookW2JB | addrBeanTopDown | AddressBookBean.java | Um JavaBean Serviço da Web desenvolvido iniciando com WSDL e utilizando a ferramenta WSDL2Java para gerar o código Java para o bean. |
Você pode localizar os diretórios denominados na tabela sob o diretório, raiz_do_perfil/samples/src/WebServicesSamples.
Cada implementação do serviço AddressBook suporta a operação getAddressFromName. A operação retorna uma resposta estática para o cliente. Não há nenhum armazenamento de bancos de dados de endereços. A finalidade desta amostra é mostrar o relacionamento entre um bean e um Serviço da Web.
Todas as versões do serviço AddressBook estão no arquivo WebServicesSamples.ear. Os nomes exclusivos do contexto da raiz e do jar permitem uma implementação simultânea. Além disso, as classes de implementação EJB são nomeadas exclusivamente e diferem das classes de implementação JavaBean. Essa exclusividade assegura que o classloader no servidor localize a classe de implementação apropriada.
A Amostra inclui dois clientes, um cliente J2SE e um cliente J2EE. Cada cliente aplica as quatro variações do bean AddressBook que são implementadas no servidor.
O relacionamento entre os quatro beans implementados no servidor pode ser consultado no arquivo WSDL do cliente, que está habilitado para acesso do cliente a qualquer um dos quatro beans. O arquivo WSDL define um serviço, AddressBookService, com quatro portas. O cliente AddressBook.wsdl está localizado no diretório Samples, src/WebServicesSamples/Clients/applicationClients/META-INF.