kann mir bitte jemand @MapsId im Ruhezustand erklären?

Kann mir das bitte jemand erklären @MapsId im Winterschlaf? Es fällt mir schwer, es zu verstehen.

Es wäre toll, wenn man es an einem Beispiel erklären könnte und in welchen Anwendungsfällen ist es am besten anwendbar?

Hier ist eine schöne Erklärung von Objekt-DB.

Bezeichnet ein ManyToOne- oder OneToOne-Beziehungsattribut, das die Zuordnung für einen EmbeddedId-Primärschlüssel, ein Attribut innerhalb eines EmbeddedId-Primärschlüssels oder einen einfachen Primärschlüssel der übergeordneten Entität bereitstellt. Das value-Element gibt das Attribut innerhalb eines zusammengesetzten Schlüssels an, dem das Beziehungsattribut entspricht. Wenn der Primärschlüssel der Entität denselben Java-Typ hat wie der Primärschlüssel der Entität, auf die durch die Beziehung verwiesen wird, wird das Wertattribut nicht angegeben.

// parent entity has simple primary key

@Entity
public class Employee {
   @Id long empId;
   String name;
   ...
} 

// dependent entity uses EmbeddedId for composite key

@Embeddable
public class DependentId {
   String name;
   long empid;   // corresponds to primary key type of Employee
}

@Entity
public class Dependent {
   @EmbeddedId DependentId id;
    ...
   @MapsId("empid")  //  maps the empid attribute of embedded id
   @ManyToOne Employee emp;
}

Lies das API-Dokumente Hier.

Ich fand diesen Hinweis auch nützlich: @MapsId im Ruhezustand ordnet die Annotation eine Spalte der Spalte einer anderen Tabelle zu.

Es kann auch verwendet werden, um denselben Primärschlüssel zwischen 2 Tabellen zu teilen.

Beispiel:

@Entity
@Table(name = "TRANSACTION_CANCEL")
public class CancelledTransaction {
    @Id
    private Long id; // the value in this pk will be the same as the
                     // transaction line from transaction table to which 
                     // this cancelled transaction is related

    @OneToOne(fetch = FetchType.LAZY)
    @JoinColumn(name = "ID_TRANSACTION", nullable = false)
    @MapsId
    private Transaction transaction;
    ....
}

@Entity
@Table(name = "TRANSACTION")
@SequenceGenerator(name = "SQ_TRAN_ID", sequenceName = "SQ_TRAN_ID")
public class Transaction  {
    @Id
    @GeneratedValue(generator = "SQ_TRAN_ID", strategy = GenerationType.SEQUENCE)
    @Column(name = "ID_TRANSACTION", nullable = false)
    private Long id;
    ...
}

IMHO, der beste Weg, darüber nachzudenken @MapsId ist, wenn Sie einen zusammengesetzten Schlüssel in einer an:m-Entität zuordnen müssen.

Ein Kunde kann beispielsweise einen oder mehrere Berater haben und ein Berater kann einen oder mehrere Kunden haben:

Und Ihre Entites wären ungefähr so ​​​​(Pseudo-Java-Code):

@Entity
public class Customer {
   @Id
   private Integer id;

   private String name;
}

@Entity
public class Consultant {
   @Id
   private Integer id;

   private String name;

   @OneToMany
   private List<CustomerByConsultant> customerByConsultants = new ArrayList<>();

   public void add(CustomerByConsultant cbc) {
      cbc.setConsultant(this);
      this.customerByConsultant.add(cbc);
   }
}

@Embeddable
public class ConsultantByConsultantPk implements Serializable {
    
    private Integer customerId;

    private Integer consultantId;
}

@Entity
public class ConsultantByConsultant {
   
   @EmbeddedId
   private ConsultantByConsultantPk id = new ConsultantByConsultantPk();
   
   @MapsId("customerId")
   @JoinColumn(insertable = false, updatable = false)
   private Customer customer;

   @MapsId("consultantId")
   @JoinColumn(insertable = false, updatable = false)
   private Consultant consultant;
}

Auf diese Weise zuordnen, fügt JPA automatisch ein Customer und Consultant IDs in der EmbeddableId wann immer Sie einen Berater speichern. Sie müssen die also nicht manuell erstellen ConsultantByConsultantPk.

Wie er Vladimir in seinem . erklärte Lernprogramm, Die beste Methode zum Zuordnen einer @OneToOne-Beziehung ist die Verwendung von @MapsId. Auf diese Weise benötigen Sie nicht einmal eine bidirektionale Zuordnung, da Sie die Child-Entität immer mithilfe der Parent-Entity-ID abrufen können.

Mit MapsId können Sie denselben Primärschlüssel zwischen zwei verschiedenen Entitäten/Tabellen verwenden. Hinweis: Wenn Sie MapsId verwenden, wird die CASCADE.ALL Flag wird nutzlos, und Sie müssen sicherstellen, dass Ihre Entitäten manuell gespeichert werden.