Criar uma entidade Java persistente com campos persistentes

Este guia de iniciação rápido mostra como criar uma nova entidade Java persistente. O objectivo é criar uma entidade para associar a uma tabela de base de dados. Será igualmente necessário adicionar a tabela ADDRESS à base de dados.

  1. Seleccione o projecto JPA no Navegador ou no Explorador de Projecto e depois clique em Novo > Outro. Surge o diálogo Seleccionar assistente.

  2. Seleccione JPA > Entidade e depois clique em Seguinte. Surge a página Classe da Entidade.

  3. Introduza o nome do pacote (como, por exemplo, quickstart.demo.model), o nome da classe (como, por exemplo Address) e, de seguida, faça clique em Seguinte. Surge a página Propriedades da entidade, que permite ao utilizador definir os campos de persistência que irá correlacionar às colunas de uma tabela de base de dados.

  4. Utilize o diálogo Campos de entidade (chamado ao fazer clique em Adicionar) para adicionar campos de persistência à classe Address:

    private Long id;
    private String city;
    private String country;
    private String stateOrProvince;
    private String postalCode;
    private String street;
    

    Nota:

    Será igualmente necessário adicionar as seguintes colunas à tabela ADDRESS da base de dados:
    NUMBER(10,0) ADDRESS_ID (chave principal)
    VARCHAR2(80) PROVINCE
    VARCHAR2(80) COUNTRY
    VARCHAR2(20) P_CODE
    VARCHAR2(80) STREET
    VARCHAR2(80) CITY
    

  5. Faça clique em Terminar. Após concluir a criação da entidade JPA, o Eclipse apresenta a entidade Address na vista Estrutura de JPA.

    Address.java inclui a anotação @Entity, os campos de persistência, bem como os métodos getter e setter para cada um dos campos.

Entidade Address em Address.java

Editor de Java com a entidade Address.

O Eclipse apresenta igualmente a entidade Address na vista Estrutura da JPA:

Entidade Address na vista Estrutura de JPA

Address.java na vista Estrutura de JPA.
  1. Seleccione a classe Endereço na vista Explorador de Projecto.

  2. Na vista Detalhes de JPA, tenha em atenção como Dali associou automaticamente a tabela ADDRESS à entidade por terem o mesmo nome.


    Nota:

    Consoante o seu tipo de ligação à base de dados, pode ser necessário especificar o Esquema.

    Vista Detalhes de JPA para a entidade Address

    Address.java na vista Detalhes de JPA.

Sugestão:

Depois de associar a entidade à tabela da base de dados, deve actualizar o ficheiro persistence.xml de forma a incluir esta entidade de JPA.

Faça clique com o botão direito do rato no ficheiro persistence.xml no Explorador de Projectos e seleccione Ferramentas JPA > Sincronizar Lista de Classes. Dali adiciona o seguinte ao ficheiro persistence.xml:

<class>quickstart.demo.model.Address</class>


Está agora tudo pronto para correlacionar cada campo da classe Address a uma coluna da tabela da base de dados.

  1. Seleccione o campo id da vista Detalhes de JPA.

  2. Faça clique com o botão direito do rato em id e, de seguida, seleccione Correlacionar como> id.

  3. Na vista Detalhes de JPA, seleccione ADDRESS_ID no campo Nome:

    Vista Detalhes de JPA para o campo addressId

    A vista Detalhes de JPA para o atributo id da entidade Address.

    Eclipse adiciona as seguintes anotações à entidade Address:

    @Id
    @Column(name="ADDRESS_ID")
    
  4. Correlacione cada um dos campos seguintes (como correlações Básicas) com a respectiva coluna da base de dados:

    Campo Correlacionar como Coluna da base de dados
    city Básica CITY
    country Básica COUNTRY
    postalCode Básica P_CODE
    provinceOrState Básica PROVINCE
    street Básica STREET

Dali correlaciona automaticamente certos campos com a coluna certa (como o campo city com a coluna City) no caso de os nomes serem iguais.