Você pode usar um mapa de mensagem para aprimorar uma mensagem existente com os dados de uma ou mais tabelas de banco de dados. Dados do banco de dados podem então ser usados para enriquecer, rotear e transformar mensagens dentro do WebSphere Message
Broker.
No
WebSphere Message
Broker, para se conectar a um banco de dados, você deve configurar o ambiente de desenvolvimento e o ambiente de tempo de execução do
WebSphere Message
Broker:
- Para ter visibilidade dos recursos do banco de dados durante a fase de desenvolvimento, você deve conectar o WebSphere Message
Broker Toolkit ao banco de dados de desenvolvimento.
- Para ativar o mapa implementado para executar no tempo de execução, você deve criar um serviço configurável do provedor JDBC que define a conexão com o banco de dados de tempo de execução. Esse banco de dados é normalmente um servidor de banco de dados diferente daquele que você usa para desenvolvimento e os artefatos poderiam estar em um esquema do banco de dados diferente.
Para configurar o
WebSphere Message
Broker Toolkit para se
conectar a um banco de dados, você deve criar um arquivo de definição de banco de dados em um
projeto de design de dados e configurar uma conexão com o banco de dados.
- Projeto de design de dados: Um tipo especializado de projeto no qual você armazena seus recursos de banco de dados.
- Arquivo de definição de banco de dados: Um arquivo de configuração em que você especifica os detalhes físicos do banco de dados, como tipo de banco de dados e versão, e uma conexão.
- Conexão com o banco de dados: Configuração que detalha os recursos do banco de dados, ou seja, o esquema, as tabelas, os procedimentos armazenados, os índices e outros recursos, que você precisa acessar de dentro dos recursos do projeto do WebSphere Message
Broker.
Para acessar informações armazenadas em um banco de dados a partir dos recursos em um projeto do WebSphere Message
Broker, você deve incluir uma referência ao projeto de design de dados em seu aplicativo, serviço ou Projeto do Message Broker.
No WebSphere Message
Broker,
é possível usar um mapa de mensagem para acessar informações em um banco de dados e então
usar essas informações para executar transformações na mensagem ou enriquecer
uma mensagem.
Durante a fase de design, você deve concluir as etapas a seguir no
WebSphere Message
Broker Toolkit para acessar informações do banco de dados graficamente em um mapa de mensagem:
- Inclua uma referência para cada tabela de banco de dados a partir de onde você deve recuperar dados.
- Use uma transformação Selecionar para definir como usar as informações do banco de dados no mapa de mensagem. A transformação Selecionar integrou um mapa aninhado. Você deve definir as transformações neste mapa aninhado.
- Use uma transformação de Falha para lidar com falhas do banco de dados. A transformação de Falha integrou um mapa aninhado. É possível definir as transformações neste mapa aninhado se você desejar fornecer manipulação especializada de quaisquer exceções do banco de dados que são atingidas executando as instruções SQL geradas quando o mapa é executado.
Se você tomar o padrão de não incluir uma transformação de Falha, o WebSphere Message
Broker manipulará o erro, o relatará para o log do sistema e, em seguida, retrocederá a transação da mensagem atual.
Para configurar o tempo de execução do WebSphere Message
Broker para
se conectar a um banco de dados, você deve estabelecer uma conexão com o banco de dados para
cumprir as operações executadas pelo nó Mapping.
Você deve definir um serviço configurável do provedor JDBC.
Use esse cenário para aprender a usar um nó Mapping para se conectar a um banco de dados, recuperar dados de várias tabelas, preencher elementos em uma mensagem SOAP com essas informações e manipular uma exceção SQL do banco de dados. Use este cenário para aprender também como configurar o serviço configurável do provedor JDBC.