Visualizando a estrutura do banco de dados

Para ver se as tabelas foram criadas corretamente, expanda o nó Tabelas sob o nó da conexão do banco de dados. Você pode expandir um nó da tabela para ver as colunas, índices e quaisquer chaves estrangeiras da tabela. Você pode clicar com o botão direito do mouse em uma coluna e escolher Propriedades para visualizar informações adicionais sobre a coluna.

Se você não vir quaisquer tabelas sob o nó Tabelas, clique com o botão direito do mouse no nó Tabelas e escolha Atualizar.

Se você observar a estrutura do banco de dados consult, verá que o banco de dados contém tabelas que possuem uma variedade de relacionamentos e vários tipos de campo. Ao criar classes de entidade a partir de um banco de dados, o IDE gera automaticamente o código apropriado para os vários tipos de campo.

A tabela seguinte descreve as tabelas encontradas no banco de dados consult.

O banco de dados consult inclui uma variedade de relacionamentos. Ao criar classes de entidade a partir de um banco de dados, o IDE gera automaticamente o código apropriado para os relacionamentos da tabela, adicionando as anotações apropriadas aos campos nas classes de entidade. A tabela seguinte descreve os relacionamentos de tabela encontrados no banco de dados consult. (Os relacionamentos inversos não são mostrados.)

Agora que o banco de dados está criado, você pode criar a aplicação Web e usar o assistente para Classes de entidade do banco de dados com base nas tabelas do banco de dados.

Editando Address.java

Abra a classe de entidade Address faça as alterações seguintes.

1. Modifique a instrução de retorno do método toString para retornar o endereço completo.

   return line1 + ", " + line2 + ", " + city + ", " + region + ", " + country + ", " + postalCode;

   Você pode usar o auto-completar de código do IDE para ajudá-lo a adicionar os campos.

   
2. Corrija suas importações, se necessário, e salve suas alterações.

Editando Billable.java

Abra a classe de entidade Billable e faça as seguintes alterações.

1. Modifique a instrução de retorno do método toString para retornar à descrição, id do consultor e projeto:

   public String toString() {
           return description + ", " + consultantId + ", " + project;

2. Corrija suas importações, se necessário, e salve suas alterações.

Editando Client.java

1. Modifique a anotação @OneToMany no campo recruiterCollection para tornar o relacionamento um para um e alterar o campo de uma coleção para Recruiter recruiter.

   @OneToOne(mappedBy = "client")
   private Recruiter recruiter;

2. Modifique os getters e setters de Collection<Recruiter> recruiterCollection de acordo com as alterações no nome do campo. O novo getter e setter terá a seguinte aparência:

   public Recruiter getRecruiter() {
       return recruiter;
   }
   
   public void setRecruiter(Recruiter recruiter) {
       this.recruiter = recruiter;
   }

   Talvez seja mais simples excluir o getter e setter de Collection<Recruiter> recruiterCollection e gerar um novo getter e setter para Recruiter recruiter usando a caixa de diálogo Inserir código. Para criar um novo getter e setter, clique com o botão direito do mouse no código-fonte e escolha Inserir código (Alt-Insert) e selecione Getter e Setter. Selecione recruiter na caixa de diálogo Gerar getter e setter e clique em Gerar.

   
3. Modifique a instrução de retorno do método toString para retornar String.valueOf(clientPK).

   public String toString() {
       return String.valueOf(clientPK);
   }

4. Corrija suas importações, se necessário, e salve suas alterações.

Editando ClientPK.java

1. Modifique a instrução de retorno do método toString para retornar o nome do cliente e o número do departamento.

   public String toString() {
       return clientName + ", " + "Dept. " + clientDepartmentNumber;
   }

2. Corrija suas importações, se necessário, e salve suas alterações.

Editando Consultant.java

1. Modifique a instrução de retorno do método toString para retornar ao email.

   public String toString() {
       return email;
   }

2. Corrija suas importações, se necessário, e salve suas alterações.

Editando ConsultantStatus.java

1. Modifique a instrução de retorno do método toString para retornar o ID do status e a descrição.

   public String toString() {
       return statusId + ", " + description;
   }

2. Corrija suas importações, se necessário, e salve suas alterações.

Editando Project

1. Modifique a instrução de retorno do método toString para retornar o seguinte:

   public String toString() {
       return (projectPK == null ? "(unnamed project)" : projectPK.getProjectName()) + ", " + client;
   }

2. Corrija suas importações, se necessário, e salve suas alterações.

Editando Recruiter.java

1. Modifique a anotação @ManyToOne no campo client para tornar o relacionamento um para um.

   @OneToOne
   private Client client;

2. Modifique a instrução de retorno do método toString para retornar o email.

   public String toString() {
       return email;
   }

3. Corrija suas importações, se necessário, e salve suas alterações.

Sobre a ativação do Ajax no aplicativo

O painel final do assistente para Páginas JSF de classes de entidade lhe dá a opção de selecionar Ativar com Ajax páginas geradas para ativar a funcionalidade Ajax no aplicativo através da extensão Dynamic Faces para o framework JSF. O assistente adiciona as bibliotecas de extensões JSF obrigatórias ao projeto e configura o descritor de deployment do aplicativo para ativar o ciclo de vida do Ajax. Para saber mais sobre as extensões JSF do Dynamic Faces, consulte o site de extensões de tecnologia do JavaServer Faces.

Se você selecionar a opção, o assistente realiza as seguintes ações.

• Adiciona bibliotecas de extensões JSF ao projeto (jsf-extensions-common, jsf-extensions-dynamic-faces, commons-logging e shale-remoting) que são necessárias para o uso da tecnologia Dynamic Faces no projeto.
  
• Modifica web.xml para configurar o FacesServlet para usar o ciclo de vida do Ajax, adicionando uma entrada do parâmetro de inicialização javax.faces.LIFECYCLE_ID e configurando o valor para com.sun.faces.lifecycle.PARTIAL.
  
• Gera o arquivo de fragmento JSP AjaxScripts.jspf no diretório WEB-INF/jspf. AjaxScripts.jspf renderiza arquivos JavaScript contidos nas bibliotecas do Dynamic Faces.

O aplicativo contém um arquivo JavaScript jsfcrud.js no diretório Páginas da Web. O arquivo jsfcrud.js verifica se o Dynamic Faces está ativado, ao checar se os arquivos JavaScript do Dynamic Faces foram renderizados. Se o Dynamic Faces estiver ativado, o formulário será configurado para enviar solicitações do Ajax.

Depois de ativar o Ajax no aplicativo com extensões do Dynamic Faces, você pode modificar o aplicativo para adicionar mais funcionalidade fornecida pelas extensões do Dynamic Faces.

Gerando classes de controlador JPA a partir de classes de entidade

Na aplicação Web gerada, os métodos do controlador JPA são acessados pelos métodos da classe do controlador JSF. Quando você usa o assistente para Páginas JSF de classes de entidade, o IDE gera automaticamente as classes do controlador JPA de cada uma das entidades selecionadas. Mas o uso de classes do controlador JPA não está restrito a aplicações Web JSF. Você pode usar as classes do controlador JPA em outros aplicativos que usem a API de persistência Java (por exemplo, em aplicativos de área de trabalho) para trabalhar com classes de entidade e gerenciar a persistência da entidade.

O assistente para Classes do controlador JPA de classes de entidade permite que você crie facilmente as classes do controlador JPA nos projetos. Para criar as classes do controlador JPA, abra o assistente para Novo arquivo e escolha Classes do controlador JPA de classes de entidade na categoria Persistência. No assistente, você especifica as classes de entidade para as quais deseja criar as classes do controlador JPA e determina onde deseja que o IDE crie os arquivos. O assistente também cria automaticamente as classes de exceção usadas pelas classes do controlador JPA.

Depois de gerar os controladores JPA, você pode acessar os métodos do controlador a partir de outros arquivos. Se você atualizar o esquema do seu banco de dados, poderá executar novamente o assistente para Classes de entidade do banco de dados e o assistente para Controladores JPA de classes de entidade para atualizar as classes. Se desejar, depois de criar as classes do controlador JPA, você poderá executar o assistente para Páginas JSF de classes de entidade e especificar o pacote das classes do controlador JPA existentes. Nesse caso, as classes existentes do controlador JPA serão reutilizadas em vez de geradas novamente.

Adicionando dados com um script SQL

Caso não deseje adicionar os dados por meio de formulários Web, você pode executar o script derby_insert_data_consult.sql incluído em derby-consult.zip.

1. Abra derby_insert_data_consult.sql, escolhendo Arquivo > Abrir arquivo no menu principal.

   O arquivo se abre automaticamente no editor SQL.

2. Verifique se o banco de dados consult está selecionado na lista suspensa Conexão na barra de ferramentas do editor SQL e clique no botão Executar SQL na barra de ferramentas.
   

   Você pode ver o resultado da execução do script na janela Saída.

Observação. Se você estiver usando o servidor de banco de dados MySQL, abra o arquivo mysql_insert_data_consult.sql incluído no mysql-consult.zip.

Adicionando dados com a interface Web

Você pode adicionar o banco de dados, iniciando o aplicativo em seu navegador e adicionando os dados através de formulários Web.

1. Clique em Executar projeto principal na barra de ferramentas principal.

   O IDE salva todos os arquivos alterados, reconstrói e reimplanta o aplicativo no servidor. Seu navegador da Web padrão se abre no endereço local http://localhost:8080/ConsultingAgency/.

   
2. Clique em Mostrar todos os itens do endereço e clique em Novo endereço.
3. Adicione os dados seguintes no formulário Novo endereço.

   Campo	Valor
   Line1	100 Data Street
   Line2	Suite 432
   City	San Francisco
   Region	California
   Country	USA
   PostalCode	94103

   Clique em Criar.
4. Clique em Índice para voltar à página de índice.
5. Clique em Mostrar todos os itens do cliente e clique em Novo cliente.
6. Adicione os dados seguintes no formulário Novo cliente.

   Campo	Valor
   ClientDepartmentNumber	2000
   Client Name	Big Data Corp.
   Contact Email
   Contact Password	accounting

7. Selecione Palm Spring Street na lista suspensa BillingAddress.
8. Clique em Criar e em Índice para retornar para a página de índice.
9. Clique em Mostrar todos os itens do projeto e clique em Novo projeto.
10. Adicione os dados seguintes no formulário Novo projeto.

    Campo	Valor
    ProjectName	Secret Project
    ContactEmail
    ContactPassword	project.manager

    Clique em Criar e em Índice para retornar para a página de índice.
11. Clique em Mostrar todos os itens de status do consultor e em Status do novo consultor.
12. Adicione os dados seguintes no formulário Novo status do consultor.

    Campo	Valor
    StatusId	A
    Description	Active

    Clique em Criar e em Índice para retornar para a página de índice.
13. Clique em Mostrar todos os itens do consultor e em Novo consultor.
14. Adicione os dados seguintes no formulário Novo consultor.

    Campo	Valor
    Email
    Password	janet.smart
    HourlyRate	80
    BillableHourlyRate	120

15. Selecione Secret Project no campo ProjectCollection.
16. Selecione A, Active na lista suspensa StatusId.
17. Clique em Criar e em Índice para retornar para a página de índice.
18. Clique em Mostrar todos os itens faturáveis e clique em Novo faturável.
19. Adicione os dados seguintes no formulário Novo faturável.

    Campo	Valor
    StartDate	2008-10-13 00:00:00.0
    EndDate	2008-10-17 00:00:00.0
    Hours	40
    HourlyRate	80
    BillableHourlyRate	120
    Description	begin gathering requirements
    ConsultantId
    Project	Secret Project

    Clique em Criar e em Novo faturável.
20. Adicione os dados seguintes no formulário Novo faturável.

    Dessa vez você digitará finish gathering requirements no campo Description.

    Campo	Valor
    StartDate	2008-10-20 00:00:00.0
    EndDate	2008-10-24 00:00:00.0
    Hours	40
    HourlyRate	80
    BillableHourlyRate	120
    Description	finish gathering requirements
    ConsultantId
    Project	Secret Project

    Clique em Criar para voltar à página de índice.
21. Clique em mostrar todos os itens do recrutador e em Novo recrutador.
22. Adicione os dados seguintes no formulário Novo recrutador.

    Campo	Valor
    Email
    Password	bob

23. Selecione na lista ConsultantCollection.

Observação. Deixe a lista suspensa Cliente vazia.

24. Clique em Criar e em Índice para retornar para a página de índice.

Depois de adicionar os dados ao banco de dados, você pode navegar pelas páginas geradas para ver os relacionamentos entre as tabelas.

Campos de chave primária somente leitura

Se um campo no banco de dados for uma chave primária, o assistente irá gerar o código para evitar que o usuário edite o campo nos formulários gerados. Os exemplos seguintes ilustram as instâncias em que o campo de chave primária é somente leitura.

• Se você navegar para a página Novo cliente, poderá ver que o campo ProjectCollection é somente leitura. Se o aplicativo permitisse uma tentativa de alterar o cliente associado a um projeto existente, a operação falharia porque o cliente associado a um projeto é parte da chave primária do projeto. Você pode verificar isso no script SQL, examinando a chave primária consult_project_pk e a chave estrangeira consult_project_fk_client_name.
• Se você navegar para Editando a página do projeto, poderá ver que o campo Client é somente leitura. O campo é somente leitura porque o cliente associado a um projeto é parte da chave primária do projeto.

Verificações de erro gerado

O código gerado pode verificar se a ação de um usuário resultará em um erro. Por exemplo, se uma tabela possui uma coluna que não pode ser nula, o código poderá verificar se uma ação resultará que esse campo seja nulo e exibirá uma mensagem de erro. Depois de preencher o banco de dados, você poderá ver exemplos das verificações geradas, tentando editar os dados nos formulários. Você receberá uma mensagem de erro, se tentar fazer as seguintes ações.

• Criar outro item Projeto, especificando novamente Secret como ProjectName, e preenchendo os campos ContactEmail e Client.

  Aparece uma mensagem de erro indicando que o item já existe.

• Criar outro item Endereço, mas deixar todos os campos em branco.

  Aparecem mensagens de erro indicando os campos obrigatórios.

• Edite o item Consultor "", cancelando a seleção de "finish gathering requirements" na lista BillableCollection.

  Aparece uma mensagem de erro indicando que o item Faturável que você desmarcou deve ser mantido porque seu campo consultantId não pode ser nulo.

• Destruir o item Projeto "Secret Project, Big Data Corp., Dept. 2000".

  Aparece uma mensagem de erro indicando que o item Projeto não pode ser destruído porque nos itens Faturável associados o campo project não pode ser nulo.

• Destruir um item que já tenha sido destruído por outro usuário.

  Aparece uma mensagem de erro indicando que o item não existe mais e ele não é mais exibido na lista.

  Você pode fazer isso caso use dois navegadores e navegue para a mesma página (por exemplo, a página Listando itens faturáveis) em cada navegador. Destruir um dos itens Faturável em um dos navegadores e tentar destruir o mesmo item no outro navegador.