xsl

Werbung
XSLT Voraussetzungen, trivial
XSLT-Prozessor: wir verwenden XALAN für die Erarbeitung.
XALAN kann über den NAL lokal am PC installiert werden.
XALAN ist eine JAVA-Anwendung.
XML-Datei, die bearbeitet werden soll (*.xml), wohlgeformt
XSLT-Stylesheet, das die Transformationsanweisungen enthält.
(*.xsl)
Ein Stylesheet mit Formatierungsklassen für unsere wichtigsten
Elemente und Standard-Text (*.css) [optional]
Eine DTD, optional
HTML
XML
XSL
XALAN
XML
CSS
TEXT
DTD
XLST
XSLT: Definition
XSLT = Extensible Stylesheet Language Transformations"
"XSLT ist eine funktionale Programmiersprache. Ihr Zweck
ist die Transformation eines XML-Dokumentes in ein
anderes Textdokument." Dies kann Text, HTML oder
XML sein.
XSLT: Namensraum und Version als Angabe im
Stylesheet
<xsl:stylesheet version="1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
XLST
Grundlegender Aufbau eines Stylesheets
Ein Stylesheet ist selbst ein gültiges XML-Dokument. Es besitzt
folgenden Grundaufbau:
<?xml version = "1.0" ?>
<xsl:stylesheet version = "1.0"
xmlns:xsl="http://www.w3.org/1999/XSL/Transform">
<!-- TEMPLATES, Verarbeitungsanweisungen -->
</xsl:stylesheet>
Die Tags in Stylesheets werden mit Namensraum-Angaben
geschrieben. Dieser wird im Wurzelelement deklariert.
Beispiel:
<xsl:template match = "/">
<xsl:apply-templates />
</xsl:template>
XLST
Aufgabenstellung 1/1: Hallo Welt!
Wir beginnen mit einem einfachen, klassischen Beispiel:
Unsere XML-DATEI:
<?xml version="1.0"?>
<gruss>
Hallo, Welt!
</gruss>
XLST
Aufgabenstellung 1/2: Hallo Welt !
XSLT-Stylesheet:
<xsl:stylesheet
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
version="1.0">
<xsl:output method="html"/>
<xsl:template match="/">
<html>
<body>
<xsl:apply-templates select="gruss" />
</body>
</html>
</xsl:template>
<xsl:template match="gruss">
<h1>
<xsl:value-of select="."/>
</h1>
</xsl:template>
</xsl:stylesheet>
XLST
Starten des Transformationsvorganges
In der DOS-Box:
java org.apache.xalan.xslt.Process -in gruss.xml -xsl
gruss.xsl -out gruss.html
... Ergibt die (aus dem Transformationsprozess
entstandene) Datei gruss.html
Zur Vereinfachung des Aufrufs kann man sich ein DOSSkript (Batch-Datei) bauen (go.bat)
XLST
Über die Ausgabe-Möglichkeiten
HTML
<xsl:output method="html"
doctype-public ="-//W3C//DTD HTML
4.01 Transitional//EN" />
xsl:output method = "text" />
TEXT
Programmcode
VRML-Code
...
<xsl:output method = "xml"
indent = "yes" />
XML
PDF
XLST
SVG
...
Bausteine des Stylesheets
Es gibt 37 XSLT-Elemente, davon 2 Hauptelemente, 12 Elemente
der obersten Ebene sowie 23 Anweisungselemente.
Bestimmte Elemente verwenden als Attribut Xpath-Ausdrücke.
Hauptelement
<xsl:stylesheet
xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
version="1.0">
Element oberste
Ebene
<xsl:output method="html"/>
<xsl:template match="gruss">
<h1>
<xsl:value-of select="."/>
Xpath-Ausdruck
</h1>
</xsl:template>
Text, der in den
Ausgabestrom
geschrieben wird
Anweisungselement
XLST
Analyse des Beispiels (1)
1. Das XSLT-Stylesheet wird geparst und in eine
Baumstruktur überführt.
2. Das Gleiche passiert mit dem XML-Dokument.
3. Der Prozessor startet am Wurzelknoten des XMLDokuments. Dieser ist nicht das oberste Element,
sondern die "Wurzel des Dokuments" (inkl. aller
Verarbeitungsanweisungen etc.). Der Wurzelknoten ist
der Startkontext.
WURZEL
Verarbeitungsanweisungen,
wie <?xml-stylesheet .../>
Kommentare <!-- -->
Startkontext
Wurzelelement
<gruss .../>
Weitere Elemente
XLST
Analyse des Beispiels (2)
4. Prozessor: Muss ich irgendwelche Knoten verarbeiten?
Ja, es gibt weitere Knoten im Dokument. Und:
Es gibt ein "Template" (Vorlage, Schablone).
<xsl:template match = "/"> Kontext = /
5. Was soll ich tun?
<xsl:apply-templates select ="gruss" />
"Wähle die Kind-Knoten "gruss" und wende vorhandene
Templates auf sie an." Kontext = /gruss
WURZEL
Andere Knoten
auf der ersten
Ebene ...
Wurzelelement
<gruss .../>
XLST
Analyse des Beispiels (3)
6. Gibts ein spezielles Template für "gruss"?
Ja, und zwar:
<xsl:template match = "gruss">
7. Was muss ich jetzt tun?
Schreibe in den Ausgabestrom:
==> <h1>
Dann nimm den aktuellen Knoten (und ggf. seine
Kinderknoten) und schreibe deren "Inhalt":
==> <xsl:value-of select="."/>
Schreibe in den Ausgabestrom:
==> </h1>
8. Würde es weitere Knoten gruss geben, würde jetzt der
gruss [2] dran kommen. Dann kehrt der Prozessor zum
aufrufenden Template zurück.
XLST
Spannende, wundersame Tests / gruss2
1. Legen Sie ein neues Stylesheet mit Namen gruss2.xls
an.
2. Kopieren Sie die Daten vom alten Template in das neue
und löschen Sie daraus alle Templates!
3. Legen Sie auch eine neue XML-Datei gruss2.xml und
kopieren Sie dorthin die Inhalte von gruss1.xml.
4. Checken Sie die "Ausgabe" dieses Templates. Was tut
es?
5. Was ist daraus zu schließen?
6. Legen Sie nun ein "leeres" Template für den
Wurzelknoten an.
7. Prüfen Sie die Ausgabe und interpretieren Sie sie.
XLST
Aufgabenstellung 2/1:
Mehr Grüße im Manifest! / gruss2
Ändern Sie Ihren XML-File in gruss2.xml, senden Sie
mehrere Grüße an die Welt.
Binden Sie auch den Aufruf des Stylesheets ein.
Fügen Sie in ein wer-Element einen Kommentar ein.
Verwenden Sie dazu folgende Struktur:
<?xml-stylesheet type="text/xsl" href="gruss1.xsl" ?>
<!–- Einbindung des Stylesheets mit einer Verarbeitungsanweisung und
"Pseudoattributen" -->
<manifest>
<gruss>
<ansprache>
<wer sex="f|m">
<!-- -->
<wem>
<creator>
XLST
Aufgabenstellung 2/2: XSLT-Stylesheet / gruss2
Schreiben Sie jetzt ein Stylesheet (gruss2.xsl) für die
Transformation des neuen Texts.
1. Definieren Sie ein Template für den Wurzelknoten
<xsl:template match="/"> und bauen Sie dort das Skelett
der HTML-Seite. Im <body>-Element setzen Sie dann Schritt
2.
2. Teilen Sie dem Prozessor mit, dass er die Menge aller
gruss-Knoten (und der Kindknoten) bilden und mit der
vorhandenen Vorlage ausgeben soll. "<xsl:applytemplates select="manifest/gruss" />
3. Nun sollten Sie auch noch eine Vorlage für diese grussKnoten-Menge erstellen.
Wenn Sie damit schon fertig sind gehen Sie auf die nächste
Seite.
XLST
Aufgabenstellung 2/2: XSLT-Stylesheet
4. Erstellen Sie am Kopf der Seite ein Verzeichnis der
"Rufenden".
5. Erstellen Sie ein CSS-Stylesheet und bauen sie die Klassen in
die Ausgabe ein. Hier ein Vorschlag, die das geht:
(a) Sie müssen einen HTML-Header in die Ausgabe schreiben und
dort auf das CCS-File verweisen:
<link rel="STYLESHEET" type="text/css"
href="gruss.css" media="all" />
(b) Bei der Ausgabe des Elements geben Sie an:
<div>
<xsl:attribute name="class">liste</xsl:attribute>
[...Text...]
</div>
XLST
XPath: Definition
XPath ist eine Nicht-XML-Sprache, die dazu dient,
bestimmte Teile eines XML-Dokuments zu identifizieren.
XPath sieht das Dokument (*.xml) als einen Baum von
Knoten an. Für jedes Dokument gibt es genau einen
Wurzelknoten.
/manifest/gruss/wer lokalisiert die wer-Knoten
/ den Wurzelknoten selbst
XSLT benötigt XPath-Ausdrücke in bestimmten Attributen,
um Knoten oder andere Teile des Dokuments
auszuwählen, die verarbeitet werden sollen.
<xsl:apply-templates select="/manifest/gruss" />
XLST
XPath: Knoten (1)
XPath kennt 7 Arten von Knoten im XML-Dokument:
• Wurzelknoten: Der Knoten, der das gesamte
Dokument enthält. Adressierung mit /
• Elementknoten: Enthält das adressierte Element und
seine Kinder (Element-, Text-, Kommentar-,
Verarbeitungsanweisungsknoten)
• Attributknoten: Die Elementknoten, zu denen die
Attribute gehören, sind deren Elternknoten. Jedoch sind
Attributknoten sind keine Kinder ihres Elternknoten!
Nach Attributen müssen Sie speziell fragen.
XLST
XPath: Knoten (2)
• Textknoten: enthalten den Text aus einem Element.
Entity- und Zeichenreferenzen sowie CDATA-Abschnitte
werden aufgelöst.
• Kommentarknoten: Text der Kommentare
• Verarbeitungsknoten (PI-Knoten)
• Namensraum-Knoten
Kontextknoten ist die Bezeichnung für den gerade
gewählten, "aktuellen" Knoten. Xpath-Ausdrücke
werden von diesem Punkt aus berechnet. Kontextknoten
beinhalten noch weitere Informationen (Position, Größe
etc.)
XLST
XPath: Lokalisierungspfade
Ein Lokalisierungspfad bezeichnet eine Menge von Knoten in
einem gegebenen Dokument.
<xsl:template match = "/" /> wählt den Wurzelknoten
(und seine Kinder!) aus.
<xsl:template match = "gruss" />
wählt den Elementknoten gruss (und seine Kinder) relativ
zum Kontextknoten aus. gruss muss ein Kindknoten zum
Kontextknoten sein, in dem sich der XSLT-Prozess gerade
befindet.
Wieviele Knoten der XML-Datei werden damit ausgewählt?
<xsl:value-of select = "." /> wählt den gerade
aktivierten Kontextknoten (und seine Kinder).
Bitte beachten Sie, dass XPath-Ausdrücke immer
Knotenmengen zurückgeben! Und dass ein Knoten mehr
ist als nur sein Text, aber noch keine Attributwerte
beinhaltet.
XLST
XPath: Lokalisierungspfade: relativ
Ein relativer XPath-Adruck geht in der Adressierung immer
vom aktuellen Kontextknoten aus. Beispiele:
<xsl:template match = "gruss" /> setzt voraus, dass
gruss ein Kind des Kontextknotens (z.B. manifest) ist.
<xsl:value-of select = "." /> wählt den gerade
aktivierten Kontextknoten (und seine Kinder).
<xsl:template match = "manifest/gruss/wer" />.
Damit diese Adressierung keine leere Knotenmenge
zurückgibt, muss der Kontextknoten das Wurzelelement
sein.
<xsl:value-of select = ".." /> wählt den
Elternknoten des Kontextknoten. Ist der Kontextknoten
wer so wird gruss gewählt.
XLST
XPath: Lokalisierungspfade: absolut
Ein absoluter XPath-Ausdruck beginnt immer an der
Dokumentwurzel, d.h. mit einem /. Der Kontextkonten
wird nicht berücksichtigt.
<xsl:template match = "/" /> wählt das
Wurzelelement.
<xsl:template match = "/manifest/gruss/wer" />
adressiert das Element wer.
XLST
XPath: Lokalisierungsschritte für Attribute
Auch Attribute sind ein Teil von XPath. Allerdings sind sie
keine Kinder eines Elementknotens und werden daher
auch nicht automatisch selektiert. Sie müssen vielmehr
die Attribute explizit ansprechen.
<xsl:value-of select = "@sex" /> wählt das Attribut
"sex" des aktuellen Kontextknotens und gibt dessen
Wert aus.
<xsl: value-of select =
"/manifest/gruss/wer/@sex" /> adressiert das
Attribut absolut.
XLST
XPath: Nur den Text eines Knotens ausgeben
Wie Sie wissen, werden bei der Selektion eines
Elementknotens alle untergeordneten Kinderknoten
(auch jene, die keine Elementknoten, sondern etwa
auch Kommentarknoten etc. sind) mit ausgewählt.
Wollen Sie nur den Textknoten eines Elements
ausgeben, verwenden Sie den "Knotentest" text()
<xsl: value-of select = "/manifest/gruss/text()"
/> gibt nur den Text des gruss-Elements aus.
XLST
XPath: Wildcards, mehrere Treffer
Wildcards sprechen unterschiedliche Element- und Knotentypen
gleichzeitig an.
* wählt alle Elementknoten aus (nicht aber: Attribute,
Textknoten, Kommentare, PIs). Z.B. wählt dc:* alle
Elementknoten des Namensraums dc aus.
@* wählt alle Attributknoten.
node() wählt alle Knoten im aktuellen Kontext.
// wählt unter allen Abkömmlingen des Kontextknotens und dem
Kontextknoten: z.B. wählt //wer alle wer-Elemente.
| undiert XPath-Ausdrücke und liefert die Vereinigungsmenge
beider Ausdrücke.
XLST
XPath: Kommentare und Text auswählen
comment() Dieser Knotentest liefert den Inhalt des
Kommentars im jeweiligen Kontext.
text() Liefert den Textinhalt eines Kontextknotens (nicht
aber die der Kindelemente)
XLST
Aufgabengabenstellung 3 / gruss3
1. Kopieren Sie den Inhalt von gruss1.xml -> gruss3.xml
2. Erstellen Sie ein neues Stylesheet gruss3.xsl
3. Geben Sie eine Liste aller im Dokument vorhandenen
Attribute aus.
4. Geben Sie die Kommentare aus.
5. Geben Sie alle Elemente ohne Templates aus.
6. Geben den Inhalt der Elemente /manifest/gruss/wer
aus.
Immer denken: Ich super und kann's!
XLST
XPath: Prädikate, Funktionen, Zahlen
Manchmal ist es notwendig, die Treffermenge der
gefundenen Knoten weiter zu filtern. Dies kann durch
"Prädikate" geschehen. Prädikate beinhalten eine
Bedingung bzw. einen Ausdruck, der wahr oder falsch
ist (Boolscher Wert). Ist der Ausdruck für einen Knoten
falsch, wird er aus der Liste gelöscht.
Beispiele:
manifest/gruss/wer[@sex='m']
manifest/gruss[wer = "Jaques Brel"]
manifest/gruss[1]
Im Rahmen von Prädikaten werden häufig auch Funktionen
und Zahlenoperationen verwendet.
XLST
XPath: Funktionen
Funktionen arbeiten mit Knotenmengen oder geben
Informationen über Knotenmengen zurück. Funktionen
liefern Daten folgender Typen zurück: Boolscher Wert,
Zahl, Knotenmenge, String.
Beispiele für Funktionen:
last()
count()
position()
name()
string()
starts-with()
contains(), substring()
subsstring-before(), substring-after()
string-length()
not()
XLST
XPath: Mathematische Operatoren
In XPath-Ausdrücken kann auch gerechnet werden:
+ Addition
- Subtraktion gruss[last()-1] => vorletzter Knoten
* Multiplikation
div Division 6,5 div 3 => 2
mod Restbildung 6,5 mod 1,5 => 0,5
starts-with()
contains(), substring()
subsstring-before(), substring-after()
string-length()
not()
XLST
XSLT: Verzweigungselemente
IF-Element
<xsl:if test = "count(//wer) = 5">
[...]
</xsl:if>
CHOOSE-Element
<xsl:choose>
<xsl:when test = [Bedingung]> [...Ausgabe...]
</xsl:when> [...weitere Bedingungen...]
<xsl:otherwise>[...]
</xsl:otherwise>
</xsl:choose>
XLST
Herunterladen