Passo a Passo. WebSphere Message Broker. Fluxo como WebService

Transcrição

1 Passo a Passo WebSphere Message Broker Fluxo como WebService Alexandre José Batista ajbatist@ibest.com.br Criado em: 07/11/08 Página 1 de 38

2 Índice 1. OBJETIVOS DO DOCUMENTO CRIANDO UM FLUXO NO WEBSPHERE MESSAGE BROKER ABRIR O WEBSPHERE MESSAGE BROKER TOOLKIT CRIANDO UM FLUXO Passo 1 Definindo um Message Flow Project Passo 2 Definindo um Message Flow Passo 3 Definindo um Message Set Project Passo 4 Importando arquivos XML Passo 5 Gerar os arquivos XSD s Passo 6 Message Definition File Passo 7 Definindo os Nodes para o Message Flow Passo 8 Selecione os demais Nodes Passo 9 Fazendo o mapeamento dos dados com o Node Mapping Passo 10 Message Category File Passo 11 Definindo o WSDL para o Fluxo DEPLOY DO FLUXO Criar um Message Broker Archiver Deploy do Arquivo BAR (Broker Archiver) TESTANDO O FLUXO REFERÊNCIAS...38 Criado em: 07/11/08 Página 2 de 38

3 Índice de figura Figura 1 Escolha de Workspce... 5 Figura 2 New Message Flow Project... 6 Figura 3 Criando um Message Flow... 7 Figura 4 Criando um Message Set Project... 8 Figura 5 Criando um Message Set... 9 Figura 6 Importando os arquivos XML de exemplo Figura 7 Gerar XML Schema Figura 7.1 Arquivo ClienteIN.xsd Figura 7.2 Arquivos XML s e XSD s Figura 8 Message Definition File Figura 8.1 Arquivo XML schema file Figura 8.2 Global Elements Figura 9 Node http Input Figura 9.1 Http Input Properties Figura 10 Nodes SOAPExtract, Mapping e http Reply Figura 11 Mapping Node Figura 11.1 Mensage Source e Target Figura 11.2 Tela de Mapeamento dos Campos Figura 12 Message Category File Figura 12.1 Categoria tipo WSDL (Request e Response) Figura 12.2 Nome do arquivo de Categoria Figura 12.3 Definindo a entrada (Input) e saída (Output) Figura 13 WSDL Definition Figura 13.1 WSDL Definition from Message Set Figura 13.2 Formato do WSDL - Simples Figura 13.3 O Estilo do WSDL é document Figura 13.4 Selecione o arquivo de Categoria para o WSDL Figura 13.5 Formato do Binding é SOAP/http Figura 13.6 Port Address do Fluxo Figura 13.7 Arquivo WSDL Gerado Figura 14 Broker Administration Figura 15 Message Broker Archiver Figura 15.1 Colocando arquivos no Broker Archiver Figura 16 Deploy do Arquivo BAR Figura 16.1 Deploy no Execution Group Criado em: 07/11/08 Página 3 de 38

4 1. OBJETIVOS DO DOCUMENTO Esse documento tem como objetivo ajudar o manuseio da ferramenta IBM WebSphere Message Broker. Uma das finalidades desse documento e fazer que os novos integrantes e estudantes de integração tenha uma noção sobre os recursos do software e uma rápida apredizagem sobre a ferramenta. Criado em: 07/11/08 Página 4 de 38

5 2. CRIANDO UM FLUXO NO WEBSPHERE MESSAGE BROKER. Websphere Message Broker Toolkit é um IDE poderoso para desenvolver fluxos e roteamento de mensagens. Neste exemplo, nós aprenderemos como construir e testar um fluxo acessado via Web. 2.1 ABRIR O WEBSPHERE MESSAGE BROKER TOOLKIT Click em Iniciar Programas IBM Websphere WebSphere Message Broker ou clique diretamente no ícone que se encontra no desktop. Quando abrir Workspace conforme a tela abaixo, coloque o nome sugerido Fluxo_WS. Figura 1 Escolha de Workspce Criado em: 07/11/08 Página 5 de 38

6 2.2 CRIANDO UM FLUXO PASSO 1 DEFININDO UM MESSAGE FLOW PROJECT Clique na área do Resource Navigator e com o botão do mouse direito crie um Message Flow Project. Coloque o nome do projeto e clique no botão finish. Figura 2 New Message Flow Project Criado em: 07/11/08 Página 6 de 38

7 2.2.2 PASSO 2 DEFININDO UM MESSAGE FLOW Novamente com o botão do mouse direito crie um Message Flow coloque o nome sugerido. Coloque o nome do Message Flow e clique no botão finish. Figura 3 Criando um Message Flow Criado em: 07/11/08 Página 7 de 38

8 2.2.3 PASSO 3 DEFININDO UM MESSAGE SET PROJECT Agora vamos criar um Message Set Project conforme figura abaixo. Coloque o nome do Message Set Project e clique no botão Next. Figura 4 Criando um Message Set Project Criado em: 07/11/08 Página 8 de 38

9 Coloque o nome do Message Set, faça um check no campo Use namespaces e clique no botão Next. Figura 5 Criando um Message Set Selecione o formato XML Wire Format Name e clique no botão finish PASSO 4 IMPORTANDO ARQUIVOS XML Depois de criar os objetos vamos importar os arquivos XML s de exemplo. Figura 6 Importando os arquivos XML de exemplo. Criado em: 07/11/08 Página 9 de 38

10 O conteúdo dos arquivos são : ClienteIN.xml <?xml version="1.0" encoding="iso "?> <fl_in:clientein xmlns:fl_in=" <Dados> <CodigoCliente></CodigoCliente> </Dados> </fl_in:clientein> ClienteOUT.xml <?xml version="1.0" encoding="iso "?> <fl_out:clienteout xmlns:fl_out=" <Dados> <CodigoCliente></CodigoCliente> <NomeCliente></NomeCliente> < Cliente></ Cliente> <MsnCliente></MsnCliente> </Dados> </fl_out:clienteout> Estes arquivos servirão de base para o fluxo. Criado em: 07/11/08 Página 10 de 38

11 2.2.5 PASSO 5 GERAR OS ARQUIVOS XSD S Agora vamos gerar os arquivos XSD s que é a estrutura do arquivo XML. Figura 7 Gerar XML Schema Criado em: 07/11/08 Página 11 de 38

12 Coloque o nome do arquivo com o valor ClienteIN.xsd e clique em finish. Figura 7.1 Arquivo ClienteIN.xsd Criado em: 07/11/08 Página 12 de 38

13 Fazer o procedimento para os dois arquivos, após a execução dos procedimentos, vai ficar como a figura abaixo. Figura 7.2 Arquivos XML s e XSD s PASSO 6 MESSAGE DEFINITION FILE. Para que o fluxo funcione vamos criar um Message Definition File para os XSD s criados do tipo XML Schema File. Figura 8 Message Definition File Criado em: 07/11/08 Página 13 de 38

14 Selecione a opção XML schema file e clique em Next. Figura 8.1 Arquivo XML schema file Criado em: 07/11/08 Página 14 de 38

15 Selecione todas as tag s e clique em Next e depois em finish. Figura 8.2 Global Elements Repita o procedimento de criação do Message Definition File para o arquivo ClienteOUT.xsd. Criado em: 07/11/08 Página 15 de 38

16 2.2.7 PASSO 7 DEFININDO OS NODES PARA O MESSAGE FLOW Agora volte ao Message Flow e selecione o Node HttpInput. Clique com o botão do mouse direito em propriedade. Figura 9 Node http Input Criado em: 07/11/08 Página 16 de 38

17 Coloque o endereço da URL desejada e clique em Apply. Clique no link Default do lado direito e selecione o Message Set de Entrada, digite Envelope, no campo Message Type e clique em OK. Figura 9.1 Http Input Properties Criado em: 07/11/08 Página 17 de 38

18 2.2.8 PASSO 8 SELECIONE OS DEMAIS NODES Agora selecione os Nodes (SOAPExtract, Mapping e HttpRequest) para completar o fluxo. Figura 10 Nodes SOAPExtract, Mapping e http Reply Criado em: 07/11/08 Página 18 de 38

19 2.2.9 PASSO 9 FAZENDO O MAPEAMENTO DOS DADOS COM O NODE MAPPING Com o botão do mouse direito em Mapping clique em Open Map. Clique em Next até aparecer a tela de mapeamento. Figura 11 Mapping Node Clique em Next e depois em Finish. Criado em: 07/11/08 Página 19 de 38

20 A próxima tela fica como a Figura 11.1 Figura 11.1 Mensage Source e Target Criado em: 07/11/08 Página 20 de 38

21 Vai aparecer a tela como a Figura 11.2, que é a tela de Mapeamento dos campos. Arraste o campo código do Cliente do lado esquerdo para o campo Código do Cliente do lado Direito, logo em seguida preencha os demais campos com os valores desejados. Figura 11.2 Tela de Mapeamento dos Campos Criado em: 07/11/08 Página 21 de 38

22 PASSO 10 MESSAGE CATEGORY FILE Agora vamos criar um Message Category File utilizado para criar o arquivo WSDL. Figura 12 Message Category File Clique em Next. Figura 12.1 Categoria tipo WSDL (Request e Response) Criado em: 07/11/08 Página 22 de 38

23 Coloque o nome CatFileFluxoWS e clique em Next. Figura 12.2 Nome do arquivo de Categoria Criado em: 07/11/08 Página 23 de 38

24 Selecione os tipos de dado ClienteIN e ClienteOUT, altere o campo Kind do ClienteOUT para output e clique em finish. Figura 12.3 Definindo a entrada (Input) e saída (Output) Criado em: 07/11/08 Página 24 de 38

25 PASSO 11 DEFININDO O WSDL PARA O FLUXO Agora vamos criar um arquivo WSDL para o Fluxo. Figura 13 WSDL Definition Criado em: 07/11/08 Página 25 de 38

26 Selecione o Fluxo e clique em Next. Figura 13.1 WSDL Definition from Message Set Criado em: 07/11/08 Página 26 de 38

27 Deixe o formato como single e clique em Next. Figura 13.2 Formato do WSDL - Simples Criado em: 07/11/08 Página 27 de 38

28 Na próxima tela deixe tudo como está e clique em Next. Figura 13.3 O Estilo do WSDL é document Criado em: 07/11/08 Página 28 de 38

29 Selecione o arquivo de Categoria e clique em Next. Figura 13.4 Selecione o arquivo de Categoria para o WSDL Criado em: 07/11/08 Página 29 de 38

30 Selecione SOAP/HTTP e clique em Next. Figura 13.5 Formato do Binding é SOAP/http Criado em: 07/11/08 Página 30 de 38

31 Altere o valor do campo Port Address para e clique em finish. Figura 13.6 Port Address do Fluxo Criado em: 07/11/08 Página 31 de 38

32 Pronto o arquivo WSDL foi gerado. Figura 13.7 Arquivo WSDL Gerado 2.3 DEPLOY DO FLUXO Agora mude para a perspectiva de administração do Broker, nesta perspectiva você tem todos os elementos necessários para fazer o deploy. Não vamos discorrer sobre como conectar ao Configuration Manager, estamos partindo do fato de esta configuração já esteja em perfeito funcionamento. Figura 14 Broker Administration Criado em: 07/11/08 Página 32 de 38

33 2.3.1 CRIAR UM MESSAGE BROKER ARCHIVER Vamos criar um Message Broker Archiver com o nome Fluxo_WS e clique em OK. Figura 15 Message Broker Archiver Criado em: 07/11/08 Página 33 de 38

34 Clique no botão + para adicionar os arquivos ao BAR. Selecione os arquivos e clique em OK e depois Salve. Figura 15.1 Colocando arquivos no Broker Archiver Criado em: 07/11/08 Página 34 de 38

35 2.3.2 DEPLOY DO ARQUIVO BAR (BROKER ARCHIVER) Com o arquivo BAR pronto, agora vamos fazer o deploy. Figura 16 Deploy do Arquivo BAR Criado em: 07/11/08 Página 35 de 38

36 Escolha o Execution Group default e clique em OK. Figura 16.1 Deploy no Execution Group Pronto o deploy foi realizado com Sucesso. Criado em: 07/11/08 Página 36 de 38

37 3. TESTANDO O FLUXO Para verificar se nosso fluxo está funcionando vamos utilizar o Software SoapUI que você pode baixar no link ( Pronto você acaba de fazer um fluxo no Message Broker e acessa-lo por Web Service. Criado em: 07/11/08 Página 37 de 38

38 4. REFERÊNCIAS [IBM 08] (30/10/2008) [SOAPUI] (07/11/2008) Criado em: 07/11/08 Página 38 de 38