Häufiges Hibernate-Problem: Kein Identifikator für Entity angegeben

Bei der Verwendung von Hibernate kann es vorkommen, dass die Fehlermeldung „AnnotationException: No identifier specified for entity“ auftritt. In unserem aktuellen Blogbeitrag präsentieren wir eine einfache Lösung für dieses häufige Problem.

Beim Ausführen mancher Projekte sto, das einige Entity-Beans enthielt, erhielt ich folgende Fehlermeldung:

Initial SessionFactory creation failed.org.hibernate.AnnotationException: No identifier specified for entity: com.journaldev.hibernate.model.Address
...
Exception in thread "main" java.lang.ExceptionInInitializerError

Ursache des Problems

Dieser Fehler tritt auf, wenn ein Primärschlüssel im Entity-Bean nicht spezifiziert wurde. Ein Beispiel hierfür ist das Bean Address.java, das folgendermaßen definiert war, jedoch ohne die notwendige @Id-Annotation für das Primärschlüsselfeld:

@Entity
@Table(name = "ADDRESS")
@Access(value=AccessType.FIELD)
public class Address {
    // ... Felder ohne @Id Annotation ...
}

Lösung für dieses Hibernate-Problem

Die Lösung besteht darin, die @Id-Annotation zum Primärschlüsselfeld hinzuzufügen:

@Id
@Column(name = "emp_id", unique = true, nullable = false)
@GeneratedValue(generator = "gen")
@GenericGenerator(name = "gen", strategy = "foreign", parameters = {@Parameter(name = "property", value = "employee")})
private long id;

Ein häufiges Missverständnis: Zugriffstypen in Hibernate

Ein weiteres, verwirrendes Szenario entsteht, wenn es um den Zugriffstyp in Hibernate geht. Hibernate kann auf zwei Arten auf Bean-Eigenschaften zugreifen:

1. Feldzugriff (AccessType.FIELD): Hibernate sucht nach Annotationen auf Variablen.
2. Eigenschaftszugriff (AccessType.PROPERTY): Hibernate sucht nach Annotationen auf Getter- und Setter-Methoden.

Falls die Annotationen nicht entsprechend dem definierten Zugriffstyp gesetzt sind, führt dies ebenfalls zu einer AnnotationException. Im Employee.java-Bean trat dieser Fehler auf, weil alle JPA-Annotationen auf Getter-Methoden angewendet wurden, obwohl der Zugriffstyp als Feld definiert war. Die Korrektur bestand darin, den Zugriffstyp auf AccessType.PROPERTY zu ändern.

Fazit

Diese Erfahrung verdeutlicht die Bedeutung, die Details und Spezifikationen von Hibernate genau zu kennen und zu beachten. Ein kleines Übersehen oder Missverständnis kann zu stundenlangem Debugging führen. Hoffentlich hilft dieser Beitrag anderen Entwicklern, ähnliche Probleme schnell zu lösen.