Skip to end of metadata
Go to start of metadata

Neste passo vamos gerar os CRUDs (Create, Read, Update e Delete), que são as quatro operações básicas que o sistema faz no banco de dados. O CRUD é comum em aplicações web, porque fornece um modelo completo e simples para manipular os dados.

Visão Geral

Ao gerar um CRUD, uma página é criada contendo os dados da entidade selecionada em um grade e um formulário para inserir / editar item, esses 2 elementos podem ter relacionamento com outras entidades. Como podemos ver na Figura 1.1, essa página vem por padrão com: nome da entidade, campo de busca de itens, botão + ADICIONAR que abre um formulário vazio, grade com as colunas pré selecionadas dessa entidade e a coluna de ação, que possui os botões de edição e exclusão de item.

Figura 1.1 - CRUD no Cronapp


Assistente de View para o Diagrama (Figura 1.2) fica no Diagrama de dados. Ao abrir, devemos seguir algumas poucas etapas de configuração para selecionar as entidades que irão gerar o CRUD e adequar cada página as necessidades do seu projeto. Abaixo as etapas necessárias:

  1. Define o modelo e o endereço onde será criado;
  2. Seleção das entidades:
  3. Configuração de cada entidade
    1. Seleciona as colunas da grade e
    2. Seleciona os campos do formulário, para a criação ou edição dos itens.

Etapa 1: Template

Para iniciar a funcionalidade Assistente de CRUD para Diagrama basta clicar no seu respectivo botão, item 1 da figura 1.2.

Nessa primeira etapa selecionaremos qual o modelo de template que queremos e o endereço onde serão criadas as páginas.

Figura 1.2 - Assistente de view para Diagrama

 

  1. Assistente de view para o diagrama: abre a janela de configuração;
  2. Busca: pesquisa pelos modelos de template disponíveis;
  3. Lista de seleção dos modelos;
  4. Formulário: endereço onde serão criados os CRUD;
  5. "…": abre a janela de seleção do diretório;
  6. Busca: filtra o nome dos diretórios;
  7. Lista de seleção dos diretórios;
  8. Diretório selecionado: exibe o endereço do diretório selecionado;
  9. Selecionar: botão de confirmação do diretório selecionado;
  10. Avançar: Avança para seleção de entidades.

Etapa 2: Seleção das entidades

Nessa fase selecionaremos as entidades que gerarão os CRUDs. Ao clicarmos no item 3 da figura 1.3, seremos direcionados para a etapa 3.

Figura 1.3 - Seleção das entidades que irão gerar CRUDs


  1. Busca: pesquisa pelas entidades existentes;
  2. Lista de entidades: seleção das entidades;
  3. "…": abre a janela de customização da grade e do formulário do CRUD dessa entidade, etapa 3;
  4. Finalizar: conclui o Assistente de view para o diagrama e gera as páginas.

Etapa 3: Configuração da grade e formulário da entidade

As janelas da figura 1.4 serão exibidas ao clicar no botão "..." de uma entidade (item 3 da figura 1.3). Na primeira janela configuraremos os itens que serão exibidos na listagem da grade, enquanto que a segunda janela selecionamos os campos que poderão ser inseridos ou editados no formulário do CRUD.

Figura 1.4 - primeiro selecionamos as colunas da grade e após avançar, os campos do formulário.

 

  1. Busca campos para grade: pesquisa pelos atributos da entidade que serão as colunas da grade;
  2. Lista dos atributos que serão listados na grade;
  3. ↑↓: ordena as colunas da grade;
  4. Filtro de campo pesquisável: define que a página terá um único campo pesquisável para todos os atributos, um campo de pesquisa específico para cada atributo ou não terá campo de pesquisa;
  5. Avançar: avança para o passo 3-b, seleção dos campos do formulário da entidade;
  6. Busca: filtra os atributos da entidade selecionada;
  7. Lista dos atributos que poderão ser editados no formulário*;
  8. ↑↓: ordena os campos do formulário;
  9. Finalizar (customização de entidade): retorna a janela de seleção de entidades (Passo 2) para finalizar o Assistente de view;

 

Dica

*Relacionamento com outras entidades: quando uma entidade se relaciona com outra, é possível exibi-la no formulário das seguintes formas:

  • 1toN: exibe uma caixa de seleção com o atributo da segunda entidade;
  • NtoM: exibe os atributos em forma de lista ou grade;

Conflito

Se ao finalizar o Formulário CRUD view (Item 4 da figura 1.3) já existir uma página com o mesmo nome, o Cronapp irá abrir uma janela exibindo as páginas que possuem conflito por alterações. Caso não queira substituir, basta desmarcar a seleção e clicar no botão Aplicar alterações aos itens marcados para evitar alterações.

Figura 1.5 - Conflito ao gerar um CRUD já existente


Dica

Lembramos que as entidades Role e User já possuem CRUD gerados ao criarmos o projeto, então caso tenha selecionado essas entidades, essa janela irá aparecer.

 

CRUD para uma única classe

As três etapas mostradas acima facilitam a criação de CRUDs para várias classes ao mesmo tempo, porém podemos selecionar apenas uma classe. A vantagem de gerar para apenas uma classe está opção de informar o nome da página, através do campo Escolha o nome do novo arquivo na etapa 1 e ao avançar, passaremos direto para a etapa 3, já que não existem classes para serem selecionadas. (Figura 1.6)

Figura 1.6 - Gerando CRUD somente para a classe Livro

 


Passos

Em nosso projeto de reserva de livros possuímos dois sistema: web e mobile, por isso teremos que utilizar o Assistente de CRUD três vezes.

  1. Grupo de acesso Administrador:
    • Sistema web - Páginas Reserva e Livro;
  2. Grupo de acesso Aluno:
    • Sistema web - Página Reserva e 
    • Sistema mobile - Tela Reserva;

Abra o diagrama de dados (veja onde abrir o Diagrama de dados) para seguir os passos abaixo.

Sistema web para Administrador

Modelo (Etapa 1 da Visão geral): 

  • Clique no botão Assistente de View para o diagrama (item 1 da Figura 1.2)
  • Selecione o modelo Formulário CRUD web e verifique se o endereço apontado no campo Formulário de Referência é o da pasta admin do webapp, caso contrário, clique no botão "…" (item 5 da figura 1.2), pesquise por admin e selecione a pasta com o endereço: src / main / webapp / views / admin.
  • Clique em Avançar.


Entidades (Etapa 2 da Visão geral):

  • Selecione apenas as entidades Livro e Reserva;

 

Campos da Grid e do Formulário (Etapa 3 da Visão geral) para a entidade Livro:

  • Clique no botão "…" (Customizando entidade) da entidade Livro
  • Confirme se apenas os atributos nome, autor e isbn estão selecionados e clique em Avançar;
  • Deixe marcado apenas os atributos nomeautor e isbn selecionados e clique em Finalizar.

 

Campos da Grid e do Formulário (Etapa 3 da Visão geral) para a entidade Reserva:

  • Novamente no Etapa 2 da Visão geral, clique no botão "…" (Customizando entidade) da entidade Reserva.
  • Confirme se apenas os atributos user, livro, dataReserva e dataEmprestimo estão selecionados e clique em Avançar;
  • Outra vez selecione apenas os atributos userlivrodataReserva e dataEmprestimo, clique em Finalizar.

De volta a janela de Entidades (Etapa 2 da Visão geral), clique em Finalizar para concluir o Assistente CRUD View para o sistema web.

A mensagem "Arquivo(s) gerado(s) com sucesso!" deve aparecer.

Sistema web para Aluno

Modelo (Etapa 1 da Visão geral):

  • Clique no botão de contexto (direito) do mouse na classe Reserva e selecione a opção Criar Visão para a entidade (Gerando para uma só página);
  • Selecione o modelo Formulário CRUD web e verifique se o endereço apontado no campo Formulário de Referência é o da pasta logged do webapp, caso contrário, clique no botão "…" (item 5 da figura 1.2 ), pesquise por logged e selecione a pasta com o endereço: src / main / webapp / views / logged;
  • No campo Escolha o nome do novo arquivo informe o nome reservaAlunoWeb;
  • Clique em Avançar.

 

Campos da Grid e do Formulário (Etapa 3 da Visão geral) para a entidade Reserva:

  • Confirme se apenas os atributos livro e dataReserva estão selecionados nos campos que aparecerão na listagem da Grade e clique em Avançar;
  • No campos do formulário deixe marcado apenas o atributo livro e clique em Finalizar.

A mensagem "Arquivo(s) gerado(s) com sucesso!" deve aparecer.

Sistema mobile para Alunos

Da mesma forma como fizemos para o sistema web, gerando uma página de reserva para alunos, iremos gerar a página reserva para aluno no mobile.

Modelo (Etapa 1 da Visão geral):

  • Clique no botão de contexto (direito) do mouse na classe Reserva e selecione a opção Criar Visão para a entidade (Gerando para uma só página  );
  • Selecione o modelo Formulário CRUD Mobile e verifique se o endereço apontado no campo Formulário é o da pasta logged do mobileapp, caso contrário, clique no botão "…" (item 5 da figura 1.2), pesquise por logged e selecione a pasta com o endereço: src / main / mobileapp / www / views / logged.
  • No campo Escolha o nome do novo arquivo informe o nome reservaAlunoMobile;
  • Clique em Avançar.

 

Campos da Grid e do Formulário (Etapa 3 da Visão geral) para a entidade Reserva:

  • Confirme se apenas os atributos livro e dataReserva estão selecionados nos campos que aparecerão na listagem da Grade e clique em Avançar;
  • No campos do formulário deixe marcado apenas o atributo livro, clique em Finalizar.

De volta a janela de Entidades (Etapa 2 da Visão geral), clique em Finalizar para concluir o Assistente de View para o diagrama para o sistema mobile.

A mensagem "Arquivo(s) gerado(s) com sucesso!" deve aparecer.

O que fizemos

Geramos 4 páginas a partir das classes do diagrama de dados: 2 páginas web na pasta administrador (admin), 1 página web na pasta autenticado (logged) e 1 tela mobile na pasta logado (logged).

Figura 2.1 - Páginas geradas para o projeto web

 

  • No labels