XSLT 2016 S h_da S Seite 1

Transkript

1 XSLT Seite 1

2 Inhalt Einleitung XSLT Arbeitsweise von XSLT Template-Anweisungen XSLT Syntax Beispiele Seite 2

3 XSLT - Allgemeines XSLT = Extensible Stylesheet Language for Transformation Umformung von XML Dokumenten in andere XML Dokumente oder andere Formate Seite 3

4 XSLT - Allgemeines XSLT wurde entwickelt um: - XML Datenbestandteile zu extrahieren - Datenbestandteile anderen Anwendungen zur Verfügung zu stellen - Datenbestandteile in andere Formate zu überführen Seite 4

5 XSLT Vorgänger DSSSL: Document Style Semantics and Specification Language [ ISO/IEC 10179:1996] DSSSL besteht aus zwei Komponenten: der Transformationssprache (transformation language) und der Stilsprache (style language). Erstere soll (SGML-)Dokumente, die nach einer bestimmten DTD (oder mehreren) kodiert sind, in ein Format wandeln, in dem sie anderen DTDs entsprechen. Die zweite (Stil) legt für Teile eines Dokuments fest, wie sie präsentiert sollen. Seite 5

6 XSLT Allgemeines XSLT1.0: XSL Transformation, W3C-Standard seit XPath1.0: XML Path Language, W3C-Standard seit XSLT2.0: XSL Transformation, W3C-Standard vom XPath2.0: XML Path Language, W3C-Standard vom XSLT3.0: XSL Transformation, W3C-Cand. Recom. vom XPath3.0: XML Path Language, W3C-Standard vom Gemeinsames Datenmodell für XPath/XQuery Seite 6

7 XQUERY/XPATH/XSLT Benutzerdef. Funktionen XML Construktoren FLWOR Ausdrücke Bedingte Ausdrücke Arithmetische Ausdrücke Mehr Funktionen Daten Modell Templates Stylesheets XQUERY3.0 XQUERY1.0 XPATH3.0 XPATH2.0 XSLT3.0 XSLT2.0 XPATH1.0 XSLT1.0 Pfad-Ausdrücke Vergleiche Funktionen Seite 7

8 XSLT Beispiel Software Qualitätsanalyse xradar ( Erweiterbares Code Reporting Tool für J ava Systeme, nutzt Tools existierender Qualitätsanalyse-Projekte Generiert Tabellen und Graphiken für den aktuellen Stand des Projekts und für den gesamten Entwicklungszeitraum Generiert neben vielen anderen hilfreichen Metriken eine Visualisierung der Schichtenarchitektur mit den darin enthaltene Modulen Die Erzeugung der XRadar-Analysedaten wird über Ant oder Maven gesteuert und wird über einen Konfigurationsfile gesteuert. Die Architektur des Tools basiert auf Java, XML, XSL Seite 8

9 XSLT Beispiel: xradar Seite 9

10 XSLT Beispiel: xradar Architektur Seite 10

11 XSL / XSLT Ziel: Transformation eines XML Dokuments in ein anderes Dokument, nicht notwendigerweise ein XML-Dokument. Formatierung kann als ein Sonderfall der allgemeinen Transformation gesehen werden: Die Transformation besteht dann aus "formatting objects" und ist ein XML Dokument. Prinzip: Source Dokument wird in Target-Dokument transformiert "Style Sheet" beschreibt die Transformation des Source Dokuments Das Style Sheet ist eine Liste von "templates". Ein "template" besteht aus "Pattern" und "Content Constructor "(template rules) Knoten des Source Dokuments werden mit dem "Pattern" abgeglichen. Bei Übereinstimmung werden Knoten konstruiert ("Content Constructor"). Seite 11

12 XML XSLT XML Transformation zwischen Formaten bzw. Baumstrukturen, basierend auf Datenmodell <...> <...> <...>...</...> <...>...</...> </...> <...> <...>...</...> <...>...</...> </...> <XML/> </...> <...> <...> <...>...</...> <...>...</...> </...> <...> <...>...</...> <...>...</...> </...> <XSLT/> </...> Text, XML XML, HTML, Text <...> <...> <...>...</...> <...>...</...> </...> <...> <...>...</...> <...>...</...> </...> <XML/> </...> XSLT-Prozessor Seite 12

13 Was sind Templates? Die Template Rules sind Bestandteil der Templates. Eine Template Rule dient zur Formulierung eines Transformationsprozesses für eine Menge von Knotentypen eines Quelldokumentes. Seite 13

14 Transformation Eingabebaum Ausgabebaum Wurzelknoten 1 Wurzelknoten Transformation Gedicht html Titel Strophe 5 Strophe head 8 body Vers Vers Vers Vers Vers Titel hr p p hr p p Seite 14 p

15 Syntax <xsl:stylesheet> <xsl:template match= >  <xsl:apply-templates/>  <xsl: value-of select=... > <!-- Attribut: select (. ) </xsl:template> </xsl:stylesheet> Seite 15

16 XSL / XSLT xsltransformation ::= stylesheet stylesheet ::= template* template pattern ::= pattern, content_constructor ::= patternpath Content_constructor ::= literal_result_element instruction instruction benutzen XPath, um auf Knoten im Source Tree zuzugreifen. patternpath ist eine Teilmenge von XPath Ausdrücken Es wird immer nur eine template_rule angewendet. Seite 16

17 Einfaches Template Beispiel 1 <?xml version="1.0"?> <xsl:stylesheet version="1.0" xmlns:xsl=" <xsl:template match="/"> <html> <body> <xsl:apply-templates select= Periodic_Table/Atom /> </body> </html> </xsl:template> <xsl:template match="periodic_table/atom"> <xsl:value-of select="name"/> <xsl:value-of select="@state"/> </xsl:template> </xsl:stylesheet> Seite 17

18 Einfaches Template Beispiel 2 Wurzelknoten Periodic_Table <xsl:template match= Periodic_Table/Atom > <xsl:value-of select="name"/> <xsl:value-of select="@state"/> </xsl:template> Atom Atom State Name... State Name... Wurzelknoten body html Seite 18 p p p p p p

19 Built-In-Templates <?xml version="1.0"?> <xsl:stylesheet version="1.0" xmlns:xsl=" <xsl:template match="/"> <html> <body> <xsl:apply-templates/> </body> </html> </xsl:template> </xsl:stylesheet> Seite 19

20 Built-In Template Rules Erlaubt rekursives Weiterverarbeiten des Eingabedokuments, wenn es keine expliziten Template-Rules gibt: Element-Knoten und Rootknoten: entspricht: <xsl:template match="* /"> <xsl:apply-templates/> </xsl:template> Text- und Attribut-Knoten: entspricht: <xsl:template <xsl:value-of select="."/> </xsl:template> Seite 20

21 Built-In Template Rules Erlaubt rekursives Weiterverarbeiten des Eingabedokuments, wenn es keine expliziten Template-Rules gibt: Processing instructions und Kommentare: keine Regel anwenden Namespace- Knoten: keine Regel anwenden. Die built-in template rules haben die geringste Import-Priorität und können daher überschrieben werden. Seite 21

22 Prioritäten von Templates Was passiert wenn zwei oder mehrere Template-Rules zutreffen, d.h anwendbar sind? Mode-Attribut auswerten Priority-Attribut auswerten Betrachten der Import-Präferenz Falls mehr als eine Template-Rule übrig bleibt, haben patterns mit höherer Spezifizität Vorrang. Ist damit auch keine Priotrität feststellbar, wir das als Fehler betrachtet. Beispiel: match="image/text" vor match="text" vor match= * vor match="processing-instruction()" Seite 22

23 Prioritäten Beispiel 1 <xsl:template match="/"> <html> <body> <xsl:apply-templates/> </body> </html> </xsl:template> <xsl:template match="periodic_table/atom"> <xsl:value-of select="name"/> <xsl:value-of select="@state"/> </xsl:template> <xsl:template match="//atom"> <xsl:value-of select="name"/> </xsl:template> Seite 23

24 Prioritäten Beispiel 2 <xsl:template match="/"> <html> <body> <xsl:apply-templates/> </body> </html> </xsl:template> <xsl:template match="periodic_table/atom priority= 1"> <xsl:value-of select="name"/> <xsl:value-of select="@state"/> </xsl:template> <xsl:template match="//atom" priority= 2"> <xsl:value-of select="name"/> </xsl:template> Seite 24

25 Mode Beispiel <xsl:template match="/"> <html> <body> <xsl:apply-templates mode="eins"/> <xsl:apply-templates mode="zwei"/> </body> </html> </xsl:template>" <xsl:template match="periodic_table/atom" mode= zwei"> <xsl:value-of select=name"/> <xsl:value-of </xsl:template> <xsl:template match="periodic_table/atom" mode= eins"> <h1><xsl:value-of select="name"/></h1> </xsl:template> Seite 25

26 XSL/XSLT Anweisungen xsl:template: <xsl:template match=pattern> content_constructor </xsl:template> content_constructor ist einzufügender Text oder XSL-Anweisungen. pattern ist ein reduzierter XPath-Ausdruck Die Reduzierung betrifft den Axis-Test. Es werden nur die Axes - Child - Attribute unterstützt. Zusätzlich gibt es "//", z.b. Chapter // Para selektiert alle Para-Elemente mit Vorgänger Chapter. Seite 26

27 XSL/XSLT Anweisungen xsl:apply-templates: Wende templates auf die Kindknoten an. Durch geschachtelte Anwendung spezifische Styles für die Elemente. Verfeinerung durch select-attribut (XPath- Expressions). <xsl:apply-templates select="td"/> xsl:value-of: Berechnet den Wert und fügt ihn in die Ausgabe ein. <xsl:value-of select="td"/> TD ist relativ zum aktuellen Knoten, der in der template-anweisung ausgewählt wurde. Seite 27

28 XSL/XSLT Anweisungen xsl:element: Fügt Elemente in die Ausgabe ein, d.h. OpenTag und CloseTag entsprechend dem Attribute "name": <xsl:element name="td"> <NAME><xsl:value-of select="name"/></name> </xsl:element> Ergebnis: <TD> <NAME>Peter</NAME></TD> xsl:attribute: Fügt ein Attribut in die Ausgabe ein. Muss vor dem Inhalt eines Elements kommen. <A> <xsl:attribute name="href"> <xsl:value-of select="symbol"/>.html </xsl:attribute> <xsl:value-of select="name"/> </A> Ergebnis: <A HREF= abc.html >Peter</A> Seite 28

29 XSL/XSLT Anweisungen xsl:attribute-set: Erlaubt die Definition einer Attribut-Menge. Nur als Toplevel-Anweisung. <xsl:attribute-set name="cellstyle"> <xsl:attribute name="font-family"> NewYork TimesNewRoman </xsl:attribute> <xsl:attribute name="font-size">12pt</xsl:attribute> </xsl:attribute-set> <td xsl:use-attribute-sets="cellstyle"> Ergebnis: <td font-family= NewYork TimesNewRoman font-size= 12 > Seite 29

30 XSL/XSLT Anweisungen xsl:processing-instruction: Fügt eine Processing-Instruction in die Ausgabe ein <xsl:processing-instruction name="gcc"> -O4 </xsl:processing-instruction> Ergibt: <?gcc O4?> xsl:comment: Fügt einen Kommentar in die Ausgabe ein. <xsl:comment>das ist der Inhalt.</xsl:comment> Ergibt: <! Das ist der Inhalt. --> xsl:text: Fügt Text in die Ausgabe ein. <xsl:text>diesen Text einfügen.</xsl:text> Seite 30

31 XSL/XSLT Anweisungen xsl:copy: Kopiert einen Knoten in die Ausgabe, d.h. mit den Tags, aber ohne Attribute und Kindelemente. <xsl:copy> <xsl:value-of select="."/> </xsl:copy> xsl:copy-of: Kopiert einen Knoten in die Ausgabe, d.h. mit den Tags, aber mit Attribute und Kindelemente. <xsl:template match="td"> <xsl:copy-of select=".."/> </xsl:template> Seite 31

32 XSL/XSLT Anweisungen xsl:sort: Innerhalb einer for-each- oder apply-templates Anweisung kann Elementen eine Reihenfolge zugewiesen werden. Das Sortierkriterium wird im Attribute "select" festgelegt. Sortierreihenfolge im Attribute order (ascending ist Default) <xsl:apply-templates> <xsl:sort select="."/> </xsl:apply-templates> xsl:variable: Erlaubt die Definition einer Konstanten und ihrer Wiederbenutzung. <xsl:variable name="copy01"> Copyright 2002 FhG IPSI </xsl:variable> <BLOCK COPYRIGHT="{$copy01}"> </BLOCK> Seite 32

33 XSL/XSLT Anweisungen xsl:number: Fügt eine formatierte Ganzzahl in die Ausgabe ein. Der Wert kann aus dem Eingabedokument kommen (Attribut "value" eine Zählfunktion sein (Attribut "count"), oder die Position eines Elements sein. Seite 33

34 XSL/XSLT Anweisungen xsl:if: Erlaubt Ausgabe abhängig von einem Vergleichswert. <xsl:template match="tr"> <xsl:value-of select="td"/> <xsl:if test="position()!=last()">, </xsl:if> </xsl:template> xsl:for-each: Bearbeiten von Knotenmengen. <xsl:for-each select="td"> <xsl:value-of select="."/> </xsl:for-each> Seite 34

35 XSL/XSLT Anweisungen xsl:if: Erlaubt Ausgabe abhängig von einem Vergleichswert. <xsl:template match="tr"> <xsl:value-of select="td"/> <xsl:if test="position()!=last()">, </xsl:if> </xsl:template> xsl:for-each: Bearbeiten von Knotenmengen. <xsl:for-each select="td"> <xsl:value-of select="."/> </xsl:for-each> Seite 35

36 XSL/XSLT Anweisungen xsl:choose: Wählt eine Alternative aus mehreren aus. <xsl:template match="atom"> <xsl:choose> <xsl:when <xsl:value-of select="."/> </xsl:when> <xsl:otherwise> <xsl:value-of select="."/> </xsl:otherwise> </xsl:choose> </xsl:template> Seite 36

37 XSL/XSLT Anweisungen xsl:output: Legt die Art der Ausgabe fest (XML, HTML, Text). Kann nur als Top-Level Anweisung verwendet werden. <xsl:output method="xml" version="1.0" encoding="utf-8"indent="yes"/> weitere Attribute: omit-xml-declaration: Yes unterdrückt die XML-Deklaration <?XML...?> standalone: Yes, fügt "standalone=yes" in die XML-Deklaration ein. doctype-system: Fügt eine DTD-Referenz ein doctype-public: Fügt eine PUBLIC-DTD Referenz ein indent: Fügt Einzug ein, um die Strukturhierarhie sichtbar zu machen. Seite 37

38 XSL/XSLT Anweisungen Benannte Templates Die template Anweisungen kann ein name-attribut haben <xsl:template name="ttd"> <xsl:value-of select="."/> </xsl:template> Über diesen Namen kann das template wieder aufgerufen werden <xsl:call-template name="ttd"/> Seite 38

39 XSL/XSLT Anweisungen Benannte templates können auch Parameter haben: Definition: <xsl:template name="ttd"> <xsl:param name="file">index.html</xsl:param> <a href="{$file}"><xsl:value-of select="."/></a> </xsl:template> Aufruf: <xsl:call-template name="ttd"> <xsl:with-param name="file">atomic_number.html</xsl:with-param> </xsl:call-template> Seite 39

40 XSL/XSLT Setzen von Attribut-Werten Da innerhalb von Attribut-Werten keine Anweisungen erfolgen können (es entstände ein nicht gültiges XML-Dokument), gibt es eine besondere syntaktische Form: <xsl:template match="referenz"> <A HREF="{SYMBOL}.html"> <xsl:value-of select="name"/> </A> </xsl:template> Innerhalb der geschweiften Klammer kann ein Xpath-Expression stehen. Seite 40

41 XSL/XSLT Anweisungen xsl:include: <xsl:include href = uri-reference /> Einbeziehen eines anderen Stylesheets xsl:import: <xsl:import href = uri-reference /> Einbeziehen eines anderen Stylesheets. Wie xsl:include, aber die Regeln des importierenden Stylesheets haben Vorrang vor den importierten. Deklaration muss vor allen anderen Top Level Elementen kommen. Reihenfolge: stylesheet Model A importiert B und C in dieser Reihenfolge; stylesheet Modul B importiert D; stylesheet Modul C importiert E. Ergebnisreihenfolge: D B E C A (von rechts lesen, da die späteren Templates Vorrang vor früheren haben!) Seite 41

42 Processing Instruction Dient der Verknüpfung des XML-Dokumentes mit einem Stylesheet <?xml-stylesheet href= document.xslt type= text/xml?> Die Processing-Instruction in der XML-Instanz bewirkt, dass ein XSLT-Processor das aktuelle Dokument unter Verwendung der referenzierten Stylesheets transformiert. Seite 42

43 Beispiel <?xml version="1.0" encoding="utf-8"?> <?xml-stylesheet type="text/xsl" href="d:\projects\fh_xml\ss14\praktikum.xslt"?> <beispiel2 xmlns="urn:h_da:1.0" xmlns:xsi=" xsi:schemalocation="urn:h_da:1.0 D:\projects\FH_XML\SS14\beispiel2.xsd"> Text <D>Text</D> <E>Text</E> <F>Text</F> Text <D>Text</D> <E>Text</E> <F>Text</F> </beispiel2> Seite 43

44 Quellen Heinz Wittenbrink: XML, Wissen, das sich auszahlt; 2003, TEIA Lehrbuch Verlag GmbH Marco Skulschus, Marcus Wiederstein : XSLT und XPath für HTML, Text und XML. (Taschenbuch); 2005, mitp-verlag, ISBN: Seite 44