Einführung in SaveTransaction
Erstellung
SaveTransaction st = new SaveTransaction(true);
Zum Speichern markieren (nachdem Änderungen durch Setter erfolgt sind):
probe.markForSaving(st);
Zum Löschen markieren:
eigenschaft.markForDeletion(st.getAssociatedDeleteTransaction());
Erzeugen von Datensätzen:
ProbeController.getInstance().createObject(st);
Commit (auf Datenbank speichern):
st.commit();
Wenn mit SaveTransaction gearbeitet wird, so sollte diese auch bei jeder Methode (die innerhalb Erstellung und Commit aufgerufen wird) übergeben werden.
markForSaving
Bei normalen Settern kann keine SaveTransaction übergeben werden. Solch ein Setter speichert nicht von allein; es muss ein markForSaving(st) verwendet werden!
Ausnahmefall: Wenn bei einem Setter eine SaveTransaction mit übergebbar ist, so sollte die SaveTransaction übergeben werden (höchstwahrscheinlich wird sonst direkt gespeichert)!
Beispiel:
- nicht: probe.setPruefplan(pruefplan) // bei Aufruf dieses Setters wird direkt gespeichert
- sondern: probe.setPruefplan(pruefplan, true, st) // true = Probenstatus wird aktualisiert
Bei dem Setter für Lagerposition ist tatsächlich beides möglich:
- entweder: probe.setLagerposition(lagerposition) // innerhalb dieses Aufrufs von setLagerposition() wird nicht gespeichert
- oder: probe.setLagerposition(lagerposition, true, null, st) // true = Bei Umlagerung erscheint eine Nachfrage; null: irrelevant
Bei allen anderen Methoden, die (möglicherweise) an Datensätzen etwas ändern (in der Regel im Controller; teilweise auch am Datensatz direkt) kann meistens eine SaveTransaction übergeben werden. Kann eine SaveTransaction übergeben werden, so sollte diese dann auch verwendet werden.
Beispiel 1 (am Datensatz direkt):
- nicht: probe.addRechnung(rechnung)
- sondern: probe.addRechnung(rechnung, st)
Beispiel 2 (im Controller):
- nicht: ProbeController.getInstance().cloneObject(probe, true); true = Verwende Probennummer nach Nummernkreis (false = verwende Probennummer abhängig von Quell-Probe)
- sondern: ProbeController.getInstance().cloneObject(probe, true, st);
Kann keine SaveTransaction übergeben werden, so ist die Wahrscheinlichkeit groß, dass direkt gespeichert wird. In dem Fall ist es dann sicherer, schon vorher zu commiten (zu speichern)
Beispiel:
**nicht:**
SaveTransaction st = new SaveTransaction(true);
Probe probe = probeVector.get(0);
probe.setBeschreibung("Hallo");
probe.setPruefplan(pruefplan, true, st);
probe.markForSaving();
ProbeController.getInstance().rechneProbenAb(probeVector, toc);
st.commit();
**sondern:**
SaveTransaction st = new SaveTransaction(true);
Probe probe = probeVector.get(0);
probe.setBeschreibung("Hallo");
probe.setPruefplan(pruefplan, true, st);
probe.markForSaving();
st.commit();
ProbeController.getInstance().rechneProbenAb(probeVector, toc);
Wenn eine SaveTransaction schon einmal commitet wurde, sollte sie nicht erneut verwendet werden. Besser wäre es dann, wenn eine neue SaveTransaction verwendet wird.
Beispiel:
**nicht:**
SaveTransaction st = new SaveTransaction(true);
probe.setBeschreibung("Hallo");
probe.setPruefplan(pruefplan, true, st);
probe.markForSaving(st);
st.commit();
ProbeController.getInstance().rechneProbenAb(probeVector, toc);
probe.setPrioritaet(1);
probe.setRezeptur(rezeptur);
probe.markForSaving(st);
st.commit();
**sondern:**
SaveTransaction st = new SaveTransaction(true);
probe.setBeschreibung("Hallo");
probe.setPruefplan(pruefplan, true, st);
probe.markForSaving(st);
st.commit();
ProbeController.getInstance().rechneProbenAb(probeVector, toc);
st = new SaveTransaction(true);
probe.setPrioritaet(1);
probe.setRezeptur(rezeptur);
probe.markForSaving(st);
st.commit();