<< Syntax von XSL (2) >>

Transkript

1 XSL << Syntax von XSL (2) >> 1

2 XSL <xsl:if> Einfache Conditions, <xsl:if> Anweisung Mittels <xsl:if> kann eine einfache Bedingung mittels XPath Syntax ausgewertet werden. <xsl:if> können nur innerhalb von <xsl:template> Blöcken verwendet werden Falls die Anweisung true ergibt wird die Anweisung im if-block ausgeführt, sonst nicht. Ein else existiert hier nicht <xsl:choose> 2 z.b. CD Preis auswerten <xsl:template name="cd"> <xsl:if test="price < 10"> this cd has a special price! </xsl:if> </xsl:template>

3 XSL <xsl:choose> Mehrfache Conditions, <xsl:choose> Anweisung Mittels <xsl:choose> kann eine mehrfach Bedingung ausgewertet werden (switch- Anweisung) <xsl:choose> besteht aus weiteren Subelementen <xsl:when> und <xsl:otherwise>. Die Bedingungen werden jeweils mit einem <xsl:when> definiert (case-anweisung). <xsl:otherwise> wird abgearbeitet falls keine <xsl:when> zutrifft (default-anweisung). Die <xsl:when> Bedingungen werden von oben nach unten abgearbeitet. sobald eine zutrifft, werden die anderen nicht weiter beachtet. 3

4 XSL <xsl:choose> Mehrfache Conditions, <xsl:choose> Anweisung z.b. CD Preis auswerten <xsl:template name="cd"> <xsl:choose> <xsl:when test="price < 10"> this cd has a special price! </xsl:when> <xsl:when test="price >= 100"> this cd is too expensive! </xsl:when> <xsl:otherwise> this cd has a normal price! </xsl:otherwise> </xsl:choose> </xsl:template> 4

5 XSL <xsl:variable> Konstanten definieren: <xsl:variable> Mittels <xsl:variable> kann eine Konstante definiert werden. Diese Konstante kann dann später wieder in einem XPath Ausdruck mit $name wieder ausgelesen werden. <xsl:variable> können global nach dem root oder innerhalb eines Blockes wie <xsl:template>, <xsl:for-each > festgelegt werden. Der Gültigkeitsbereich muss hierbei beachtet werden! <xsl:variable> kann nach der Definition nicht mehr verändert werden (Wert konstant). Mann kann jedoch diese Konstanten in einem anderen Kontext (Block) neu definieren und somit überschreiben 5

6 XSL <xsl:variable> Konstanten definieren: <xsl:variable> z.b. Konstanten definieren und auslesen <xsl:stylesheet...> <xsl:variable name="var1">global</xsl:variable> <xsl:template name="/catalog"> <xsl:value-of select="$var1"/> <xsl:apply-templates select="cd"/> </xsl:template> <xsl:template name="cd"> <xsl:variable name="var1">überschrieben</xsl:variable> <xsl:variable name="price" select="price"/> <xsl:value-of select="$price"/> </xsl:template> 6 </xsl:stylesheet>

7 XSL <xsl:variable> Konstanten definieren: <xsl:variable> <xsl:variable> können nicht nur für einfache Werte benützt werden. Sie können Nodesets so wie auch eigene XML Strukturen aufnehmen. z.b. Nodeset einer Variable zuweisen und darüber iterieren <xsl:template name="/catalog"> <xsl:variable name="cdset" select="cd"/> <xsl:for-each select="$cdset/price"> <xsl:value-of select="."/> </xsl:for-each> </xsl:template> 7

8 XSL <xsl:variable> Konstanten definieren: <xsl:variable> z.b. Eigene XML Struktur einer Variable zuweisen und darüber iterieren 8 <xsl:stylesheet... > <xsl:variable name="myxml"> <root> <element id="56">my text...</element> <root> <xsl:/variable> <xsl:template name="/catalog"> <xsl:for-each select="xalan:nodeset($myxml)/root/element"> <xsl:value-of select="@id"/> </xsl:for-each> </xsl:template> </xsl:stylesheet>

9 XSL <xsl:param> Parameter definieren: <xsl:param> Mittels <xsl:param> können Parameterübergaben realisiert werden. Parameter werden wie Variabeln verwendet und können einen Defaultwert besitzen. Es gibt globale Parameter sowie Parameter für <xsl:template> Blöcke. Globale Parameter werden beim XSLT Prozessor für die jeweilige Transformation übergeben. 9 <xsl:param> kann nach dem setzen nicht mehr verändert werden (Wert konstant). Mann kann jedoch diese Parameter in einem anderen Kontext (Block) neu definieren und somit überschreiben Parameterübergabe bei Rekursion

10 Parameter definieren: <xsl:param> z.b. Globale Parameter definieren und auslesen <xsl:stylesheet...> <xsl:param name="par1">global</xsl:param> <xsl:template name="/catalog/cd"> <xsl:value-of select="$par1"/> </xsl:template> </xsl:stylesheet> XSL <xsl:param> Parameterübergabe beim XSLT Prozessor (TRAX API) 10 // Transformer erzeugen Transformer trans = tfactory.newtransformer(dsxsl); // Parameter setzen trans.setparameter("par1", new Integer(55)); // transfomration durchführen trans.transform(dsxml,dsresult);

11 XSL <xsl:with-param> Parameter übergeben: <xsl:with-param> Mittels <xsl:with-param> können bei einem Templateaufruf <xsl:call-template> oder <xsl:apply-templates> die zuvor definierten Parameter übergeben werden Bei der Übergabe wird der Standardwert des jeweiligen Parameters überschrieben 11 Realisiert man beim Templateaufruf eine Rekursion, so kann man dank der Überschreibung ständig neue Werte den Parametern zuweisen. Realisierung eines Zählers

12 XSL <xsl:param>,<xsl:with-param> Parameter definieren: <xsl:param>, <xsl:with-param> z.b. Parameter bei template definieren und übergeben <xsl:stylesheet...> <xsl:template match="/catalog"> <xsl:apply-templates select="cd"> <xsl:with-param name="par1">aaa</xsl:with-param> </xsl:apply-templates> </xsl:template> <xsl:template match="cd"> <xsl:param name="par1">default</xsl:param> <xsl:param name="par2">default</xsl:param> <xsl:value-of select="$par1"/> <xsl:value-of select="$par2"/> 12 </xsl:template> </xsl:stylesheet>

13 XSL <xsl:param>,<xsl:with-param> Parameter definieren: <xsl:param>, <xsl:with-param> z.b. Zähler realisieren mittels Rekursion (1/2) <xsl:template name="count"> <xsl:param name="count">0</xsl:param> <xsl:param name="max">0</xsl:param> <xsl:value-of select="$count"/> <xsl:if test=$count < max> <xsl:call-template name="count"> <xsl:with-param name="count" select="$count+1"/> <xsl:with-param name="max" select="$max"/> </xsl:call-template> </xsl:if> </xsl:template> </xsl:stylesheet> 13

14 XSL <xsl:param>,<xsl:with-param> Parameter definieren: <xsl:param>, <xsl:with-param> z.b. Zähler realisieren mittels Rekursion (2/2) <xsl:template match="/"> <xsl:call-template name="count"> <xsl:with-param name="max">21</xsl:with-param> </xsl:call-template> </xsl:template> Ausgabe

15 XSL <xsl:element> XML Element Erzeugung <xsl:element> Mit <xsl:element> werden XML Elemente auf der Ausgabe erzeugt. Es können so dynamische XML Element erzeugt werden. Syntax <xsl:element name="name" namespace="uri" use-attribute-sets="namelist"> </xsl:element> 15

16 XSL <xsl:element> XML Element Erzeugung <xsl:element> z.b. einfache XML Struktur Erzeugung <xsl:element name="cd"> <xsl:element name="title">empire Burlesque</xsl:element> <xsl:element name="artist">bob Dylan</xsl:element> <xsl:element name="price">9.90</xsl:element> </xsl:element> Ausgabe 16 <cd> <title>empire Burlesque</title> <artist>bob Dylan</artist> <price>9.90<price> </cd>

17 XSL <xsl:attribute> XML Attribut Erzeugung <xsl:attribute> Mit <xsl:attritbute> werden XML Attribute für das jeweilige XML Element erzeugt. Es können so dynamisch Attribute erzeugt werden. Syntax <xsl:attribute name="attributename" namespace="uri"> Wert... </xsl:attribute> 17

18 XSL <xsl:attribute> XML Attribut Erzeugung <xsl:attribute> z.b. <xsl:template name="createcd"> <xsl:element name="cd"> <xsl:attribute name="id">56</xsl:attribute> <price> <xsl:attribute name="unit">sfr</xsl:attribute> 9.90 </price> </xsl:element> </xsl:template> Ausgabe 18 <cd id="56"> <price unit="sfr">9.90<price> </cd>

19 XSL <xsl:comment> XML Kommentar Erzeugung <xsl:comment> Mit <xsl:comment> können dynamisch XML Kommentare auf der Ausgabe erzeugt werden. z.b. <xsl:template name="comment">  <xsl:comment> Text... </xsl:comment> <xsl:template> Ausgabe  19

20 XML Elemente kopieren <xsl:copy> XSL <xsl:copy> Mit <xsl:copy> können vom Eingabe Dokument XML Elemente kopiert werden 20 z.b.: Ausgabe: Allfällige Namespaces werden mitkopiert, jedoch Attribute sowie Subelemente nicht! siehe auch <xsl:copy-of> <xsl:template match="cd"> <xsl:copy> Beschreibung... </xsl:copy> <xsl:template> <cd> Beschreibung... </cd>

21 XSL <xsl:copy-of> XML Nodes kopieren <xsl:copy-of> Mit <xsl:copy-of> können vom Eingabe Dokument XML Nodes kopiert werden Bei <xsl:copy-of> werden Namespaces, Attribute sowie Subelemente ebenfalls mitkopiert. Es kann aber mittels XPath angegeben werden was kopiert werden soll 21 Syntax <xsl:copy-of select="xpath-expression"/> Spezielle XPath s * alle Subelemente node() alle alle Attribute des Elements text() TextInhalt des Elements

22 XSL <xsl:copy-of> XML Nodes kopieren <xsl:copy-of> z.b. ganzes CD Element kopieren <xsl:template match="cd"> <xsl:copy-of select="."/> </xsl:template> Ausgabe 22 <cd country="usa"> <title>empire Burlesque</title> <artist>bob Dylan</artist> <price>10.90</price> </cd>

23 XSL <xsl:copy-of> XML Nodes kopieren <xsl:copy-of> z.b. nur Kinder des CD Elements kopieren, sich selber nicht <xsl:template match="cd"> <xsl:copy-of select="*"/> </xsl:template> Ausgabe <title>empire Burlesque</title> <artist>bob Dylan</artist> <price>10.90</price> 23

24 XSL <xsl:decimal-format> Zahlen formatiert ausgeben XSL unterstützt die Formatierung von Dezimalwerten, so kann die Präsentation von Werten den jeweiligen lokalen Standards angepasst werden Mit <xsl:decimal-format> werden die Zeichen zur Darstellung definiert z.b. Grouping-Seperator. <xsl:decimal-format> ist ein Top Level Element z.b.: <xsl:decimal-format name="euro" decimal-separator="," grouping-separator="."/> Nach der Definition kann eine Zahl mittels der Funktion format-number() in die entsprechende Präsentation gebracht werden 24

25 XSL <xsl:decimal-format> Zahlen formatiert ausgeben Syntax <xsl:decimal-format name="name" decimal-separator="char" grouping-separator="char" infinity="string" minus-sign="char" NaN="string" percent="char" per-mille="char" zero-digit="char" digit="char" pattern-separator="char"/> 25

26 XSL <xsl:decimal-format> Zahlen formatiert ausgeben z.b. Geldbetrag SFr.- formatiert ausgeben <xsl:stylesheet...> <xsl:decimal-format name="chf" decimal-separator="." grouping-separator="'"/> <xsl:template match="/"> <xsl:value-of select="format-number( , '#.###,00', 'CHF')"/> </xsl:template> </xsl:stylesheet> Ausgabe 26'

27 XSL <xsl:message> Meldungen ausgeben <xsl:message> Mit <xsl:message> kann auf dem Standardoutput des XSLT Prozessors eine Meldung ausgegeben werden. Dies ist besonders nützlich um Fehler zu finden bzw. zu debuggen. Mittels dem Attribute terminate kann angegeben werden ob der XSLT Prozess gerade dazu gestoppt werden soll oder nicht Exception Auslösung 27 z.b.: <xsl:message terminate="yes"> An Error has occurred during XXX... </xsl:message>

28 XSL << XSL Funktionen >> 28

29 Eingebettete XSL Funktionen (1/2) XSL Functions XSL besitzt selber nur wehr wenige eigne Funktionen, jedoch können alle XPath Funktionen verwendet werden z.b. für String Handhabung 29 Name current() document() element-available() format-number() function-available() Beschreibung gibt den aktuellen Node zurück Um ein externes XML Dokument einzubinden Prüfung ob ein bestimmtes <xsl:xxx > vom Prozessor unterstützt wird Zahlen formatiert ausgeben Prüfung ob Prozessor eine Funktion unterstützt

30 Eingebettete XSL Funktionen (2/2) XSL Functions Name generate-id() key() system-property() unparsed-entity-uri() Beschreibung Erzeugt von einem Node eine Unique Id Gibt ein NodeSet aus dem HashSpeicher zurück welches zuvor mit <xsl:key> erzeugt wurde Gibt den Wert einer Umgebungsvariable zurück Gibt die URI einer nicht geparsten Entitiy zurück 30

31 XSL << weiterführende XSL Techniken >> 31

32 Überladen von Templates XSL <xsl:templates> Überladen bedeutet dass man zwei oder mehr unterschiedliche Ausprägungen eines Templates hat. (In Java: gleicher Methodename aber unterschiedliche Übergabeparametertypen) Templates können mit zwei Strategien überladen werden: Man verwendet im match Attribut jeweils ein unterschiedliches Predicate oder Parameter oder man definiert einen sogenannten mode für das jeweilige Template 32

33 Überladen von Templates Anwendungsbeispiel 1: XSL <xsl:template> Unsere CD s werden in einem Web Portal den Kunden angeboten. Die Angebote werden dabei auf verschiedene Weisen dargestellt um die Aufmerksamkeit der Kunden zu erzielen. Darstellung eines CD Angebots (4 Ausprägungen): Im Shop als Artikel Im Warenkorb Als Spezialangebot auf der Hauptseite Als Werbung auf anderen Seiten 33 Problem: Information welche Darstellungsarten es gibt ist nicht selber im CD Katolg XML enthalten

34 Überladen von Templates Anwendungsbeispiel 1: XSL <xsl:template> 34

35 Überladen von Templates XSL <xsl:template> Lösung ohne Überladung z.b. mit Parameterübergabe <xsl:template match="cd"> <xsl:param name="type">shop</xsl:param> <xsl:choose> <xsl:when test="$type='shop'"> <xsl:call-template name="display_shop"/> </xsl:when> <xsl:when test="$type='basket'"> <xsl:call-template name="display_basket"/> </xsl:when>... </xsl:choose> </xsl:template> 35 unübersichtliche if else Strukturen

36 XSL <xsl:templates> Überschreiben v. Templates mit <xsl:template mode> <xsl:template> besitzt ein optionales Attribut mode. Es kann wie eine Erweiterung des Namens für das jeweiligen Template betrachtet werden z.b. Matching Templates haben keinen Namen Beim Aufruf des Templates muss dann ebenfalls der entsprechende mode angegeben werden. 36 z.b. Aufruf: <xsl:template match="cd" mode="amode">... </xsl:template> <xsl:apply-templates select="cd" mode="amode"/>

37 Überladen von Templates Lösung mittels Überladung mode XSL <xsl:template> <xsl:template match="cd" mode="shop">... </xsl:template> <xsl:template match="cd" mode="basket">... </xsl:template> <xsl:template match="cd" mode="external">... </xsl:template> unterschiedliche Template Implementationen welche aber alle auf das gleiche Nodeset anwendbar sind

38 Überladen von Templates Anwendungsbeispiel 2: XSL <xsl:template> Unsere CD s müssen anhand Ihres Herkunftlandes entsprechend dargestellt werden. Information Herkunftland ist in der XML Struktur selber schon vorhanden 38

39 Überladen von Templates XSL <xsl:template> Lösung mittels Überladung Predicate <xsl:template match="cd[country='usa']">... </xsl:template> <xsl:template match="cd[country='eu']">... </xsl:template> <xsl:template match="cd[country='uk']">... </xsl:template> Aufruf 39 <xsl:template match="/catalog"> <xsl:apply-templates select="cd"/> </xsl:template>

40 XSL <xsl:include>, <xsl:import> Modularisierung von Stylesheets Stylesheets können schnell sehr gross werden und daher aufwendig handzuhaben. Unübersichtlichkeit, Wiederverwendung? XSL unterstützt das Aufteilen und Einbetten von anderen Stylesheets auf zwei Arten: Includes von Stylesheets Import von Stylesheets 40 Beide wirken wie das einsetzen von Text, jedoch ist die Handhabung hinsichtlich der Überladung von Templates und Ihrer Prioritäts- Auswertung anders.

41 XSL <xsl:include>, <xsl:import> Modularisierung von Stylesheets Konflikt von gleichnamigen Templates Konflikt: gleichartige Templates existieren in verschiedenen XSL Dateien 41 <xsl> <xsl> import importdoc1 import importdoc2 template A docmain.xsl include import <xsl> <xsl> template A include import doc1.xsl <xsl> <xsl> template A doc2.xsl

42 XSL <xsl:templates> Prioritäten von Templates, <xsl:template priority> Um die Konflikte von gleichnamigen Templates zu lösen werden bei den Templates die Vergabe von Prioritäten unterstützt z.b. Die Priorität kann mittels dem Attribut priority definiert werden. Es sind pos. sowie neg. Zahlen erlaubt. Default ist 0 falls keine angegeben ist. <xsl:template match="cd" priority="2">... </xsl:template> 42 Die Auswertung der Priorität hängt davon ab ob die Templates mit <xsl:inlcude> bzw. mit <xsl:import> eingebettet worden sind.

43 XSL <xsl:include> Einbinden von Stylesheets mit <xsl:include> Mittels <xsl:include> können andere Stylesheets eingebunden werden. <xsl:include> muss sich innerhalb des <xsl:stylesheet> Root Elementes befinden. Syntax <xsl:include href="uri"/> Die so eingebundenen Templates sind gleichberechtigt, wie die des Hauptstylesheets 43 Templates mit höherer Priorität haben Vorrang. Besitzen 2 Templates die gleiche, so gewinnt welches als letztes das Template definiert

44 XSL <xsl:include> Modularisierung von Stylesheets Konflikt von gleichnamigen Templates bei <xsl:include> z.b. Annahme alle 3 Templates A haben gleiche Priorität include <xsl> <xsl> include includedoc1 doc1 include includedoc2 doc2 template A docmain.xsl <xsl> <xsl> template A include doc1.xsl <xsl> <xsl> template A doc2.xsl 44 Template A in docmain.xsl gewinnt da es als letztes das Template definiert

45 XSL <xsl:include> Modularisierung von Stylesheets Konflikt von gleichnamigen Templates bei <xsl:include> z.b. include <xsl> <xsl> include includedoc1 doc1 include includedoc2 doc2 template A (prio (prio1) 1) docmain.xsl <xsl> <xsl> template A (prio (prio2) 2) include doc1.xsl <xsl> <xsl> template A (prio (prio2) 2) doc2.xsl 45 Template A in doc2.xsl gewinnt da es als letztes das Template mit höschster Prio definiert

46 Importieren von Stylesheets XSL <xsl:import> Mittels <xsl:import> können andere Stylesheets eingebunden werden. <xsl:import> muss als erstes Element nach dem <xsl:stylesheet> Root Element erscheinen. Syntax <xsl:import href="uri"/> Die Templates im Hauptstylesheets haben immer Vorrang auch dann wenn die Prio niedriger ist Realisierung einer Überschreibung 46 Importierte Templates untereinander verhalten sich gleich wie bei <xsl:inlcude>

47 XSL <xsl:import> Import von Stylesheets Konflikt von gleichnamigen Templates bei <xsl:import> z.b. Annahme alle 3 Templates A haben gleiche Priorität import <xsl> <xsl> import importdoc1 import importdoc2 template A docmain.xsl <xsl> <xsl> template A import doc1.xsl <xsl> <xsl> template A doc2.xsl 47 Template A in docmain.xsl gewinnt da es sowieso von allen immer die höchste Prio hat

48 XSL <xsl:import> Import von Stylesheets Konflikt von gleichnamigen Templates bei <xsl:import> z.b. import <xsl> <xsl> include includedoc1 doc1 include includedoc2 doc2 template A (prio (prio1) 1) docmain.xsl <xsl> <xsl> template A (prio (prio2) 2) import doc1.xsl <xsl> <xsl> template A (prio (prio2) 2) doc2.xsl 48 Template A in docmain.xsl gewinnt da es sowieso von allen immer die höchste Prio hat

49 XSL <xsl:import> Import von Stylesheets Konflikt von gleichnamigen Templates bei <xsl:import> z.b. import <xsl> <xsl> import importdoc1 import importdoc2 docmain.xsl <xsl> <xsl> template A (prio (prio2) 2) import doc1.xsl <xsl> <xsl> template A (prio (prio2) 2) doc2.xsl 49 Template A in doc2.xsl gewinnt da es als letztes das Template mit höchster Prio definiert

50 XSL <xsl:apply-imports> Importierte Templates anwenden Mittels <xsl:apply-imports> wird versucht die importierten Templates anzuwenden. Templates aus dem Hauptstylesheet werden nicht berücksichtigt Dies ist nützlich um so überschriebene Templates wieder zu aktivieren <xsl:apply-imports> wird wie <xsl:applytemplates> angewendet, jedoch wird kein select Attribut unterstützt Syntax <xsl:apply-imports /> 50

51 XSL <xsl:apply-imports> Importierte Templates anwenden z.b. <xsl:stylesheet... > <xsl:import href="standard.xsl"/> <xsl:template match="/catalog"> <xsl:apply-imports/> </xsl:template>  <xsl:template match="cd">... </xsl:template> 51 </xsl:stylesheet>

52 HashSpeicher erzeugen XSL <xsl:key> Falls mehrmals immer auf dieselben Nodes während einer Transformation zugegriffen wird, so lohnt es sich diese Nodes zu indexieren Mittels <xsl:key> kann ein HashSpeicher aufgebaut werden. <xsl:key> ist ein Top Level Element Syntax <xsl:key name="name" match="pattern" use="xpath-expression"/> Mit der XSL Funktion key() kann dann später auf den HashSpeicher zugegriffen werden 52

53 HashSpeicher erzeugen z.b. XSL <xsl:apply-imports> <xsl:stylesheet... > <xsl:key name="cdcountry" match="//cd" <xsl:template match="/">  <xsl:for-each select="key('cdcountry','usa')">... </xsl:for-each> </xsl:template> </xsl:stylesheet> 53

54 Bekannte Probleme in XSL 1.0: XSL Nachteile Keine Möglichkeit Variabeln zu verändern Lösung: Rekursion und Überschreibung der Variabeln in Templates Beim Auswerten von XPath Ausdrücken wird nicht auf die Existenz von Nodes geprüft. Folge z.b. es werden leere Werte zurückgegeben welche nicht erwartet werden. Lösung: Einsatz von Validierung 54

55 Neuerungen in XSL 2.0: XSL Ausblick 2.0 Automatische Umwandlung von Result Tree Fragments (RTF) in NodeSets (DOM) Keine node-set() Funktion mehr notwendig Ausgabe des Prozesses kann in mehrere Dokumente gleichzeitig erfolgen Möglichkeit Gruppen Operationen durchzuführen for-each-group Eigene Funktionen zu definieren und direkt in XPath Ausdrücken zu verwenden. 55 Default Namespaces und externe Dokumente als Text einzulesen

56 XSL - Links W3C XSL: SUN Tutorial: Introducing XSL, XSLT and XPath IBM XSL Tutorial: Hands on XSL Apache Xalan: 56