Criando uma Entidade Persistente Java com Campos Persistentes

Este início rápido mostra como criar uma nova entidade persistente Java. Criaremos uma entidade para associar com uma tabela de banco de dados. Você também precisará incluir a tabela ADDRESS em seu banco de dados.

  1. Selecione o projeto JPA no Navigator ou Project Explorer e, em seguida, clique em Novo > Outro. O diálogo Selecionar um Assistente aparece.

  2. Selecione Entidade > JPA e depois clique em Avançar. A página Classe de Entidade aparece.

  3. Digite o nome do pacote (como quickstart.demo.model), o nome da classe (como Endereço) e, em seguida, clique em Avançar. A Página Propriedades de Entidade aparece, permitindo definir os campos de persistência, que mapearão para as colunas de uma tabela de banco de dados.

  4. Utilize o diálogo Campos da Entidade (chamado ao clicar em Incluir) para incluir campos de persistência às Classes de Endereços:

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

    Nota:

    Você também precisará incluir as seguintes colunas na tabela de banco de dados ADDRESS:
    NUMBER(10,0) ADDRESS_ID (chave primária)
    VARCHAR2(80) PROVINCE
    VARCHAR2(80) COUNTRY
    VARCHAR2(20) P_CODE
    VARCHAR2(80) STREET
    VARCHAR2(80) CITY
    

  5. Clique em Concluir. Com Criar Entidade JPA concluído, o Eclipse exibirá a entidade Endereço na visualização Estrutura JPA.

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

Entidade de Endereço em Address.java

Editor Java com a entidade Endereço.

O Eclipse também exibe a entidade Endereço na visualização Estrutura do JPA:

Entidade de Endereço na Visualização de Estrutura JPA

Address.java na Visualização de Estrutura JPA.
  1. Selecione a classe Endereço na visualização do Project Explorer.

  2. Na visualização Detalhes do JPA, observe que Dali foi associado automaticamente à tabela de banco de dados ADDRESS com a a entidade porque eles tinham nomes idênticos.


    Nota:

    Dependendo do tipo de conexão do banco de dados, você pode precisar especificar o Esquema.

    Visualização Detalhes do JPA para a Entidade Endereço

    Address.java na visualização Detalhes JPA.

Dica:

Depois de associar a entidade à tabela de banco de dados, você deve atualizar o arquivo persistence.xml para incluir esta entidade JPA.

Clique com o botão direito do mouse no arquivo persistence.xml no Explorador de Projetos e selecione Ferramentas JPA > Sincronizar Lista de Classes. Dali inclui o seguinte no arquivo persistence.xml:

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


Agora estamos prontos para mapear cada campo na classe Endereço para uma coluna na tabela de banco de dados.

  1. Selecione o campo id na visualização Detalhes do JPA.

  2. Clique com o botão direito no ID e, em seguida, selecione Mapear Como > ID.

  3. Na visualização Detalhes JPA, selecione ADDRESS_ID no campo Nome:

    Visualização Detalhes do JPA para o Campo addressId

    A visualização Detalhes do JPA para o atributo do ID de entidade do Endereço.

    O Eclipse inclui as seguintes anotações na entidade Endereço:

    @Id
    @Column(name="ADDRESS_ID")
    
  4. Mapeie cada um dos seguintes campos (como mapeamentos Básicos) para a coluna de banco de dados apropriada:

    Campo Mapear Como Coluna de Banco de Dados
    cidade Básico CITY
    país Básico COUNTRY
    Código de endereçamento postal Básico P_CODE
    Estado ou província Básico PROVINCE
    rua Básico STREET

O Dali mapeia automaticamente alguns campos para corrigir a coluna do banco de dados (como o campo cidade da coluna Cidade) se os nomes forem idênticos.