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 (Para mais informações sobre os tipos de geração da camada de persistência, acesse a documentação oficial do EclipseLink).
    • Criar ou Atualizar Tabelas: gera as tabelas do banco de dados, caso elas não existam, ou inclui novas colunas de tabelas existentes, mas não apaga os dados ou altera os tipos dos dados das tabelas do banco de dados. É importante destacar que essa configuração não realiza alterações como renomear ou excluir colunas já existentes.
    • 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
titleAlteraçã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.

Â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
titleObservação

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 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

Nesta página

Índice


Conteúdo complementar