Weitere Basis-Methoden im Modus fix

Wenn Parameter b leer bleibt, bezieht sich die Methode auf den aktuellen Kontext. Mit einem expliziten Kontext kann man auch Eigenschaften eines Splitters in einem anderen Knoten abfragen. Der Wert in b muss dazu der vollständige Name des Knotens sein. Mit dem Platzhalter #parent kann der Kontext des übergeordneten Knoten adressiert werden.

Methode next kann im Modus fix nur auf Felder angewendet werden, weil ein Knoten keine Feldlänge hat. Es werden so viele Zeichen aus dem aktuellen Splitter geliefert und aus dem Splitter entfernt, wie die Feldlänge angibt. Bei Feldlänge 0 wird ein String ohne Zeichen (leerer String) geliefert und nichts aus dem Splitter entfernt. Falls der Splitter keinen Wert mehr enthält, also wenn hasNext den Wert false liefert, wird ebenfalls ein leerer String geliefert.

In Parameter c können für Methode next folgende Flags angegeben werden:

• trim (Trimmt den Wert).

• destroy (Zerstört den Splitter nachdem der letzte Wert geliefert wurde).

Ein Flag gilt als gesetzt, wenn der entsprechende Text in Parameter c steht (ignore-case). Kombination ist möglich.

Weitere Basis-Methoden im Modus csv

Die Verwendung des Parameter b ist wie bei Modus fix, um einen Fremdkontext zu adressieren.

In Methode type kann das Format des Rückgabewertes durch ein optionales Flag in Parameter c gesteuert werden.

• Mit dem Flag u wird nur das Trennzeichen in Umschreibung \uxxxx geliefert.

• Mit dem Flag c wird das Zeichen selbst ohne Umschreibung geliefert.

• Ohne Flag wird der Modus csv, unmittelbar gefolgt von der Umschreibung des Trennzeichens (csv\uxxxx), geliefert.

In Methode next kann im optionalen Parameter c zusätzlich zu trim und destroy noch das Flag trunc (TruncationError) gesetzt werden. In diesem Fall wird ein Fehlerabbruch erfolgen, wenn der mit next gelieferte nächste Feldwert länger als die Feldgröße ist. Das Flag trunc wirkt nur, wenn die Funktion an einem Ziel-Feld hängt. Bei einem Knoten existiert keine Feldlänge zum Vergleich.

In Methode next wird als Rückgabewert ein gültiger String ohne Zeichen (leerer String) geliefert, falls der Splitter keinen Wert mehr enthält.

Methode value liefert die Feldwerte, die sich aktuell im Splitter befinden, als Tokenliste. Wenn in c kein CSV-Trenner steht, wird das Trennzeichen verwendet, mit dem der Splitter initialisiert wurde. Andernfalls wird der Wert aus c als Trenner in der Ausgabe verwendet. Hier können mehrere Zeichen als Trenner gesetzt werden. Eine Unicode-Umschreibung in der Ausgabe der Tokenliste erfolgt nicht. In Parameter c darf ein einzelnes Trennzeichen aber als \uXXXX umschrieben werden.

Wichtiger Hinweis: Falls in Methode value der Trenner aus Parameter c in einem der Feldwerte des Splitters enthalten ist, erfolgt ein Fehlerabbruch.

Basis-Methoden wenn kein Splitter-Objekt im Kontext existiert

Die Verwendung des Parameter b ist wie bei Modus fix oder csv. Parameter c ist beliebig und wird ignoriert wenn kein Splitter-Objekt existiert.

Erweiterte Methoden für Modus fix und csv

Erweiterte Methoden für Modus csv (Mengenoperationen)

Konzeptionell besteht ein Unterschied zwischen dem Modus csv und dem Modus fix. Bei einem csv-Splitter werden die Einzelwerte bereits bei Initialisierung separiert. Der csv-Splitter speichert deshalb Feld-Werte. Im Gegensatz dazu kann die FixRecord-Struktur eines fix-Splitters nicht bei Initialisierung bereits in einzelne Felder geteilt werden. Die Feldgrenzen entstehen erst bei der Entnahme eines Wertes mit der Methode next aufgrund der Feldgröße des Feldes auf das die Methode next angewendet wird.

Das ist die Ursache, warum die Mengenoperationen für einen fix-Splitter nicht zur Verfügung stehen. Diese Methoden beziehen sich auf eine Menge von Werten, die es so nur im csv-Splitter gibt.

Die Methoden order und unique verändern die gespeicherte Wertemenge. Die Methode select liefert nur eine Auswahl der Werte als Rückgabewert in Form einer Tokenliste, ändert aber die Wertemenge im Splitter nicht. Das Trennzeichen der Tokenliste ist das gespeicherte Trennzeichen des csv-Splitters, das bei Initialisierung festgelegt wurde. Wenn man mit dem Select tatsächlich die Wertemenge des Splitters beeinflussen will, muss man den Splitter mit der Tokenliste erneut initialisieren.

Die Sortierung mit order erfolgt lexikalisch aufsteigend. Mit dem Flag d in Parameter c kann lexikalisch absteigend sortiert werden.

Die Löschung von Duplikaten mit Methode unique behält das erste Auftreten eines Wertes bei und entfernt nachfolgende Duplikate. Mit dem Flag s in Parameter c kann man die Einfügereihenfolge beibehalten. In diesem Fall wird das letzte Auftreten eines Wertes beibehalten und die vorherigen Duplikate werden entfernt.

Die Methode + summiert die Werte im Splitter numerisch und liefert die Summe als Ergebnis zurück. Die Werte im Splitter werden nicht verändert. Die Summation basiert auf einer BigDecimal-Addition mit 34 Stellen Genauigkeit und Rundung des Ergebnisses auf HALF_EVEN. Über die optionalen Flags kann das Verhalten bei Fehler gesteuert werden. Default: Leere Werte (höchstens Leerzeichen) werden ignoriert.

• strict = Alle Fehler führen zum Abbruch: Nicht-numerische Werte und leere Werte.

• lazy = Alle Fehler werden übersprungen. Die Summe wird nur über die Werte gebildet, die numerisch sind.

Die Flags müssen in Kleinbuchstaben ausgeschrieben werden, Abkürzungen werden nicht erkannt. Ein Dezimalwert darf nur Ziffern, optional ein Vorzeichen und einen Dezimalpunkt enthalten. Ein Komma als Dezimaltrenner wird nicht erkannt.

Erweiterte Methode für Modus csv (Verbindung zu Liste/Map)

Die Methode read initialisiert das Splitter-Objekt als CSV-Splitter mit den Werten aus der Liste, deren Name als Parameter c übergeben wurde. Der vorherige Inhalt des Splitters geht verloren. Die Reihenfolge der Werte im Splitter ist die gleiche, wie in der Liste. Das Listen-Objekt wird nicht verändert.

Das CSV-Trennzeichen wird automatisch festgelegt. Der Default ist |. Falls in einem der Werte dieses Zeichen enthalten ist, wird \u009c als Trennzeichen verwendet.

Man kann auch die Schlüsselwerte Map als Liste einlesen, wenn in Parameter c der Name einer Map mit vorangestelltem Präfix Map: angegeben wird. Da die Reihenfolge der Schlüssel einer Map nicht definiert ist, ist auch die Reihenfolge im Splitter unbestimmt. Durch nachfolgende Sortierung mit Methode order kann eine definierte Reihenfolge erreicht werden.

Erweiterte Methode für Modus fix (Zeilenumbruch)

Die Methode wrap kann nur auf einen Value-Splitter im Modus fix angewendet werden, andernfalls erfolgt ein Fehlerabbruch. Wenn der im Splitter enthaltene Text länger als die maximale Zeilenlänge (Parameter c) ist, wird der Text auf mehrere Zeilen umgebrochen.

Das Ergebnis der Methode ist ein Splitter im Modus csv, der die umgebrochenen Zeilen enthält.

Der Zeilenumbruch erfolgt, wenn möglich, an den Wortgrenzen. Die Leerzeichen und TABs bleiben in den umgebrochenen Zeilen enthalten. Falls in einer Teilzeile keine Wortgrenze enthalten ist, erfolgt der Umbruch hart bei der maximalen Zeilenlänge c. Zeilen, die kürzer sind, als 1/4 der maximalen Zeilenlänge, entstehen nicht. Wortgrenzen, die weiter links in der Teilzeile stehen, als 1/4 der Zeilenlänge, werden nicht zum Umbruch verwendet.

Das CSV-Trennzeichen wird automatisch festgelegt. Der Default ist \n, also das NewLine-Steuerzeichen. Falls im Ursprungstext bereits ein \n enthalten war, wird \u009c als Trennzeichen verwendet. Der Zugriff auf die einzelnen Zeilen soll später mit der Methode next erfolgen, dann ist das CSV-Trennzeichen belanglos.

Die Methode wrap ist die einzige Methode, die den Typ eines erzeugten Splitters ändert (fix → csv).