Konzeption und modellgetriebene Entwicklung eines ...

5.7. SERVICES 69
einen Zugriff auf alle beteiligten Datentypen.
Der ExportImportService bietet Methoden für den Export und Import von
Fundorten mit den dazugehörigen Funden und der gesamten Bilddokumentation.
Hinzu kommt eine Methode die prüft, ob die Daten eingelesen werden
können.
Export
Der Methode getExport() muss ein Array mit OrtVO-Objekten übergeben
werden und sie liefert die Orte, ihre Funde und die Bilddokumentation als ein
byte-Array zurück, welches ein ZIP-Archiv darstellt. Die Kodierung ermöglicht
dem Anwender die manuelle Bearbeitung der exportierten Daten zur Lösung
von Konflikten beim Datenaustausch. Deshalb ist die folgende Beschreibung
des ZIP-Archives so auch im Benutzerhandbuch nachgelesen werden:
Bei dem Export werden zuerst alle Attribute der zu exportierenden Fundorte
in eine CSV-Datei, die ”export.csv” benannt wird, geschrieben. Dann
wird die Bilddokumentation jedes Fundortes exportiert, indem jede Bilddatei
in eine Datei exportiert wird, deren Name mit der Fundpunktnummer
des Fundortes anfängt, dann dem Wort dokument als Kennung, der ID und
danach dem Dateinamen, zum Beispiel ”S1-dokument-1-bild1.jpg”. Die Beschreibung
der Bilddokumentation kommt in eine separate Datei die mit
Fundpunktnummer, dem Schlüsselwort dokumente und der ID der Bilddokumentation
benannt ist, zum Beispiel ”S1-dokumente-1-bild1.txt”.
Die Gegenstände zu dem Fundort werden mit ihren Attributen in eine CSV-
Datei exportiert. Zur Erkennung, welchem Fundort diese zugeordnet werden,
beginnt der Name der Datei mit der Fundpunktnummer gefolgt von
dem Schlüsselwort gegenstaende, zum Beispiel ”S1-gegenstaende.txt”. Die
Bilddokumentation wird, wie bei den Fundorten, exportiert, jedoch wird im
Dateinamen zusätzlich die Einzelfundnummer hinter die Fundpunktnummer
geschrieben, zum Beispiel ”S1-E1-dokument-1-bild1.jpg” für eine Bilddatei
und ”S1-E1-dokumente-1-bild1.txt” für die Beschreibung.
Die so entstandenen Dateien werden als ZIP-Archiv verpackt und dem aufrufenden
Controller als byte-Array zurückgegeben. Dieser kann es dem Benutzer
zum Herunterladen anbieten.