Utilize a funcionalidade gerar camada de persistência para criar ou atualizar o banco de dados do sistema e gerar as camadas de entity e DAO com base nas configurações do diagrama de dados.
Fique atento ao banco de dados selecionado (destaque 1 na figura 1), pois, a depender da configuração, essa ação poderá excluir todas os dados do seu banco!
Gerar camada de persistência
Ao clicar no ícone de atalho (seta da Figura 1) Gerar camada de persistência, a janela de configuração será aberta, permitindo selecionar as classes, informar o nome do pacote e selecionar o tipo de geração que ocorrerá no banco de dados selecionado (destaque 1 da Figura 1).
Figura 1 - Gerar camada de persistência
- Classes: permite selecionar quais as classes do diagrama gerarão a persistência.
- Namespace: nome do pacote e do diagrama que irá guardar os arquivos e as classes, respectivamente.
- Tipo de Geração: define como será gerado as tabelas do bando de dados;
- Criar ou Atualizar Tabelas: gera as tabelas do banco de dados pela primeira vez e/ou atualiza as tabelas já existentes, mas não apaga os dados do banco de dados;
- Apagar e Recriar Tabelas: apaga todas as tabelas do banco de dados, incluindo os dados, e as recria tudo novamente com as alterações feitas no diagrama de dados;
- Utilizar Tabelas Existentes: não realiza alterações no banco de dados, apenas cria as camadas DAO e entity.
- Desativar cache de consultas: desmarque para permitir que o sistema utilize cache de consulta, evitando várias requisições ao banco de dados com o mesmo resultado.
- Permitir configuração em tempo de execução: opção usada em conjunto com o evento "Para configurar conexão", esse campo possibilita que o banco de dados do sistema seja alterado em tempo de execução a partir de uma lógica pré-definida.
- Remover entidades antes de gerar: essa caixa de seleção só será exibida quando alguma classe das camadas DAO e entity não existirem no Diagrama. Veja mais detalhes em Classes inexistentes.
- Botão Gerar: executa a funcionalidade. O efeito das alterações só ocorrerá após rodar o projeto.
Classe específica
Caso queira gerar a persistência para uma única classe, clique com o botão direito e selecione a opção Criar camada de dados para a entidade (Figura 2). Ela irá abrir a janela Gerar camada de persistência (Figura 1), mas selecionará apenas a classe escolhida.
Figura 2 - Gerar camada de persistência somente para a classe selecionada
Seleção das classes
Por padrão, todas as classes existentes no diagrama são selecionadas no momento de gerar a persistência, mas isso pode ser alterado. Ao clicar no botão "..." (seta da Figura 3) que fica ao lado do campo Classes, será aberto a janela para selecionar as classes. Além disso, é possível filtrar as classes selecionando uma visão (destaque 1 da Figura 3) ou através do campo de pesquisa (2 da Figura 3).
Figura 3 - Selecionando classes para gerar persistência
- Opção Inverter todos: ao desmarcar essa opção, todas as classes que estevam selecionadas serão desmarcadas enquanto as classes previamente desmarcadas serão selecionadas.
Janela de conflitos
Ao gerar a camada de persistência pela segunda vez, uma janela de conflito de conteúdo será exibida, permitindo selecionar quais arquivos serão sobrescritos. Com um duplo clique sobre o arquivo, é possível visualizar quais partes do código ocorreu o conflito.
A janela de conflito só ocorre quando a IDE estiver no Modo Avançado.
Figura 4 - Janela de conflitos
Alteração de arquivos High-code
O conteúdo High-code, como as classes Java das camadas entity e DAO, além dos arquivos persistence.xml, SpringBootMain.java e outros, são mantidos e atualizados pelas ferramentas Low-code do Cronapp. Dessa forma, não recomendamos modificar esses arquivos manualmente, pois, ao utilizar recursos como Gerar camada de persistência, os dados inseridos manualmente nesses arquivos serão modificados ou excluídos.
Classes inexistentes
Quando uma classe gerada pelo diagrama for excluída somente do diagrama, ao gerar novamente a camada de persistência uma mensagem aparecerá informando que a classe ainda existe no pacote e dá a opção do usuário excluí-la do pacote automaticamente (destaque da Figura 5). A opção Remover entidades antes de gerar (destaque 1 da figura 5) só será exibida nesse tipo de situação.
Figura 5 - Remover entidades antes de gerar camada
Por segurança, após selecionar a opção Remover entidades antes de gerar (destaque 1 da figura 5.1) e clicar no botão Gerar, uma janela será exibida para confirmar a ação.
Figura 5.1 - Mensagem de confirmação para a exclusão das classes Java
Camadas DAO e Entity
Após finalizar a execução da funcionalidade, execute o projeto para que os arquivos das camadas DAO e Entity, além das tabelas do banco de dados, sejam criados.
Esses arquivos só serão exibidos ao selecionar o Modo Avançado.
Figura 6 - Arquivos das camadas DAO e Entity