Formatierung von Text und Zahlen

(Auszug aus "Java und XSLT" von Eric M. Burke)

XSLT und XPath definieren einen kleinen Satz von Funktionen zur Manipulation von Text und Zahlen. Diese erlauben Ihnen, Strings zu konkatenieren, Substrings zu extrahieren, die Länge eines Strings zu ermitteln und ähnliche Aufgaben zu bewerkstelligen. Während diese Funktionen nicht die von einer Programmiersprache wie Java gebotenen Fähigkeiten erreichen, ermöglichen sie doch einige der gebräuchlichsten Textmanipulationsfunktionen.

Formatieren von Zahlen

Die format-number( )-Funktion wird von XSLT bereitgestellt, um Zahlen wie 123 in formatierte Zahlen wie EUR 123,00 umzuwandeln. Die Funktion sieht wie folgt aus:

string format-number(zahlenwert, string, string?)

Der erste Parameter ist die zu formatierende Zahl, der zweite Parameter ist ein Format-String und der dritte, optionale Parameter, ist der Name eines <xsl:decimal-format>-Elements. Wir werden in diesem Buch nur die ersten beiden Parameter ansprechen. Interessanterweise wird das Verhalten der format-number( )-Funktion von der JDK 1.1.x-Version der Klasse java.text.DecimalFormat definiert. Für vollständige Informationen zur Syntax des zweiten Arguments schauen Sie in die Dokumentation des JDK 1.1.x.

Die Ausgabe von Währungen ist eine gängige Verwendung der format-number( )-Funktion. Das Muster EUR #,##0.00 kann eine Zahl beispielsweise in Euro-Währungsschreibweise formatieren. Die folgende Tabelle zeigt verschiedene mögliche Ein- und Ausgabewerte für dieses Muster.

Tabelle: Formatierung von Währungen mit EUR #,##0.00

Der XSLT-Code zur Verwendung dieser Funktion könnte so oder so ähnlich aussehen:

Es wird angenommen, daß betrag ein Element in den XML-Daten (Anmerkung: die XSLT-Spezifikation definiert nicht, was geschehen soll, wenn die XML-Daten keine gültige Zahl enthalten) ist, wie beispielsweise <betrag>1000</betrag>. Die Zeichen # und 0 sind Platzhalter für Ziffern und verhalten sich exakt so, wie es java.text.DecimalFormat festlegt. Im Prinzip ist 0 ein Platzhalter für jede beliebige Ziffer, während # ein Platzhalter ist, der wegfällt, wenn der Eingabewert 0 ist.

Neben Währungen sind Prozentangaben ein gebräuchliches Format. Um eine Prozentangabe auszugeben, muß das Formatmuster mit einem %-Zeichen enden. Der folgende XSLT-Code zeigt ein paar Beispiele:

Wie zuvor ist der erste Parameter der format-number( )-Funktion die zu formatierende Zahl und der zweite Parameter ist das Muster. Die 0 im Muster gibt an, daß wenigstens eine Ziffer immer angezeigt werden soll. Das %-Zeichen hat den Nebeneffekt, daß der Wert mit 100 multipliziert wird, damit er als Prozentsatz dargestellt wird. Als Konsequenz wird 0.15 als 15% und 1 als 100% dargestellt.

Um mehr Muster zu testen, können die XML-Daten im folgenden Beispiel verwendet werden. Das funktioniert in Verbindung mit zahlenFormatierung.xslt, um jede Kombination von Zahlen und Format in den XML-Daten anzuzeigen.

Beispiel: zahlenFormatierung.xml

Das Stylesheet, zahlenFormatierung.xslt, wird im folgenden Beispiel gezeigt. Kommentare im Code erläutern, was bei jedem Schritt geschieht. Um neue Muster zu testen, bearbeiten Sie einfach die XML-Daten, und führen Sie die Transformation erneut durch. Da die XML-Datei das Stylesheet mit <?xml-stylesheet?> referenziert, können Sie das XML einfach in einen XSLT-fähigen Webbrowser laden und den Aktualisieren-Knopf drücken, um die Änderungen nachzuvollziehen.

Beispiel: zahlenFormatierung.xslt

Dieses Stylesheet geht zunächst in einer Schleife eine Liste der <format>-Elemente durch:

Innerhalb der Schleife werden alle <zahl>-Elemente selektiert. Das bedeutet, jedes Format wird auf jede Zahl angewandt:

Formatierung von Text

In der XPath-Spezifikation sind verschiedene Funktionen zur Textformatierung definiert, die es dem Code in einem XSLT-Stylesheet gestatten, Operationen wie die Konkatenation von zwei oder mehreren Strings, Extraktion eines Substrings und Berechnung der Länge eines Strings durchzuführen. Anders als Strings in Java werden alle Strings in XSLT und XPath beginnend mit Position 1 anstatt Position 0 indiziert.

Lassen Sie uns annehmen, daß ein Stylesheet die folgenden Variablen definiert:

In den ersten drei Variablen werden Hochkommas verwendet, um anzuzeigen, daß es sich bei den Werten um Strings handelt. Ohne die Hochkommas würde der XSLT-Prozessor die Werte als XPath-Ausdrücke behandeln und versuchen, die gleichnamigen Knoten aus den XML-Eingabedaten zu selektieren. Die vierte Variable, vollerName, zeigt, wie die concat( )-Funktion genutzt werden kann, um zwei oder mehrere Strings zu konkatenieren. Diese Funktion erwartet eine kommaseparierte Liste von Strings als Argument und liefert die konkatenierten Ergebnisse zurück. In diesem Fall ist Eric Matthew Burke der Wert von vollerName.

Die folgende Tabelle liefert zusätzliche Beispiele für Stringfunktionen. Die Variablen in dieser Tabelle sind dieselben wie im vorangegangenen Beispiel. In der ersten Spalte ist der Rückgabetyp der Funktion zuerst aufgelistet, gefolgt vom Funktionsnamen und der Parameterliste. Die zweite und dritte Spalte zeigen ein Beispiel zur Verwendung und die Ausgabe des Beispiels.

Tabelle: Beispiele für Stringfunktionen

Alle Stringvergleiche, wie starts-with() und contains( ), unterscheiden zwischen Groß- und Kleinschreibung. Es gibt in XSLT keine Möglichkeit, das abzustellen. Eine Möglichkeit es zu umgehen besteht darin, beide Strings in Groß- oder Kleinbuchstaben umzuwandeln und den Vergleich dann durchzuführen. Auch diese Umwandlung wird in der aktuellen XSLT-Implementierung nicht direkt unterstützt, aber mit der translate( )-Funktion kann diese Aufgabe gelöst werden. Der folgende XSLT-Code wandelt einen String von Klein- in Großbuchstaben um:

In den Funktionen substring-before( ) und substring-after( ) enthält das zweite Argument einen Begrenzungsstring. Wird dieser sogenannte Delimiter, der nicht unbedingt ein einzelnes Zeichen sein muß, nicht gefunden, wird ein leerer String zurückgeliefert. Diese Funktionen können genutzt werden, um formatierte Daten, wie Datumsangaben, zu parsen:

Der XSLT-Code zur Extraktion von Tag, Monat und Jahr sieht wie folgt aus:

In der ersten Codezeile wird die datumsStr-Variable mit dem vollen Datum initialisiert. Die nächste Zeile erzeugt die monatJahr-Variable, die alles ab dem ersten . enthält – an dieser Stelle datumsStr=25.06.2001 und monatJahr=06.2001. In Java ist dies ein wenig einfacher, weil Sie einfach eine Instanz der Klasse StringTokenizer erzeugen und durch die einzelnen Token iterieren oder die lastIndexOf( )-Methode von java.lang.String verwenden, um den zweiten . zu lokalisieren. Mit XSLT sind die Optionen etwas eingeschränkter. Die verbleibenden Zeilen teilen die Variablen in substrings, jeweils wieder begrenzt durch den Punkt (.). Die Ausgabe ist wie folgt:

Eine andere Form der substring( )-Funktion nimmt zwei oder mehr Zahlen als Argumente, die den Anfangsindex und optional die Länge des substring angeben. Wird die zweite Zahl ausgelassen, geht der substring bis zum Ende des Eingabestrings weiter. Der Anfangsindex beginnt immer mit Position 1, daher liefert substring("abcde",2,3) bcd zurück und substring("abcde",2) liefert bcde zurück.