#1877: CSVWriter.java [DE]

Importe

java.io.PrintWriter / java.io.Writer — Textausgabe
java.text.DateFormat / SimpleDateFormat — Datumsformatierung für CSV-Datumsfelder
java.util.Date — Datumswerttyp
java.util.TimeZone — UTC-Zeitzone für die Datumsformatierung

Konfiguration

Einstellung	Standard	Setter
CSV-Trennzeichen	`';'` (Semikolon — europäische Konvention)	`setCsvSeparator(char)`
Zeilenende	`"\n"` (Unix-Zeilenumbruch)	`setCr(String)`
Datumsformat	`"yyyy-MM-dd HH:mm:ss.SSS"`	`setDateFormat(DateFormat)`
Datums-Zeitzone	UTC	Im Konstruktor fest codiert

Fließende Builder-API

Alle write()-Methoden geben this (die CSVWriter-Instanz) zurück, was Methodenverkettung ermöglicht:

csvWriter.write("Name").write("Alter").write(42L).writeEndOfLine();

Typspezifische Schreib-Überladungen

Methode	Formatierung	Anführungszeichen
`write(String s)`	Roher String mit `"` escaped zu `""` (Verdopplung)	Immer in `"..."` eingeschlossen — folgt den RFC-4180-Zitierregeln
`write(long value)`	Direkte numerische Ausgabe über `PrintWriter.print()`	Keine — Zahlen werden nicht in Anführungszeichen gesetzt
`write(Date value)`	Formatiert über `dateFormat.format()` in UTC	In Anführungszeichen eingeschlossen — Datumsangaben können Leerzeichen oder Sonderzeichen enthalten
`write(Object value)`	Fallback: `String.valueOf(value)`	Keine — generische Objekte werden nicht zitiert (riskant bei Objekten mit Kommas/Anführungszeichen)

Zitieralgorithmus (Zeichenketten schreiben)

Die Methode write(String) implementiert korrektes CSV-Escaping gemäß RFC 4180:

Ausgabe des Trennzeichens, wenn es nicht der erste Eintrag in der Zeile ist (verwaltet von writeSeparator() mit dem firstEntry-Flag)
Ausgabe eines öffnenden doppelten Anführungszeichens (")
Iteration durch jedes Zeichen der Zeichenkette
Wenn das Zeichen ein doppeltes Anführungszeichen (") ist, wird es zweimal ausgegeben ("") — die Standard-CSV-Escape-Sequenz
Alle anderen Zeichen werden unverändert ausgegeben
Ausgabe eines schließenden doppelten Anführungszeichens (")

Zeilen schreiben

writeLine(Object[] values) — Schreibt alle Werte im Array, ruft dann writeEndOfLine() auf
writeEndOfLine() — Gibt das konfigurierte Zeilenende aus (standardmäßig \n) und setzt firstEntry = true zurück

Trennzeichen-Logik (writeSeparator)

Das boolesche Flag firstEntry verfolgt, ob wir am Anfang einer Zeile stehen:

Wenn firstEntry == true: auf false setzen (erste Zelle — kein Trennzeichen erforderlich)
Wenn firstEntry == false: das Trennzeichen vor dem Zellenwert ausgeben

Dies ist ein klassisches Zustandsverfolgungsmuster für getrennte Ausgaben.

Integration mit CSVParser

CSVWriter definiert DEFAULT_CSV_SEPARATOR_CHAR = ';' als öffentliche Konstante, auf die CSVParser verweist, um ein konsistentes Standardtrennzeichen zwischen Leser und Schreiber sicherzustellen.

Vergleich mit modernen CSV-Bibliotheken

Diese Implementierung ist im Vergleich zu Apache Commons CSV oder OpenCSV bewusst minimalistisch:

Keine Header-Zuordnung (wird von CSVParser.parseHeadCols() übernommen)
Keine automatische Typkonvertierung (Aufrufer formatieren Werte vor dem Schreiben)
Keine Streaming-/Großdatei-Optimierungen (schreibt direkt in einen Writer)
Keine Unterstützung für verschiedene Zitierstrategien (alle Zeichenketten werden zitiert; Zahlen nie)

Die Einfachheit spiegelt ihren Ursprung als zweckgebundenes Werkzeug für den ProjectForge-Datenexport wider, nicht als allgemeine CSV-Bibliothek.

Die Methode write(Object) setzt KEINE Anführungszeichen um die Ausgabe — sie ruft String.valueOf(value) auf und schreibt direkt. Wenn die toString()-Methode des Objekts eine Zeichenkette zurückgibt, die Kommas, Semikolons oder Zeilenumbrüche enthält, wird das resultierende CSV fehlerhaft sein. Dies ist akzeptabel, da von den Aufrufern erwartet wird, dass sie die typspezifischen Überladungen verwenden.

Die Datumsausgabe verwendet die UTC-Zeitzone — Daten werden vor der Formatierung auf UTC normalisiert. Dies ist eine bewusste Entscheidung für den Datenaustausch: Sie vermeidet Zeitzonen-Mehrdeutigkeiten in Exporten. Das Format "yyyy-MM-dd HH:mm:ss.SSS" ist ISO-8601-ähnlich, verwendet aber ein Leerzeichen anstelle von 'T'.

#1877: `CSVWriter.java`

Architektur

Importe

Konfiguration

Fließende Builder-API

Typspezifische Schreib-Überladungen

Zitieralgorithmus (Zeichenketten schreiben)

Zeilen schreiben

Trennzeichen-Logik (writeSeparator)

Integration mit CSVParser

Vergleich mit modernen CSV-Bibliotheken

Git-Verlauf