Thema dieser Dokumentation / Das FirstSpirit 5 Modul- / Komponenten-Modell / Von Gadgets, Aspects, Brokern und Agents / Arbeiten mit Referenzen / Auslesen einer Referenz (Read)
Auslesen einer Referenz (Read)
Das Auslesen einer neuen Referenz läuft in folgenden Schritten ab:
- Die read-Methode des Interfaces ValueEngineer ist zuständig für das Laden der EditorValues (XML to Object). Der Methode wird dazu eine Liste von Knoten (Nodes) übergeben. Die für jeden Knoten gespeicherten Werte werden als Instanz des gewünschten Persistenztyps zurückgeliefert und müssen innerhalb der inneren Implementierung geeignet konvertiert werden (siehe Das Interface ValueEngineer<T>).
- Anfordern eines ReferenceTransformationAgent über einen SpecialistsBroker (siehe Das Interface ReferenceTransformationAgent).
- Erzeugen einer neuen Instanz vom Typ ReferenceHolder für die Aufnahme einer internen oder externen Referenz durch den Aufruf der read-Methode auf der Instanz vom Typ ReferenceConstructionAgent. Die read-Methode ist zuständig für das Lesen der Werte aus der Persistenz. Dazu wird die Instanz vom Typ Node übergeben und in eine Instanz vom Typ ReferenceHolder überführt (XML to Object) (Beschreibung und Beispiel siehe Das Interface ReferenceConstructionAgent) (Zum Interface ReferenceHolder siehe Das Interface ReferenceHolder).
- Erzeugen einer neuen Referenz (bzw. einer neuen Instanz vom Typ Reference) durch den Aufruf der Methode toReference(…) auf dem ReferenceHolder (Beschreibung und Beispiel siehe Das Interface ReferenceHolder) (Zum Interface Reference siehe Das Interface Reference).
- Erzeugen einer neuen Instanz des gewünschten Persistenztyps durch den Aufruf der Methode getReferencedObject() auf der Instanz vom Typ Reference (siehe Das Interface Reference). Die Instanz des Persistenztyps wird an die read-Methode des Interfaces ValueEngineer zurückgeliefert (siehe Das Interface ValueEngineer<T>).