Persistente Java-Entität mit persistenten Feldern erstellen

Dieser Schnelleinstieg zeigt Ihnen, wie Sie eine neue persistente Java-Entität erstellen. Wir werden eine Entität zur Zuordnung zu einer Datenbanktabelle erstellen. Sie müssen dabei auch die Tabelle 'ADRESSE' zu Ihrer Datenbank hinzufügen.

  1. Wählen Sie das JPA-Projekt im Navigator oder Paket-Explorer aus und klicken Sie anschließend auf Neu> Andere. Der Dialog 'Assistent auswählen' wird geöffnet.

  2. Wählen Sie die Optionen JPA > Entität aus und klicken Sie anschließend auf Weiter. Die Seite Entitätsklasse wird geöffnet.

  3. Geben Sie den Paketnamen (wie z. B. quickstart.demo.model) und den Klassennamen (wie z. B. Address) ein und klicken Sie anschließend auf Weiter. Die Seite Entitätseigenschaften wird geöffnet, auf der Sie die persistenten Felder definierten können, die Sie den Spalten einer Datenbanktabelle zuordnen.

  4. Verwenden Sie das Dialogfenster "Entitätsfelder" (wird durch Klicken auf Hinzufügen aufgerufen), um der Adressklasse persistente Felder hinzuzufügen:

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

    Anmerkung:

    Darüber hinaus müssen Sie der Datenbanktabelle ADDRESS auch die folgenden Spalten hinzufügen:

    NUMBER(10,0) ADDRESS_ID (primary key)
    VARCHAR2(80) PROVINCE
    VARCHAR2(80) COUNTRY
    VARCHAR2(20) P_CODE
    VARCHAR2(80) STREET
    VARCHAR2(80) CITY
    

  5. Klicken Sie auf Fertig stellen. Nach Fertigstellung der Angaben im Assistenten 'JPA-Entität erstellen' zeigt Eclipse die Entität Adresse in der Ansicht 'JPA-Struktur' an.

Address.java enthält die Anmerkung @Entity, die persistenten Felder sowie die Methoden Getter und Setter für jedes der Felder.

Entität 'Adresse' in Address.java

Java-Editor mit der Entität 'Adresse'

Eclipse zeigt auch die Entität Adresse in der Ansicht 'JPA-Struktur' an.

Entität 'Adresse' in der Ansicht 'JPA-Struktur'

Address.java in der Ansicht JPA-Struktur

Nach Erstellung der Entität müssen Sie diese einer Datenbanktabelle zuordnen.

  1. Wählen Sie die Klasse Adressein der Ansicht 'Projektexplorer' aus.

  2. In der Ansicht JPA-Details werden Sie feststellen, dass Dali die Datenbanktabelle ADRESSE automatisch der Entität zugeordnet hat, da beide gleich benannt sind.

    Ansicht 'JPA-Details' für Entität 'Adresse'

    Address.java in der Ansicht 'JPA-Details'.

    Anmerkung:

    Je nach Typ Ihrer Datenbankverbindung müssen Sie eventuell das Schema festlegen.



Tipp:

Nach Zuordnung der Entität zu der Datenbanktabelle müssen Sie die Datei persistence.xml aktualisieren, um diese JPA-Entität einzuschließen.

Klicken Sie im Projektexplorer mit der rechten Maustaste auf die Datei persistence.xml und wählen Sie die Optionen JPA-Tools >Klassenliste synchronisieren aus. Dali fügt der Dateipersistence.xml folgendes hinzu:

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


Nun können Sie alle Felder in der Klasse 'Adresse' einer Spalte in der Datenbanktabelle zuordnen.

  1. Wählen Sie das Feld ID in der Ansicht 'JPA-Details' aus.

  2. Klicken Sie mit der rechten Maustaste auf ID und wählen Sie anschließend Zuordnen als > ID aus.

  3. In der Ansicht 'JPA-Details' wählen Sie im Feld 'Name' ADDRESS_ID aus:

    Ansicht 'JPA-Details' für das Feld 'addressId'

    Die Ansicht 'JPA-Details' für das Attribut 'ID' der Entität 'Adresse'.

    Eclipse fügt die folgenden Anmerkungen der Entität 'Adresse' hinzu:

    @Id
    @Column(name="ADDRESS_ID")
    
  4. Ordnen Sie jedes der folgenden Felder (als Basiszuordnungen) der entsprechenden Datenbankspalte zu:

    Feld Zuordnen als Datenbankspalte

    city

    Basis

    CITY

    country

    Basis

    COUNTRY

    postalCode

    Basis

    P_CODE

    provinceOrState

    Basis

    PROVINCE

    street

    Basis

    STREET


Dali ordnet einige der Felder automatisch der richtigen Datenbankspalte zu (wie beispielsweise das Feld city zur Spalte City), wenn die Namen identisch sind.