Criar uma entidade JPA

Use este procedimento para criar uma entidade JPA:

  1. No Navegador ou no Explorador de Projectos, seleccione o projecto do JPA e Ficheiro > Novo > Outros . Abre-se o diálogo Seleccione um Assistente.

    Seleccionar o Assistente Criar uma Entidade JPA

    O diálogo Seleccione um Assistente com Entidade seleccionada.
  2. Seleccione JPA > Entidade e depois clique em Seguinte. Surge a página Classe da Entidade.

    Página Classe da Entidade

    A página Classe da Entidade do assistente Criar uma Entidade JPA.

    Preencha esta página da seguinte forma:

    • Seleccione o projecto JPA no campo Projecto.

    • No campo Pasta Origem, seleccione ou insira a localização da pasta src do projecto JPA.

    • Seleccione, ou insira, o nome do pacote de classes para esta entidade no campo Pacote de Java.

    • Insira o nome da classe de Java no campo Nome classe.

    • Caso seja necessário, insira ou seleccione, uma superclasse.

    • Se necessário, preencha a secção Herança como se segue (propriedades opcionais):

      • Aceite a opção Entidade (predefinição) para criar uma classe Java com a opção @Entity.

      • Em alternativa, seleccione Superclasse correlacionada (se tiver definido uma superclasse).

      • Seleccione Herança e depois seleccione uma das estratégias de correlação de heranças JSR 220 (SINGLE_TABLE, TABLE_PER_CLASS, JOINED).

      • Seleccione Adicionar a correlações de entidades em XML para criar correlações de XML no ficheiro orm.xml, em vez de anotações.

  3. Clique em Seguinte para continuar para a página Propriedades da Entidade onde vai definir os campos persistentes para a entidade.

    A Página Propriedades da Entidade

    A página Propriedades da Entidade do assistente Criar uma Entidade JPA.

    Em alternativa, clique em Terminar para concluir a entidade.

  4. Preencha a página da seguinte forma:

    1. Se necessário, introduza novo nome para a entidade. Tal resulta na adição de um atributo de nome à notação @Entity (@Entity(name="EntityName")).

    2. Aceite Utilizar a predefinição para utilizar o valor predefinido para nome da tabela correlacionada. Inserir outro nome resulta na adição da notação @Table com o respectivo atributo nome definido como nova tabela (@Table(name="TableName")).


      Nota:

      As opções da entidade relacionadas com o nome não estão disponíveis se tiver seleccionado Superclasse correlacionada na página Classe da Entidade

    3. Adicione campos de persistência à entidade fazendo clique em Adicionar. Aparece o diálogo Campos da Entidade.

      O Diálogo Campos da Entidade

      O diálogo Campos da Entidade
    4. Seleccionar um tipo de persistência na lista Tipos. Pode obter tipos adicionais com a função Procurar.

    5. Introduza o nome do campo e depois clique em OK. Repita este procedimento para cada campo.

    6. Se necessário, seleccione Chave para designar o campo como chave principal.

    7. Seleccione tipo de acesso Baseado em campos (predefinição) ou Baseado em propriedades.

  5. Faça clique em Terminar. O Eclipse adiciona a entidade ao seu projecto.

 

Referência relacionada

Assistente Criar Entidade JPA
Assistente Criar Novo Projecto JPA
Perspectiva de Programação de JPA

 

Tarefas relacionadas

Gerir o ficheiro persistence.xml
Dar persistência a uma classe

 

Conceito relacionado

Perceber a persistência Java
O ficheiro persistence.xml