Ein Persistenz-Abfänger ( Persistence Interceptor ) kann verwendet werden, um auf dem Server weitere Logik auszuführen, wenn ein Objekt gespeichert, geladen, gelöscht, etc. wird. Einen Persistenz-Abfänger kann mit einem normaler
erstellt
verändert
gelöscht
geladen
partiell geladen
wird. Eine Persistence Interceptor kann mit per anonymer Funktion, einem IPersistenceInterceptor oder einem Service aufgebaut definiert werden. Dies sieht folgendermassen aus:
...
Dabei gibt es folgende PersistenceEventTypes:
PersistenceEventType | Verhalten |
|---|---|
| Wird ausgeführt beim Erstellen eines neuen Eintrags, noch bevor er gespeichert wurde. |
| Wird ausgeführt beim Erstellen eines neuen Eintrags, nachdem er gespeichert wurde. |
| Wird ausgeführt beim Ändern eines bereits bestehendes Eintrags, noch bevor er gespeichert wurde. |
| Wird ausgeführt beim Ändern eines bereits bestehendes Eintrags, nachdem er gespeichert wurde. |
| Wird ausgeführt beim Löschen eines Eintrags, noch bevor er gelöscht wurde. |
| Wird ausgeführt beim Löschen eines Eintrags, nachdem er gelöscht wurde. |
| Wird ausgeführt beim Laden der Daten eines Eintrags, noch bevor die Daten geholt wurden. |
| Wird ausgeführt beim Laden der Daten eines Eintrags, nachdem die Daten geholt wurden. |
| Wird ausgeführt beim Laden einer Ladegruppe eines Eintrags, noch bevor die Daten geholt wurden. |
| Wird ausgeführt beim Laden einer Ladegruppe eines Eintrags, nachdem die Daten geholt wurden. |
Diese Event Typen können auch kombiniert werden, zum Beispiel kann man folgendermassen einen Event Typ definieren, der vor jedem Speichern ausgeführt wird:
| Code Block | ||
|---|---|---|
| ||
var beforeSave = PersistenceEventTypes.BeforeCreate | PersistenceEventTypes.BeforeUpdate |
Parameter
Im Persistence Interceptor Aufruf bekommt man je nach Definition die folgenden Parameter
Datenobjekt: Das betroffene Objekt
Context: Der Kontext der laufenden Operation
Service (optional): Eine Service den man zur Verbindung mit Logik verwenden kann
Mithilfe des Kontexts können gewisse Daten in einen State gespeichert werden, den man im dazugehörigem “After“ Event wieder aus dem Kontext lesen kann. Dieser State ist jedoch nur zwischen einem “Before”- und dem dazugehörigem “After“-Event zugänglich. Folgende Beispiele dazu:
| Code Block | ||
|---|---|---|
| ||
// Im State speichern ("Before" Event)
context.SetState(dataObject, MetaProperty, value);
// Aus dem State holen ("After" Event)
context.TryGetState(dataObject, MetaProperty, out value);
// Property Changed State für einzelnes Property speichern ("Before" Event)
context.KeepPropertyChangedStates(dataObject, MetaProperty);
// Oder auch für alle Properties auf dem dataObject:
context.KeepAllPropertyChangedStates(dataObject);
// Prüfen ob Property geändert wurde ("Before" Event)
// Kann auch in eimen "After" Event verwendet werden,
// wenn Property im Before event gespeichert wurde
context.PropertyChanged(dataObject, MetaProperty);
// Prüfen ob irgend ein gegebenes Property geändert wurde
context.AnyPropertyChanged(dataObject, params MetaProperty[]);
// Prüfen ob alle gegebene Properties geändert wurden
context.AllPropertiesChanged(dataObject, params MetaProperty[]);
// User, der die Änderung hervorgerufen hat, auslesen
context.TryGetUserIdAndName(dataObject, out userId, out userName); |