Introdução

Este artigo apresenta aos desenvolvedores de J2EE as etapas existentes no desenvolvimento de uma solução simples para demonstrar integração entre WebSphere Enterprise Service Bus V7 (daqui em diante chamado de Service Bus) e WebSphere Service Registry and Repository V7 (daqui em diante chamado de Service Registry). A ferramenta de desenvolvimento de opção será o WebSphere Integration Developer V7 (daqui em diante chamado de Integration Developer).

O Service Registry é um repositório central usado para gerenciar documentos de serviço reutilizáveis, incluindo tipos de documentos Web Services Description Language (WSDL), Service Component Definition Language (SCDL), Extensible Markup Language (XML) e XML Schema Definition (XSD). Esses documentos de serviço podem ser usados como blocos de construção para desenvolver aplicativos compostos que podem ser implementados no tempo de execução do Service Bus.

O barramento de serviço corporativo de opção será o Service Bus, que é um ambiente de tempo de execução no WebSphere Application Server (daqui em diante chamado de WAS). A camada de mediação no Service Bus é usada para executar fluxos de mediação compostos por primitivas de mediação, que fornecem funcionalidade pré-integrada a fim de facilitar o rápido desenvolvimento de soluções de integração. Um exemplo de primitiva de mediação é o Endpoint Lookup, que será usado para consultar o Service Registry a partir de um fluxo de mediação.

O resumo de etapas que será feito para completar essa solução será primeiro a criação de um serviço backend que reside no Service Bus, seguido pela definição do fluxo de mediação que executa a consulta no Service Registry. Esse fluxo de mediação será executado no mesmo tempo de execução do Service Bus como o serviço backend. Por último, criaremos uma API Java para cliente de serviço da web com base em XML Web Services (JAX-WS) JavaServer Page (JSP) a fim de testar o cenário de integração.

Pré-requisitos

Antes de prosseguir com as etapas neste artigo, os seguintes pré-requisitos deverão ser seguidos:

• Instalação do Integration Developer em um ambiente operacional Windows.
• Instalação do Service Bus com um servidor único ou configuração de cluster e servidores relevantes iniciados.
• Instalação do Service Registry (local para a instalação do Service Bus) com um servidor único ou configuração de cluster e servidores relevantes iniciados.
• Definição do Service Registry configurada e conexão estabelecida com êxito.
• IBM HTTP Server V7 (daqui em diante chamado de IHS) instalado (local para a instalação do Service Bus) e configurado.

Criando o serviço de amostra

Iniciaremos com a criação de uma amostra de serviço backend que é representado por uma implementação Java. Esse serviço retornará o nome do servidor de aplicativos em que o serviço é executado. O perfil do servidor de aplicativos usado nesse cenário será o do Service Bus.

1. Inicie o Integration Developer ao selecionar Start > All Programs > IBM WebSphere Integration Developer > IBM WebSphere Integration Developer V7.0 > WebSphere Integration Developer V7.0.
2. Na área de trabalho do Integration Developer, clique em File > New > Integration Solution.
3. No diálogo mostrado na Figura 1, digite IntegrationSolution no campo Integration solution name e clique em Next.

4. No próximo diálogo, selecione os três projetos com os nomes padrão, conforme demonstrado na Figura 2, e clique em Finish para finalizar o assistente.

5. Verifique se os três projetos são exibidos na lista conforme demonstra a Figura 3.

6. Expanda IntegrationSolution_Library na visualização Business Integration , clique duas vezes em Interfaces e selecione New >Interface no menu de contexto.

7. Digite ServiceInterface no campo de nome e clique em Finish para concluir o assistente.

8. A interface é ativada no Interface Editor no GIMP, como mostrado na Figura 6.

9. Clique no ícone Add Request Response Operation e nomeie a operação como getServerResponse , como mostra a Figura 7.

10. Clique em File > Save para salvar as alterações feitas até este ponto.
11. Expanda IntegrationSolution_BackendModule (em Projects na visualização Business Integration ) e clique duas vezes em Assembly Diagram para iniciar o Assembly Editor.

12. Insira um componente Java (na pasta Components na lista Palette ) na tela preta e nomeie como BackendComponent.

13. Selecione BackendComponent e clique no ícone Add Interface na janela pop-up, como mostrado na Figura 10.

14. No diálogo Add Interface , selecione ServiceInterface e clique em OK.

15. Verifique se a interface foi adicionada com êxito.

16. Clique com o botão direito do mouse em BackendComponent e selecione Generate Implementation no menu de contexto.
17. Quando solicitado um nome de pacote, clique em com.ibm.au.samples e clique em OK.
18. A classe BackendComponentImpl1.java será exibida no Java Editor , conforme mostrado na figura 13.

19. Substitua o corpo de método getServerResponse com o fragmento de código mostrado na Figura 14.

20. Clique em File > Save All para salvar as alterações feitas até este ponto.
21. Alterne para IntegrationSolution_BackendModule Assembly Diagram.
22. Clique com o botão direito do mouse em BackendComponent e selecione Generate Export > Web Service Binding no menu de contexto.
23. Selecione o protocolo de transporte SOAP1.1/HTTP e clique em Finish para concluir o assistente.

24. Verifique se o Web Service Binding Export foi gerado com êxito.

25. Expanda IntegrationSolution_Library > Web Service Ports (em Projects na visualização Business Integration ) e clique duas vezes em ServiceInterfaceExport1_ServiceInterfaceHttpPort para iniciar o arquivo no WSDL Editor.
26. Selecione ServiceInterfaceExport1_ServiceInterfaceHttpPort e digite http://<hostname>:<port>/ IntegrationSolution_BackendModuleWeb/sca/ServiceInterfaceExport1 no campo Address . (O <nome do host> refere-se ao nome completo do domínio da máquina em que o Service Bus está instalado e <porta> refere-se ao valor encontrado em Servers > Server Types > WebSphere application servers > [Service Bus application server] > Ports > WC_defaulthost do Integrated Solutions Console, em que [Service Bus application server] representa o servidor de aplicativos padrão do perfilService Bus).

27. Clique em File > Save All para salvar as alterações feitas até este ponto.
28. Clique em File > Export para iniciar o assistente de exportação.
29. No diálogo mostrado, selecione Integration modules and libraries na pasta Business Integration e clique em Next para prosseguir.

30. No diálogo subsequente, selecione Files for server deployment, IntegrationSolution_BackendModule e clique em Next para prosseguir.

31. Digite um nome de archive, por exemplo, IntegrationSolution_BackendModule.ear, especifique um Target directory para exportar o projeto e clique em Finish para concluir o assistente.

32. Para exportar os arquivos WSDL que serão transferidos por upload para o Service Registry, clique em File > Export.
33. No diálogo subsequente, selecione WSDL and XSD na pasta Business Integration e clique em Next para prosseguir.

34. No diálogo, conforme mostrado na Figura 22, faça o seguinte.
    • Selecione o projeto IntegrationSolution_Library .
    • Selecione os arquivos WSDL IntegrationSolution_BackendModule_ServiceInterfaceExport1.wsdl e ServiceInterface.wsdl.
    • Especifique um Target directory para exportar os arquivos WSDL.
    • Clique em Finish.

Faça o upload do serviço para o Service Registry

Nesta seção, mostraremos etapas para fazer upload do serviço criado recentemente para o Service Registry. Então, prosseguiremos para adicionar propriedades ao serviço mencionado e executar uma consulta do serviço usando as propriedades como parte da sequência de consultas.

1. Efetuar logon no console do Service Registry em http://<hostname>:<port>/ServiceRegistry. (O <nome do host> refere-se ao nome completo do domínio da máquina em que o Service Registry está instalado e <porta> refere-se ao valor encontrado em Servers > Server Types > WebSphere application servers > [Service Registry application server] > Ports > WC_defaulthost do Integrated Solutions Console, em que [Service Registry application server] representa o servidor de aplicativos padrão do perfil Service Registry).
2. Clique em Actions > Load Documents

3. Selecione IntegrationSolution_BackendModule_ServiceInterfaceExport1.wsdl a partir do sistema de arquivos local e faça o seguinte:
   • Selecione WSDL como o tipo de Documento.
   • Digite ServiceBackend como a descrição do documento.
   • Digite 1.0 como a versão do documento.
   • Clique em OK.

4. Na tela seguinte, clique em Add.

5. Selecione ServiceInterface.wsdl a partir do sistema de arquivos local e faça o seguinte:
   • Selecione WSDL como o tipo de Documento.
   • Digite ServiceInterface como a descrição do documento.
   • Digite 1.0 como a versão do documento.
   • Clique em OK.

6. Na tela seguinte, clique em Finish para finalizar o assistente.

7. Verifique se os documentos de serviço foram carregados com êxito.

8. No campo de procura, conforme mostrado na Figura 29, digite ServiceInterfaceExport1_ServiceInterfaceHttpPort e clique no ícone de procura.

9. Clique no link ServiceInterfaceExport1_ServiceInterfaceHttpPort do tipo de objeto Port.

10. Expanda a seção Additional Properties e clique em Edit Properties.

11. Clique em Add Property.

12. Digite sampleProperty no campo Custom Property Name e clique em Add.

13. Digite abc123def no campo de valor da propriedade customizada e clique em OK.

14. Expanda a seção Additional Properties para verificar se a propriedade customizada foi adicionada com êxito.

15. Clique em Actions > Query Wizard.

16. Selecione as portas WSDL a partir da lista suspensa de tipo de entidade e clique em Next.

17. Na página de detalhes do assistente de consulta, especifique os valores abaixo e clique em Next para prosseguir.
    • Digite sampleProperty no campo Property name .
    • Digite abc123def no campo Property value .

18. Na página de resumo do assistente de consulta, clique em Finish para executar a consulta.

19. Clique no link ServiceInterfaceExport1_ServiceInterfaceHttpPort .

20. Verifique se a propriedade customizadasampleProperty existe.

Definindo o fluxo de mediação

Nesta seção, discutiremos as etapas para a definição do fluxo de mediação que abrangerá o uso das primitivas de mediação Endpoint Lookup e Trace . A primitiva de mediação anterior executará a procura do registro de serviço padrão (que já deve estar definido no Service Bus e a conexão deve ter sido estabelecida com êxito). As primitivas de mediação posteriores facilitarão a resolução de problemas no caso de uma falha.

1. A partir do Integration Developer, clique duas vezes em Assembly Diagram no projeto IntegrationSolution_MediationModule para iniciar o Assembly Editor e nomeie o componente Mediation Flow SampleMediation. (Note que o componente padrão Mediation Flow existe após a criação do Mediation Module.)

2. Selecione SampleMediation e clique no ícone Add Interface na janela pop-up, conforme mostrado na Figura 43.

3. No diálogo Add Interface , selecione ServiceInterface e clique em OK.
4. Selecione SampleMediation e clique no ícone Add Reference na janela pop-up, conforme mostrado na Figura 44.

5. No diálogo Add Reference , selecione ServiceInterface e clique em OK.
6. Clique com o botão direito do mouse em SampleMediation e selecione Generate Implementation no menu de contexto.
7. No diálogo Generate Implementation , selecione a pasta IntegrationSolution_MediationModule e clique em OK.
8. O componente SampleMediation será ativado no Mediation Flow Editor , como mostra a Figura 45.

9. Clique no link getServerResponse em Mediation Flow Editor seguido pelo link Service Integration na janela pop-up, conforme mostrado na Figura 46.

10. No diálogo Integrate Services , clique em Add para selecionar a referência ServiceInterfacePartner , selecione a opção para criar um separate response flow... e clique em OK para criar o fluxo de mediação.

11. Verifique se as guias Request e Response são exibidas no Mediation Flow Editor.

12. Adicione três primitivas de mediação Trace (na pasta Tracing em Palette) para o fluxo Request e nomeie-os como BeforeLookup, AfterLookup e NoMatchFound, conforme mostra a Figura 49.

13. Inclua uma primitiva de mediação Endpoint Lookup (na pasta Routing em Palette) e nomeie-a como WSRREndpointLookup.

14. Conecte todas as primitivas de mediação ao fluxo de solicitação, conforme mostrado na Figura 51.

15. Clique na guia Response em Mediation Flow Editor, inclua a primitiva de mediação Trace e nomeie-a como TraceResponse, conforme mostrado na figura 52.

16. Conecte todas as primitivas de mediação ao fluxo Response , conforme mostrado na figura 53.

17. Alterne de volta para o fluxo Request (ao clicar na guia Request em Mediation Flow Editor), selecione BeforeLookup e adicione o prefixo BeforeLookup --- no campo Message (na seção Details da visualização Properties ).

18. Repita a etapa 17 para AfterLookup , conforme mostrado na figura 55.

19. Selecione NoMatchFound e atualize os seguintes campos na seção Details da visualização Properties .
    • Selecione File na lista suspensa Destination .
    • Especifique um File path absoluto, por exemplo, C:\temp\dWSampleNoMatchFound.log
    • Adicione ao prefixo NoMatchFound --- no campo Message .

20. Selecione WSRREndpointLookup e verifique os campos na seção Details da visualização Properties , conforme mostrado na Figura 57.

21. Selecione WSRREndpointLookup, clique em Advanced na visualização Properties e clique em Add.

22. No diálogo Add/Edit properties , conforme mostrado na Figura 59, digite sampleProperty no campo Name , /body/getServerResponse/input1 no campo Value e clique em Finish.

23. Verifique se a propriedade de usuário adicionada na etapa 22 está listada na seção Advanced da visualização Properties .

24. Clique duas vezes em Assembly Diagram no projeto IntegrationSolution_MediationModule na visualização Business Integration para iniciar o Assembly Editor.
25. Clique com o botão direito do mouse em SampleMediation em Assembly Editor e selecione Generate Export > Web Service Binding no menu de contexto.
26. No diálogo Select a Transport Protocol , selecione SOAP1.1/HTTP e clique em Finish para gerar a exportação.
27. Verificar se o Web Service Binding Export foi gerado com êxito.

28. Clique duas vezes na porta de serviço web ServiceInterfaceExport1_ServiceInterfaceHttpPort no projeto IntegrationSolution_Library na visualização Business Integration , conforme mostrado na Figura 62.
29. Selecione ServiceInterfaceExport1_ServiceInterfaceHttpPort em WSDL Editor e digite http://<hostname>:<port>/IntegrationSolution_MediationModuleWeb/sca/ServiceInterfaceExport1 no campo de endereço. (O <nome do host> refere-se ao nome completo do domínio da máquina em que o Service Bus está instalado e <porta> refere-se ao valor encontrado em Servers > Server Types > WebSphere application servers > [Service Bus application server] > Ports > WC_defaulthost do Integrated Solutions Console, em que [Service Bus application server] representa o servidor de aplicativos padrão do perfil Service Bus).

30. Clique em File > Save All para salvar as alterações feitas até este ponto.
31. Para exportar os artefatos implementáveis para este projeto, clique em File > Export.
32. No diálogo subsequente, selecione Files for server deployment, o projeto IntegrationSolution_MediationModule e clique em Next para prosseguir.
33. No diálogo final do assistente Export especifique um Archive File Name , por exemplo, IntegrationSolution_MediationModule.ear, selecione um Target directory para exportar o projeto e clique em Finish para finalizar a exportação.

Criando o cliente JAX-WS

Na próxima seção, abordaremos as etapas para criar um aplicativo da web que abrange os JSPs e as classes geradas pelo assistente de cliente de serviço da web JAX-WS. JAX-WS é um modelo de programação de serviços da web que se desenvolve na base do modelo Java API para RPC com base em XML (JAX-RPC) e fornece uma abordagem de plataforma mais lógica para definição dos clientes de serviço da web. O aplicativo da web será usado para verificar a integração entre o Service Bus e o Service Registry ao chamar a exportação de ligação de serviço da web da primitiva de mediação SampleMediation .

1. Na área de trabalho do Integration Developer, clique em File > New > Other.
2. No diálogo mostrado na Figura 63, selecione Enterprise Application Project na pasta Java EE e clique em Next para prosseguir.

3. No diálogo seguinte, digite SampleClient no campo Project name , mantenha as outras opções como padrão e clique em Next para prosseguir.

4. Em seguida, clique em New Module.

5. No diálogo subsequente, selecione Web module, mantenha o valor como padrão e clique em Finish.

6. Por último, verifique se SampleClientWeb está selecionado e clique em Finish para concluir o assistente.

7. Quando for solicitado para alternar para a perspectiva Java EE , clique em No.
8. Em seguida, clique em File > New > Other e selecione Web Service Client na pasta Web Services .
9. No diálogo subsequente, digite /IntegrationSolution_Library/IntegrationSolution_MediationModule_ServiceInterfaceExport1.wsdl no campo Service definition e clique no link Server:... .

10. A seguir, selecione WebSphere ESB Server v7.0 como Server, IBM WebSphere JAX-WS como Web service runtime e clique em OK.

11. Em seguida, clique no link Client project:... .

12. No diálogo subsequente, selecione SampleClientWeb como o projeto de cliente e clique em OK.
13. Certifique-se de que Configuration é exibido na Figura 71 e clique em Next para prosseguir.

14. No diálogo final do assistente, selecione Generate portable client, mantenha as outras opções como padrão e clique em Finish. (Quando a opçãoGenerate portable client estiver selecionada, uma cópia local dos arquivos WSDL será armazenada na pasta <WebModule>/WebContent/WEB-INF/wsdl .)

15. Alterne para a perspectiva Java EE ao clicar em Window > Open Perspective > Other > Java EE.
16. Verifique se as classes Java mostradas na Figura 73 estão listadas na visualização Enterprise Explorer .

17. Verifique se há uma configuração do servidor Service Bus na área de trabalho Integration Developer.

18. Clique com o botão direito do mouse em ServiceInterfaceExport1_ServiceInterfaceHttpPortProxy.java em SampleClientWeb > Java Resources > integrationsolution_library.serviceinterface.binding2 e selecione Web Services > Generate JAX-WS JSPs no menu de contexto.
19. No diálogo Web Service Client Test , selecione Test the generated proxy, digite form no campo Folder , desmarque Run test on Server, mantenha as outras opções como padrão e clique em Finish para finalizar o assistente.

20. Verifique se os JSPs, conforme mostrado na Figura 76, estão listados na visualização Enterprise Explorer .

21. Para exportar os artefatos implementáveis para este projeto, clique em File > Export.
22. No diálogo subsequente, selecione EAR file na pasta Java EE e clique em Next para prosseguir.
23. A seguir, selecione SampleClient como EAR project, especifique um Destination para exportar o projeto, mantenha as outras opções como padrão e clique em Finish para finalizar a exportação.

Implementando os aplicativos no Service Bus

A seguir, implementaremos os módulos de integração exportados e o projeto da web para o tempo de execução do Service Bus através do Integrated Solutions Console. . Os módulos da web de todos os aplicativos serão mapeados para o servidor de aplicativos Service Bus e para o IHS.

1. Efetue logon em Integrated Solutions Console em http://<hostname>:<port>/ibm/console. (O <nome do host> refere-se ao nome completo do domínio da máquina em que o Service Bus está instalado e <porta> refere-se ao valor padrão encontrado em 9060.)
2. Navegue para Applications > New Application > New Enterprise Application.
3. Selecione o arquivo IntegrationSolution_BackendModule.ear a partir do Local file system e clique em Next.
4. Selecione Fast Path e clique em Next.
5. Na tela seguinte, mantenha os valores como padrão e clique em Next.
6. Em seguida, mapeie IntegrationSolution_BackendModuleWeb para o servidor de aplicativos Service Bus e servidor da web em Cluster and servers list e, em seguida, clique em Next para prosseguir.

7. Reveja o resumo da implementação e clique em Finish para instalar o aplicativo.
8. Clique em Review após a conclusão da instalação.
9. Selecione Synchronize changes with Nodes e clique em Save.
10. Quando a sincronização estiver concluída, clique em OK.
11. Navegue para Applications > Application Types > WebSphere enterprise applications, selecione IntegrationSolution_BackendModuleApp e clique em Start.
12. Repita as etapas 1 – 11 para instalar e iniciar os aplicativos a seguir.
    • IntegrationSolution_MediationModule.ear
    • SampleClient.ear

Testando o aplicativo

Na última seção, acessaremos o aplicativo da web SampleClientWeb através de um navegador. O aplicativo mencionado recebe uma cadeia de caractere de entrada de um formulário da web e retorna o nome do servidor de aplicativo do Service Bus em que o serviço backend é executado, ou um valor null se nenhuma correspondência for encontrada no Service Registry. Após a execução do teste mencionado, revisaremos o arquivo SystemOut.log do servidor de aplicativo do Service Bus para verificar se foi efetuado logon das mensagens pelas primitivas de mediação Trace .

1. Ative o aplicativo da web em um navegador ao acessar http://<hostname>/SampleClientWeb/form/TestClient.jsp (O <nome do host> refere-se ao nome completo do domínio da máquina em que o IHS está instalado. Não especificamos explicitamente uma porta como o módulo da web do aplicativo corporativo mapeado para o IHS.)

2. Clique no link getServerResponse no quadro Methods, digite 10 (ou qualquer valor de sequência alfanumérica que não 'abc123def' no campo input1 e clique em Invoke.
3. Verifique se 'null' é exibido no quadro Results , como mostra a Figura 79.

4. Abra C:\temp\dWSampleNoMatchFound.log no editor de texto e visualize as mensagens em que foi efetuado logon pela primitiva de mediação Trace .

5. A seguir, digite abc123def no campo input1 e clique em Invoke.
6. Verifique se 'Server response from <Service Bus application server> with input abc123def' é exibido no quadro Results, como mostra a Figura 81. (O <Service Bus application server> ] se refere ao servidor de aplicativos padrão do perfil Service Bus).

7. Alterne de volta para Integrated Solutions Console e navegue para Troubleshooting > Logs and trace > [Service Bus application server] > JVM Logs. (O [Service Bus application server] ] é o servidor de aplicativos padrão do perfil Service Bus).
8. Clique na guia Runtime e clique em View próximo a SystemOut.log.
9. Visualize as mensagens em que o logon foi efetuado pelas primitivas de mediação Trace , conforme mostra a Figura 82.

Conclusão

Neste artigo, você aprendeu como desenvolver uma solução usando o Integration Developer que demonstra integração entre o Service Bus e o Service Registry. Iniciamos com a criação de uma amostra de serviço backend e, então, transferimos por upload o serviço mencionado para o Service Registry. Então, foi definido um fluxo de mediação que executa a consulta do Service Registry e gera um cliente de serviço da web JAX-WS para testar o cenário de integração.

Agradecimentos

Gostaria de agradecer meu colega de equipe, Damien McAullay, da equipe Australia Development Laboratory WebSphere Services por revisar este artigo.

Recursos

• Mais detalhes sobre o Service Registry podem ser encontrados em WebSphere Service Registry and Repository V7 Information Center.
  
  
• Mais detalhes sobre o Services Details podem ser encontrados em WebSphere Enterprise Service Bus V7 Information Center.
  
  
• Saiba como implementar as topologias WebSphere Business Process Management V7 ao consultar o WebSphere Business Process Management V7 Production Topologies Redbook.
  
  
• Consulte detalhes sobre API Java para Serviços da web em XML .
  
  

Sobre o autor

Ben faz parte da equipe do Australia Development Laboratory WebSphere Services e fornece serviços de implementação para vários clientes nos produtos WebSphere, principalmente no WebSphere Process Server, WebSphere Enterprise Service Bus e WebSphere Application Server.

Classificar este artigo

Comentários

Voltar para parte superior

Índice

• Introdução
• Criando o serviço de amostra
• Faça o upload do serviço para o Service Registry
• Definindo o fluxo de mediação
• Criando o cliente JAX-WS
• Implementando os aplicativos no Service Bus
• Testando o aplicativo
• Conclusão
• Agradecimentos
• Recursos
• Sobre o autor
• Comentários

Conheça a IBM da sua cidade

A IBM está mais perto do que você imagina!

---

Saiba mais