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.
Seleccione o projecto JPA no Navegador ou no Explorador de Projecto e depois clique em Novo > Outro. Surge o diálogo Seleccionar assistente.
Seleccione JPA > Entidade e depois clique em Seguinte. Surge a página Classe da Entidade.
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.
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 |
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.
O Eclipse apresenta igualmente a entidade Address na vista Estrutura da JPA:
Seleccione a classe Endereço na vista Explorador de Projecto.
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. |
Sugestão: Depois de associar a entidade à tabela da base de dados, deve actualizar o ficheiropersistence.xml de forma a incluir esta entidade de JPA.
Faça clique com o botão direito do rato no ficheiro
|
Está agora tudo pronto para correlacionar cada campo da classe Address a uma coluna da tabela da base de dados.
Seleccione o campo id da vista Detalhes de JPA.
Faça clique com o botão direito do rato em id e, de seguida, seleccione Correlacionar como> id.
Na vista Detalhes de JPA, seleccione ADDRESS_ID no campo Nome:
Eclipse adiciona as seguintes anotações à entidade Address:
@Id @Column(name="ADDRESS_ID")
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.