1. Escolha Arquivo > Novo projeto (Ctrl-Shift-N). Selecione Aplicação Web na categoria Web e clique em Próximo.
2. Digite ZooApp para o nome do projeto e defina a localização do projeto.
3. Desmarque a opção Usar pasta dedicada, se ela estiver selecionada.
   (Para este tutorial, não há motivo para copiar as bibliotecas do projeto para uma pasta dedicada porque você não precisará compartilhar bibliotecas com outros usuários.)
   Clique em Próximo.
4. Defina o servidor como GlassFish e defina a versão de Java EE Java EE 5. Clique em Próximo.
5. Selecione a caixa de verificação JavaServer Faces e clique em Terminar.

Resumo

Neste exercício, você criou uma aplicação Web Java EE 5 que conterá as classes de entidade.

Criando uma unidade de persistência

1. Clique com o botão direito do mouse no da aplicação Web ZooApp na janela Projetos e escolha Novo > Outro para abrir o assistente para Novo arquivo.
2. Na categoria Persistência, selecione Unidade de persistência e clique em Próximo.
3. Preserve o nome da unidade de persistência padrão.
4. Para o Provedor de persistência, use TopLink (default).

   O provedor padrão é o TopLink Essential.jar. TopLink Essential.jar contém as bibliotecas da persistência Java. Nosso gerenciador de entidade se encontra em TopLink Essential.jar.

5. Para Fonte de dados, use a fonte de dados padrão jdbc/sample.

   A fonte de dados jdbc/sample já está configurada para conectar o banco de dados Java DB incluído no servidor da aplicação GlassFish. Você pode usar outro banco de dados, se criar uma fonte de dados para o banco de dados.

6. Verifique se a unidade de persistência está usando a API de transação de Java e se a Estratégia de geração de tabela está definida como Criar, de modo que as tabelas baseadas nas classes de entidade sejam criadas quando a aplicação for implantada.
7. Clique em Terminar.

Ao clicar em Terminar, o IDE cria persistence.xml e o abre no Editor de código-fonte na exibição Design. Você pode clicar em XML na barra de ferramentas do editor de código-fonte para ver o XML de persistence.xml. Esse arquivo contém as informações que o contêiner Java EE 5 precisa para gerenciar as entidades e a persistência do aplicativo.

Resumo

Neste exercício, você criou uma unidade de persistência para especificar a fonte de dados, as classes de entidade a serem persistidas e o gerenciador de entidades que o contêiner usará para gerenciar o ciclo de vida das entidades.

Criando a classe de entidade Animal e Pavilion

Primeiro, você criará as classes de entidade Animal e Pavilion. As classes representam as tabelas ANIMAL e PAVILION no banco de dados.

Quando você cria a classe de entidade, o IDE adiciona a anotação @Entity para definir a classe como uma classe de entidade. Depois de criar a classe, você criará os campos na classe para representar os dados que deseja em sua tabela, e usará anotações para fornecer informações adicionais sobre alguns dos campos.

Cada classe de entidade deve ter uma chave primária. Quando você cria a classe de entidade, o IDE adiciona a anotação @Id para declarar o campo a ser usado como chave primária. O IDE também adiciona a anotação @Generated para especificar a estratégia de geração de chave para o Id primário.

Para criar as classes de entidade, faça o seguinte:

1. Clique com o botão direito do mouse no nó do projeto ZooApp e escolha Novo > Outro.
2. Na categoria Persistência, selecione Classe de entidade e clique em Próximo.
3. Digite Animal para o nome da classe, digite entity para o pacote e deixe o Tipo de chave primária como Long. Clique em Terminar.
4. Repita as etapas acima para criar a classe Pavilion no pacote de códigos-fonte entity.

Quando você clica em Terminar, as novas classes de entidade se abrem no editor. Se expandir o nó entity sob Pacotes de códigos-fonte na janela Projetos, você pode ver que as classes de entidade Animal e Pavilion estão lá.

Definindo os campos na classe Animal

Abra a classe Animal no editor e faça o seguinte:

1. Adicione as seguintes declarações de campo à classe (em negrito):

   public class Animal implements Serializable {
   
       private static final long serialVersionUID = 1L;
       private Long id;
       private String name;
       private String kind;
       private String weight;
       private Pavilion pavilion;

2. Clique com o botão direito do mouse no Editor de código-fonte e escolha Inserir código (Alt-Insert) e, em seguida, selecione Getter e Setter para abrir a caixa de diálogo Gerar getters e setters.
3. Na caixa de diálogo Gerar getters e setters, selecione todos os campos e clique em Gerar.
   

   Na caixa de diálogo Gerar getters e setters, você pode usar a seta para cima no teclado para mover o item para o item Animal e pressionar a barra de espaços para selecionar todos os campos em Animal.

4. Agora você deseja alterar o nome das colunas que serão criadas na tabela Animal de forma que a coluna seja chame animalName em vez de name. Você pode usar anotações para especificar o nome da coluna gerada, adicionando a anotação seguinte acima da declaração do campo name:

      @Column(name="animalName")
       private String name;

5. Quando você anotou o campo name com a anotação @Column, o IDE exibiu um aviso na margem esquerda ao lado do identificador da classe. Clique no ícone de aviso na margem e selecione Unificar acesso do campo.
   

   Quando você clica em Unificar acesso do campo, o IDE move as anotações @Id e @GeneratedValue do getter getId

   de forma que as anotações agora fiquem diretamente sobre private Long id.
6. A coluna pavilion em nossa tabela Animal também deve ter uma relação muitos para um. Você pode fazer isso usando anotações, adicionando a anotação seguinte acima da declaração pavilion:

      @ManyToOne
       private Pavilion pavilion;

7. Pressione Alt-Shift-I para gerar as instruções de importação necessárias para a classe.
8. Salve as alterações.

Na próxima etapa definiremos os campos na classe de entidade Pavilion.

Definindo os campos na classe Pavilion

Abra a classe Pavilion no editor e faça o seguinte:

1. Adicione as seguintes declarações de campo à classe (em negrito):

   public class Pavilion implements Serializable {
   
       private static final long serialVersionUID = 1L;
       private Long id;
       private String name;
       private String address;
       private Collection <Animal> animals;

2. Adicione a seguinte anotação acima da declaração name para alterar o nome da coluna gerada:

      @Column(name="pavilionName")
       private String name;

3. Adicione a notação seguinte acima da coleção animals para especificar uma relação Um para muitos para a entrada:

      @OneToMany(mappedBy="pavilion")
       private Collection <Animal> animals;

4. Clique com o botão direito do mouse no editor e escolha Inserir código (Alt-Insert) e, em seguida, selecione Getter e setter.
5. Na caixa de diálogo Gerar getters e setters, selecione todos os campos e clique em Gerar.
   
6. Clique no ícone de aviso na margem e em unificar acesso do campo como fez para a classe Animal.
7. Pressione Alt-Shift-I para gerar quaisquer instruções de importação ausentes.
8. Salve as alterações.

Resumo

Neste exercício, você criou duas classes de entidade e definiu campos. Você também usou anotações para definir as propriedades de algumas das colunas nas tabelas que serão geradas quando você implantar o aplicativo.

Problema com o assistente para Novas páginas JSF de classe de entidade

Quando usa o assistente para criar páginas JSF a partir de uma classe de entidade, talvez você veja a seguinte mensagem de erro no assistente:

Este assistente pode ser utilizado somente em um projeto da Web com suporte a JSF.

Se você vir essa mensagem, precisará verificar se o framework Java Server Faces foi adicionado às propriedades do projeto. Você pode adicionar o suporte a Java Server Faces em seu projeto da Web, fazendo o seguinte:

1. Clique com o botão direito do mouse no nó do projeto de aplicação Web na janela Projetos e selecione Propriedades.
2. Selecione Frameworks no painel Categorias da caixa de diálogo Propriedades do projeto e clique em Adicionar.
3. Na caixa de diálogo Selecionar frameworks, selecione Java Server Faces e clique em OK.
4. Clique em OK na caixa de diálogo Propriedades do projeto para fechar a janela.

Depois de adicionar o framework JSF às propriedades do projeto, você deve ser capaz de criar as páginas JSF usando o assistente.

Ao modificar os dados de Pavilion você obtém IllegalArgumentException

Se você vir as categorias seguintes:

java.lang.IllegalArgumentException: Expected a child component type of UISelectItem/UISelectItems for component type javax.faces.SelectMany(animals). Found null.

o problema é causado provavelmente pelos métodos getter e setter incorretos para Coleção <Animal> na classe Pavilion.

Certifique-se de que os getters e setters de Coleção <Animal> se parecem com o seguinte:

public Collection<Animal> getAnimals() {
    return animals;
}

public void setAnimals(Collection<Animal> animals) {
    this.animals = animals;
}

Se os getters e setters não estiverem corretos em seu projeto, façam o seguinte:

1. Exclua as classes Controller e Converter das classes de entidade.
2. Exclua os diretórios animal e pavilion sob o nó Páginas da Web na janela Projetos.
3. Corrija os getters e setters na classe de entidade Pavilion.
4. Use o assistente para Páginas JSF de classe de entidade para regerar as classes Controllers e Converter das páginas JSF.