Crear una entidad persistente Java con campos persistentes

Este inicio rápido muestra cómo crear una entidad Java persistente. Crearemos una entidad para asociarla a una tabla de base de datos. También necesitará añadir la tabla ADDRESS a su base de datos.

  1. Seleccione el proyecto JPA en el Navegador o en el Explorador de proyectos y pulse Nuevo > Otro. Se visualizará el diálogo Seleccionar un asistente.

  2. Seleccione JPA > Entidad y pulse Siguiente. Se visualizará la Clase de entidad.

  3. Especifique el nombre de paquete (como por ejemplo quickstart.demo.model), el nombre de clase (como por ejemplo Address) y pulse Siguiente. Se visualizará la página Propiedades de entidad, que permite definir los campos de persistencia que correlacionará con las columnas de una tabla de base de datos.

  4. Utilice el diálogo Campos de entidad (que se abre pulsando Añadir) para añadir campos de persistencia a la clase Address:

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

    Nota:

    También deberá añadir las columnas siguientes a la tabla de base de datos ADDRESS:
    NUMBER(10,0) ADDRESS_ID (clave primaria)
    VARCHAR2(80) PROVINCE
    VARCHAR2(80) COUNTRY
    VARCHAR2(20) P_CODE
    VARCHAR2(80) STREET
    VARCHAR2(80) CITY
    

  5. Pulse Finalizar. Cuando haya finalizado la creación de la entidad JPA, Eclipse visualizará la entidad Address en la vista Estructura JPA.

    Address.java incluye la anotación @Entity, los campos de persistencia y los métodos get y set para cada uno de los campos.

Entidad Address en Address.java

Editor Java con la entidad Address.

Eclipse también visualiza la entidad Address en la vista Estructura JPA:

Entidad Address en la vista Estructura JPA

Address.java en la vista Estructura JPA.
  1. Seleccione la clase Address en la vista Explorador de proyectos.

  2. En la vista Detalles de JPA, fíjese en que Dali ha asociado automáticamente la tabla de base de datos ADDRESS con la entidad porque se llaman igual.


    Nota:

    Según el tipo de conexión de base de datos, deberá especificar el Esquema.

    Vista Detalles de JPA para la entidad Address

    Address.java en la vista Detalles de JPA.

Sugerencia:

Después de asociar la entidad con la tabla de base de datos, debe actualizar el archivo persistence.xml para incluir esta entidad JPA.

Pulse con el botón sobre el archivo persistence.xml en el Explorador de proyectos y seleccione Herramientas de JPA > Sincronizar lista de clases. Dali añade lo siguiente al archivo persistence.xml:

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


Ahora estamos preparados para correlacionar cada campo de la clase Address con una columna de la tabla de base de datos.

  1. Seleccione el campo id en la vista Detalles de JPA.

  2. Pulse el id con el botón derecho del ratón y seleccione Correlacionar como > id.

  3. En la vista Detalles de JPA, seleccione ADDRESS_ID en el campo Nombre:

    Vista Detalles de JPA para el campo addressId

    La vista Detalles de JPA del atributo ID de la entidad Address.

    Eclipse añade las anotaciones siguientes a la entidad Address:

    @Id
    @Column(name="ADDRESS_ID")
    
  4. Correlacione cada uno de los campos siguientes (como correlaciones Básicas) con la columna de base de datos adecuada:

    Campo Correlacionar como Columna de base de datos
    city Básica CITY
    country Básica COUNTRY
    postalCode Básica P_CODE
    provinceOrState Básica PROVINCE
    street Básica STREET

Dali correlaciona automáticamente algunos campos con la columna de base de datos correcta (tal como el campo city con la columna City) si los nombres son idénticos.