FastObjects .NET

Tutorial FastObjects .NET
Dieses kurze Tutorial soll einen ersten Einblick in die Programmierung mit FastObjects .NET geben.
Vorrausetzungen sind:
• Visual Studio 2005
• FastObjects .net > 10.0

Installation
Installation der Komponenten Visual Studio 2005 und FastObjects .NET 1. Nach der Installatio integriert sich FastObjects .NET automatisch als Plugin in das Visual Studio.

Implementierung der Fachlogik
Nach der Installation wird mit der Implementierung der gewünschten Fachklassen begonnen. Wie gewöhnlich kann das neue Projekt über Datei > Neu > Projekt . . . angelegt werden. Zum Zeitpunkt der Entwicklung der Klassen, derer Abhängigkeiten und Funktionen müssen noch keine für die Persistenz notwendigen Schritte beachtet werden.

FastObjects .NET Unterstützung
Nach der Erstellung der gewünschten Klassen wird im nächsten Step das Projekt für Fast-Objects konfiguriert. “Enable Project” im Menüpunkt FastObjects bietet eine komfortablen Dialog zur Einrichtung aller relevanten Informationen. Im Normalfall können die vom System vorgeschlagenen Parameter übernommen werden.

Dateien von FastObjects .NET
Durch die Aktivierung des Projektes werden zwei neue Dateien im Projektmappen Explorer generiert. Zum einen die Implementierung des ObjectScopeProvider Interfaces und zum anderen die Konfigurationsdatei App.config mit den Verbindungseinstellungen des aktuellen Projekts.

Erweiterungen innerhalb der Klassen
Facklassen deren Instanzen mittels FastObjects .NET gespeichert werden sollen, müssen im nächsten Step nun lediglich durch folgende Informationen ergänzt werden:

• Die Klassen müssen die passenden FastObjects .NET Bibliotheken importieren: using FastObjects;
• Die Klasse muss als persistent deklariert werden: [Persistent]

Datenbankverbindung
Um einzelne Instanzen zu speichern müssen diese in der Datenbank abgelegt werden. Grundsätzlich muss zunächst eine Datenbankverbindung mit den gewünschten Verbindungsdaten aufgebaut werden. Wobei der String connectionId aus der Konfigurationsdatei App.config entnommen werden kann. Aufbau der Verbindung: IObjectScope scope=Database.Get(connectionId).GetObjectScope(); Nach dem erfolgreichen Aufbau der Verbindung wird eine Transaktion mittels scope.Transaction.Begin()gestartet.

Operationen
Mit Methoden des Datenbankverbindungsobjekts (hier: scope) können Objekte peristent gespeichert werden. Mittel scope.Add(s); werden Objekte gespeichert wohin gegen scope.Remove(s); gespeicherte Objekte löscht. Endgültig ausgeführt werden die Operationen mit Aufruf der scope.Transaction.Commit(); Methode.

Objekte abrufen
Zum aktuellen Zeitpunkt können Objekte in der Datenbank gespeichert und wieder gelöscht werden. Im nächsten Schritt wird erläutert wie Objekte aus der Datenbank abgerufen werden können. Prinzipiell stehen drei verschiedene Wege zur Verfügung.

• Mit Hilfe der Objekt Id
• Tutorial FastObjects .NET
• Mit Hilfe der OQL
• Mit Hilfe eines Extents

Am häufigsten wird die Methode mit Hilfe des Extents genutzt die im Folgenden näher erläutert wird. Ein Extent stellt eine Sammlung von Objekten des gleichen Typs dar. Nach Aufbau einer Verbindung und Transaktion können mit Hilfe von GetExtent y die Objekte einer Klasse selektiert werden.

Kompilieren und Testen
Die entwickelte Andwendung ist nun funktionsbereit und kann wie gewohnt kompiliert und getestet werden. Alle notwendigen Prozeduren wie bspw. der Aufruf des Enhancers erfolgen automatisch.