Versões comparadas
Chave
- Esta linha foi adicionada.
- Esta linha foi removida.
- A formatação mudou.
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.
Aviso |
---|
Fique atento ao banco de dados selecionado (destaque 1 da 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ão 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 que possuem classes vinculadas no diagrama, incluindo os dados, e as recria novamente com as alterações feitas no diagrama de dados;
Aviso Cuidado ao utilizar essa opção vinculando o Diagrama de dados ao Banco de dados de produção.
- 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 estejam 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.
Nota |
---|
A janela de conflito só ocorre quando a IDE estiver no Modo Avançado. |
Figura 4 - Janela de conflitos
Aviso | ||
---|---|---|
| ||
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. |
Âncora classes-inexistentes classes-inexistentes
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 (Namespace) 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.
Informações | ||
---|---|---|
| ||
Apagar a entidade do diagrama utilizando as opções Apagar e recriar tabelas e Remover entidades antes de gerar não fará com que a tabela da entidade também seja deletada do banco de dados, para . Para fazer isso o usuário terá que removê-la manualmente do banco de dados. |
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.
Nota |
---|
Estes arquivos somente serão exibidos ao selecionar o Modo Avançado. |
Figura 6 - Arquivos das camadas DAO e Entity