b2aat6n

Build verfügbar, daher bietet sich in anderen
Fällen die Arbeit mit den Quellen an.
Nach dem Download stand mir RavenDB
nun zur Verfügung. Ich habe es komplett in
das lib-Verzeichnis innerhalb der Projektstruktur
abgelegt. Damit unterliegt es der
Versionierung, und das Projekt ist in sich
abgeschlossen.
Client und Server
RavenDB kann auf verschiedenen Wegen
verwendet werden: eingebettet in die Anwendung
oder getrennt in Client und Server.
Ich entschied mich dafür, RavenDB als
Server zu starten. Im Implementierungsprojekt
muss dann nur die Assembly Raven.Client.Lightweight.dll
aus dem Client-
Verzeichnis referenziert werden. Der Server
befindet sich im Verzeichnis Server. Klingt
logisch, oder? Dennoch sind solche klaren
Strukturen nicht selbstverständlich. Oft befinden
sich alle binären Artefakte eines
Frameworks gemeinsam in einem bin-Verzeichnis,
aus dem man sich selbst heraussuchen
muss, was man benötigt. Da gefällt
mir diese Aufteilung bei RavenDB doch
sehr gut. Sie vereinfacht die ersten Schritte.
Doch zurück zum Server. Der kann innerhalb
eines IIS gehostet werden oder
auch als Windows-Dienst laufen. Ich habe
nur den Windows-Dienst ausprobiert. Dazu
muss man zwei Befehle ausführen:
❚ RavenDb.exe /install
❚ RavenDb.exe /start
Der erste Befehl installiert RavenDB als
Windows-Dienst, der zweite startet den
Dienst. Weil das Installieren und Starten von
Diensten unterWindows nicht jedem Nutzer
erlaubt sind, kümmert sich RavenDB bei
Bedarf um die Elevation, also das Beschaffen
der nötigen Rechte. Das ist vorbildlich!
Statt eine kryptische Fehlermeldung auszugeben,
eventuell mit dem Hinweis, man
möge das Programm als Administrator starten,
wird’s mir hier sehr einfach gemacht.
CRUDe Methoden
Nun möchte ich als Erstes ein Objekt in der
RavenDB-Datenbank abspeichern. Dazu
habe ich die Klasse Produkt angelegt. Die
Klasse berücksichtigt keine Infrastruktur,
Instanzen sind sogenannte POCOs: Plain
Old CLR Objects. Damit wird im Allgemeinen
die sogenannte Infrastrukturignoranz
bezeichnet. RavenDB stellt (fast) keine Anforderungen
an eine zu persistierende
Klasse. Es muss nicht von einer Basisklasse
abgeleitet werden, es muss kein spezielles
Interface implementiert werden, und es
sind keine Attribute erforderlich. Nur eine
Konvention ist einzuhalten: RavenDB benötigt
eine Eigenschaft namens Id vom Typ
string. In dieser Eigenschaft wird der eindeutige
Schlüssel des Objekts von RavenDB
erwartet. Natürlich kann diese Konvention
geändert werden, wenn sie nicht passt.
public class Produkt {
public string Id { get; set; }
public string Name { get; set; }
public string Kategorie { get; set;
}
Um eine Instanz der Klasse mit RavenDB
zu persistieren, benötigt man einen sogenannten
DocumentStore. Dieser sollte pro
Anwendung nur einmal erzeugt werden.
Mithilfe des DocumentStore wird eine Do-
Listing 2
RavenDB sichert die Objektidentität.
LÖSUNG
cumentSession erzeugt. Innerhalb einer
Session werden Änderungen vorgenommen
und am Ende persistiert. Listing 1
zeigt das Speichern eines Objektes.
Der DocumentStore enthält keinen Zustand,
dafür ist die DocumentSession zuständig.
Während der Lebenszeit der Session
sorgt diese für die Objektidentität:
Wird ein und dasselbe Dokument mehrfach
aus der Datenbank geladen, liefert die
Session jeweils ein und dasselbe Objekt. So
ist sichergestellt, dass innerhalb einer
Session nur genau eine Instanz eines Dokumentes
der Datenbank existiert. Ohne
diese Objektidentität wäre die Gefahr sehr
groß, dass an unterschiedlichen Objekten
Änderungen vorgenommen werden, die
[Test]
public void Session_stellt_Objektidentität_sicher() {
var store = new DocumentStore {Url = "http://localhost:8080"};
store.Initialize();
var produkt = new Produkt();
using (var session = store.OpenSession()) {
session.Store(produkt);
session.SaveChanges();
var produkt2 = session.Load(produkt.Id);
Assert.That(produkt2, Is.SameAs(produkt));
var produkt3 = session.Load(produkt.Id);
Assert.That(produkt3, Is.SameAs(produkt));
}
using (var session = store.OpenSession()) {
var produkt2 = session.Load(produkt.Id);
Assert.That(produkt2, Is.Not.SameAs(produkt));
}
}
Listing 3
Jedes Objekt erhält eine eigene Id.
[Test]
public void Id_wird_durch_Save_erzeugt_aber_Entity_noch_nicht_gespeichert() {
var store = new DocumentStore {Url = "http://localhost:8080"};
store.Initialize();
var produkt = new Produkt();
Assert.That(produkt.Id, Is.Null);
using (var session = store.OpenSession()) {
session.Store(produkt);
}
Assert.That(produkt.Id, Is.Not.Null);
Produkt result;
using (var session = store.OpenSession()) {
result = session.Load(produkt.Id);
}
Assert.That(result, Is.Null);
}
www.dotnetpro.de dotnetpro.dojos.2011 33