Ao criar um projeto no Cronapp, o banco de desenvolvimento H2 já vem configurado. Porém, quando precisamos testar a conexão com banco de dados ou no momento da publicação devemos substituir o banco H2.

Para isso, o Cronapp possui suporte aos principais bancos de dados, por exemplo: DB2, Derby, H2, Microsoft SQL Server, MySQL, Oracle Database e PostgreSQL. Veremos nessa página como configurar bancos de dados em seu projeto Cronapp.

Caso você possua um banco local e queira utilizá-lo no Cronapp, é possível utilizar o ngrok para criar um túnel seguro entre seu banco local e sua aplicação no Cronapp. Para mais detalhes acesse o tutorial Conectando um banco de dados local ao Cronapp.

Gerenciar Banco de dados

A funcionalidade Banco de dados (context.xml) é responsável por vincular um ou mais bancos de dados ao seu sistema. Para abri-lo, clique no menu Projeto e selecione Banco de dados ou na árvore de arquivos acesse Configurações (config) e depois Bancos de Dados (context.xml).

Figura 1 - Acesso ao arquivo context.xml através do menu 

1. Editar o banco de dados;
2. Remover o banco de dados;
3. Manipular o banco de dados, acesse o banco através da ferramenta de gerenciamento de banco de dados;
4. Abre janela de gerenciamento de perfis;
5. Adicionar um novo banco.

Ao abrir o arquivo context.xml em modo Editor de texto é possível ver o xml que exibe todas as informações dos bancos de dados configurados em seu projeto no Cronapp (Figura 2).

Figura 2 - Abrir context.xml através do editor de texto

Novo banco de dados

Para adicionar um novo banco de dados, clique no botão Novo (item 5 da figura 1) e assim será aberta a janela de configuração do novo banco (Figura 3).

Figura 3 - Adicionando novo banco de dados

Campos

• Banco de dados na nuvem: caso tenha um banco no Serviços de Cloud do Cronapp, selecione-o aqui para preencher automaticamente todos os outros campos abaixo.
• Nome: nome da conexão do banco, identifica o banco dentro do Cronapp.
• Perfil: escolha do perfil do banco de dados: Desenvolvimento, Produção ou outro criado.
  • É possível excluir um dos perfis clicando no botão da lixeira ao lado do campo.
• Fabricante: escolha do banco de dados.
• Usuário: usuário para o banco de dados.
• Senha: senha do usuário para o banco de dados.
• Nome Banco ou Esquema: selecione um dos schemas ou bancos.
  1. O primeiro botão atualiza os schemas na caixa de seleção e o segundo cria um novo schema/banco.
• Servidor: endereço do servidor.
• Porta: porta usada pelo banco de dados.

Botões

1. OK: salva a configuração do banco de dados.
2. Cancelar: volta para a tela inicial do context.xml.
3. Testar Conexão: verifica se a conexão do banco está funcionando corretamente;
4. Manipular dados: abre uma janela para fazer manipulação do banco de dados através da ferramenta de gerenciamento de banco de dados;
5. Avançado: abre a janela de configuração dos atributos da conexão (Figura 4).

Normalmente não é necessário alterar as configurações da janela Atributos de Conexão ao adicionar um novo banco de dados, o Cronapp configura automaticamente os principais atributos.

Figura 4 - Janela de configuração dos Atributos da Conexão

Perfil

O Cronapp permite que seja criado perfis que serão vinculados a diferentes bancos de dados cadastrados no projeto. No momento em que for rodar o projeto ou gerar o .war é possível selecionar um dos perfis/banco de dados.

Figura 5 - É possível selecionar um banco de dados ao rodar a aplicação

Figura 5 - Ao exportar para .war, selecione o perfil desejado

Para adicionar um novo perfil, clique no botão Perfil na janela da funcionalidade Banco de dados (item 4 da figura 1) e assim será aberta a janela de configuração de Perfil (Figura 6). Os perfis DEV e PROD já vem previamente configurados, eles serão exibidos respectivamente como Desenvolvimento e Produção.

Clique no botão Novo para adicionar outro perfil (Figura 6). Para vincular esse perfil a um banco, selecione-o no campo Perfil (Figura 3) no momento que adicionar um novo banco de dados ou editar um existente. 

Figura 6 - Janela de gerenciamento dos perfis de banco de dados

Perfil padrão

É possível adicionar um perfil como padrão, dessa forma não será necessário selecionar um perfil toda vez que for rodar o projeto. Para selecionar o perfil padrão, abra as configurações do projeto e selecione o perfil desejado.

Figura 7 - Selecione um dos perfis como padrão

Vincular o banco ao seu projeto

Para saber como gerar as tabelas automaticamente ou tabelas e as camadas Entity e DAO automaticamente ou realizar engenharia reversa de um banco de dados, acesse a documentação do Diagrama de classe.