Passo a Passo
WebSphere Message Broker
Fluxo como WebService
Alexandre José Batista
Criado em: 07/11/08 Página 2 de 38
Índice
1. OBJETIVOS DO DOCUMENTO... 42. CRIANDO UM FLUXO NO WEBSPHERE MESSAGE BROKER. ... 5
2.1 ABRIR O WEBSPHERE MESSAGE BROKER TOOLKIT... 5
2.2 CRIANDO UM FLUXO... 6
2.2.1 – Passo 1 – Definindo um Message Flow Project... 6
2.2.2 – Passo 2 – Definindo um Message Flow ... 7
2.2.3 – Passo 3 – Definindo um Message Set Project ... 8
2.2.4 – Passo 4 – Importando arquivos XML... 9
2.2.5 – Passo 5 – Gerar os arquivos XSD´s...11
2.2.6 – Passo 6 – Message Definition File...13
2.2.7 – Passo 7 – Definindo os Nodes para o Message Flow ...16
2.2.8 – Passo 8 – Selecione os demais Nodes ...18
2.2.9 – Passo 9 – Fazendo o mapeamento dos dados com o Node Mapping ...19
2.2.10 – Passo 10 – Message Category File ...22
2.2.11 – Passo 11 – Definindo o WSDL para o Fluxo ...25
2.3 – DEPLOY DO FLUXO...32
2.3.1 – Criar um Message Broker Archiver ...33
2.3.2 – Deploy do Arquivo BAR (Broker Archiver)...35
3. TESTANDO O FLUXO ...37
Í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. ... 9
Figura 7 – Gerar XML Schema ... 11
Figura 7.1 – Arquivo ClienteIN.xsd... 12
Figura 7.2 – Arquivos XML´s e XSD´s ... 13
Figura 8 – Message Definition File ... 13
Figura 8.1 – Arquivo XML schema file ... 14
Figura 8.2 – Global Elements ... 15
Figura 9 – Node http Input... 16
Figura 9.1 – Http Input Properties ... 17
Figura 10 – Nodes SOAPExtract, Mapping e http Reply ... 18
Figura 11 – Mapping Node ... 19
Figura 11.1 – Mensage Source e Target... 20
Figura 11.2 – Tela de Mapeamento dos Campos ... 21
Figura 12 – Message Category File ... 22
Figura 12.1 – Categoria tipo WSDL (Request e Response) ... 22
Figura 12.2 – Nome do arquivo de Categoria ... 23
Figura 12.3 – Definindo a entrada (Input) e saída (Output) ... 24
Figura 13 – WSDL Definition ... 25
Figura 13.1 – WSDL Definition from Message Set ... 26
Figura 13.2 – Formato do WSDL - Simples ... 27
Figura 13.3 – O Estilo do WSDL é “document” ... 28
Figura 13.4 – Selecione o arquivo de Categoria para o WSDL ... 29
Figura 13.5 – Formato do Binding é SOAP/http... 30
Figura 13.6 – Port Address do Fluxo... 31
Figura 13.7 – Arquivo WSDL Gerado... 32
Figura 14 – Broker Administration ... 32
Figura 15 – Message Broker Archiver ... 33
Figura 15.1 – Colocando arquivos no Broker Archiver ... 34
Figura 16 – Deploy do Arquivo BAR ... 35
Criado em: 07/11/08 Página 4 de 38
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.
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
2
.
.
1
1
A
A
BRBRIIRR OOW
W
EEBBSSPPHHEREREEM
M
ESESSSAAGGEEB
B
ROROKKEERRT
T
OOOOLLKKIITT
Click em Iniciar Programas IBM Websphere WebSphere Message
Broker 6.0.2 ou clique diretamente no ícone que se encontra no desktop.
Quando abrir Workspace conforme a tela abaixo, coloque o nome sugerido
”Fluxo_WS”.
Criado em: 07/11/08 Página 6 de 38
2
2
.
.
2
2
C
C
RIRIAANNDDOO UUMMF
F
LLUUXXOO 2 2..22..11––PPAASSSSOO11––DDEEFFIINNIINNDDOOUUMMMMEESSSSAAGGEEFFLLOOWWPPRROOJJEECCTTClique 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.
2
2..22..22––PPAASSSSOO22––DDEEFFIINNIINNDDOOUUMMMMEESSSSAAGGEEFFLLOOWW
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.
Criado em: 07/11/08 Página 8 de 38
2
2..22..33––PPAASSSSOO33––DDEEFFIINNIINNDDOOUUMMMMEESSSSAAGGEESSEETTPPRROOJJEECCTT
Agora vamos criar um Message Set Project conforme figura abaixo.
Coloque o nome do Message Set Project e clique no botão Next.
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.
2
2..22..44––PPAASSSSOO44––IIMMPPOORRTTAANNDDOOAARRQQUUIIVVOOSSXXMMLL
Depois de criar os objetos vamos importar os arquivos XML´s de exemplo.
Criado em: 07/11/08 Página 10 de 38
O conteúdo dos arquivos são :
ClienteIN.xml <?xml version="1.0" encoding="iso-8859-1"?> <fl_in:ClienteIN xmlns:fl_in="http://Fluxo_WS/in"> <Dados> <CodigoCliente></CodigoCliente> </Dados> </fl_in:ClienteIN> ClienteOUT.xml <?xml version="1.0" encoding="iso-8859-1"?> <fl_out:ClienteOUT xmlns:fl_out="http://Fluxo_WS/out"> <Dados> <CodigoCliente></CodigoCliente> <NomeCliente></NomeCliente> <EmailCliente></EmailCliente> <MsnCliente></MsnCliente> </Dados> </fl_out:ClienteOUT>
2
2..22..55––PPAASSSSOO55––GGEERRAARROOSSAARRQQUUIIVVOOSSXXSSDD´´SS
Agora vamos gerar os arquivos XSD’s que é a estrutura do arquivo XML.
Criado em: 07/11/08 Página 12 de 38
Coloque o nome do arquivo com o valor “ClienteIN.xsd” e clique em finish.
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
2
2..22..66––PPAASSSSOO66––MMEESSSSAAGGEEDDEEFFIINNIITTIIOONNFFIILLEE..
Para que o fluxo funcione vamos criar um Message Definition File para os XSD’s
criados do tipo XML Schema
File.
Criado em: 07/11/08 Página 14 de 38
Selecione a opção “XML schema file” e clique em Next.
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 16 de 38
2
2..22..77––PPAASSSSOO77––DDEEFFIINNIINNDDOOOOSSNNOODDEESSPPAARRAAOOMMEESSSSAAGGEEFFLLOOWW
Agora volte ao Message Flow e selecione o Node HttpInput.
Clique com o botão do mouse direito em propriedade.
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.
Criado em: 07/11/08 Página 18 de 38
2
2..22..88––PPAASSSSOO88––SSEELLEECCIIOONNEEOOSSDDEEMMAAIISSNNOODDEESS
Agora selecione os Nodes (SOAPExtract, Mapping e HttpRequest) para completar o
fluxo.
2
2..22..99––PPAASSSSOO99––FFAAZZEENNDDOOOOMMAAPPEEAAMMEENNTTOODDOOSSDDAADDOOSSCCOOMMOONNOODDEEMMAAPPPPIINNGG
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
Criado em: 07/11/08 Página 20 de 38
A próxima tela fica como a Figura 11.1
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.
Criado em: 07/11/08 Página 22 de 38
2
2..22..1100––PPAASSSSOO1100––MMEESSSSAAGGEECCAATTEEGGOORRYYFFIILLEE
Agora vamos criar um Message Category File utilizado para criar o arquivo WSDL.
Figura 12 – Message Category File
Clique em Next.
Coloque o nome “CatFileFluxoWS” e clique em Next.
Criado em: 07/11/08 Página 24 de 38
Selecione os tipos de dado ClienteIN e ClienteOUT, altere o campo Kind do
ClienteOUT para “output” e clique em finish.
2
2..22..1111––PPAASSSSOO1111––DDEEFFIINNIINNDDOOOOWWSSDDLLPPAARRAAOOFFLLUUXXOO
Agora vamos criar um arquivo WSDL para o Fluxo.
Criado em: 07/11/08 Página 26 de 38
Selecione o Fluxo e clique em Next.
Deixe o formato como “single” e clique em Next.
Criado em: 07/11/08 Página 28 de 38
Na próxima tela deixe tudo como está e clique em Next.
Selecione o arquivo de Categoria e clique em Next.
Criado em: 07/11/08 Página 30 de 38
Selecione “SOAP/HTTP” e clique em Next.
Altere o valor do campo “Port Address” para “HTTP://localhost:7080/Fluxo_WS e
clique em finish.
Criado em: 07/11/08 Página 32 de 38
Pronto o arquivo WSDL foi gerado.
Figura 13.7 – Arquivo WSDL Gerado
2
2
.
.
3
3
–
–
D
D
EPEPLLOOYY DDOOF
F
LLUUXXOOAgora 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.
2
2..33..11––CCRRIIAARRUUMMMMEESSSSAAGGEEBBRROOKKEERRAARRCCHHIIVVEERR
Vamos criar um Message Broker Archiver com o nome “Fluxo_WS” e clique em OK .
Criado em: 07/11/08 Página 34 de 38
Clique no botão “+” para adicionar os arquivos ao BAR.
Selecione os arquivos e clique em OK e depois Salve.
2
2..33..22––DDEEPPLLOOYYDDOOAARRQQUUIIVVOOBBAARR((BBRROOKKEERRAARRCCHHIIVVEERR))
Com o arquivo BAR pronto, agora vamos fazer o deploy.
Criado em: 07/11/08 Página 36 de 38
Escolha o Execution Group “default” e clique em OK.
Figura 16.1 – Deploy no Execution Group
3. TESTANDO O FLUXO
Para verificar se nosso fluxo está funcionando vamos utilizar o Software SoapUI que
você pode baixar no link (www.soapui.org) .
Pronto você acaba de fazer um fluxo no Message Broker e acessa-lo por Web
Service.
Criado em: 07/11/08 Página 38 de 38