Vad är XSLT XSLT extensible Stylesheet Language Transformations

Transkript

1 Vad är XSLT XSLT extensible Stylesheet Language Transformations 2D1525 Programmering för interaktiva medier Ett transformationsspråk som transformerar ett XMLdokument till ett annat XML- eller textdokument. Kan t.ex. användas för att transformera en XML-struktur till XHTML och WML. En del av XSL som förutom XSLT inkluderar XSL-FO. Rekommendation från W3C Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH XSLT-processor XSLT vs CSS XSLT är en rekommendation, inte ett program. Det finns däremot program som kan utföra XSLTtransformationer, sk XSLTprocessorer. Xalan och SAXON är vanliga XSLT-processorer. xmldokument xsltdokument xsltprocessor Output, t.ex. xhtml Precis som för CSS letar man efter mönster (patterns) i en XMLstruktur, och när dessa hittas utförs åtgärder (instruction elementss) Till skillnad från CSS är syftet med XSLT att förändra ett XMLträds struktur, inte dess visuella representation. XSLT kan skapa helt nya element, byta ordning på element, välja ut delar av innehållet osv, vilket inte CSS kan. XML-strukturen som är indata kallas input-träd och utdata kallas resultat-träd. CSS har inga resultat-träd Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH

2 Namespace för XSLT Templates Den namespace som används för version 1.0 av XSLT är Den brukar bindas till prefixet xsl Root-elementet är <xsl:stylesheet> eller <xsl:transform> vilka är ekvivalenta. Ett XSLT-dokument brukar alltså se ut så här: <xsl:stylesheet version= 1.0 xmlns:xsl= > <!-- innehåll --> Mönstermatchningen görs i elementet <xsl:template> <xsl:template> tar ett obligatoriskt attribut match som innehåller ett Xpathuttryck. Elementinnehållet är ett eller flera instruction element, s.k. action på XSLT-stylesheet <xsl:template match= / > [action] [action] Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH instruction elements (actions) <xsl:apply-templates> En action är ett uttryck som bestämmer vad som ska sättas in i resultatträdet när ett visst mönster påträffas. Några vanliga actions är Sätt in XML-element, attribut och textnoder. Utför eventuella template-regler för barnelement. Sätt inte in något alls. på XSLT-stylesheet <xsl:template match= / > <xsl:apply-templates> används för att applicera templates på barn-element till det aktuella elementet i inputträdet. Det har ett frivilligt select - attribut som innehåller en XPath relativt det aktuella elementet. på XSLT-stylesheet <xsl:template match= / > <xsl:apply-templates select= date /> <xsl:apply-templates select= title /> Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH

3 Binda XSLT-stylesheets till XML-dokument Det enklaste sättet att binda ett xslt-stylesheet med ett xml-dokument är att ange båda som inparametrar vid anropet av xslt-processorn. Det andra sättet är att ange en processinstruktion i xmldokumentet med en href till xslt-dokumentet. Vid anrop av XSLT-processorn >java org.apache.xalan.xslt.process -IN Party.xml -XSL Party.xsl Genom processinstruktion <?xml version="1.0"?> <?xsl-stylesheet type= text/xsl href= Party.xsl?> <!DOCTYPE party SYSTEM "party.dtd"> <party> <title>amphiox Gasque</title> <date> </date> <starttime>18.00</starttime> <endtime>03.00</endtime> </party> Party.xml <?xml version="1.0"?> <?xsl-stylesheet type= text/xsl href= Party.xsl?> <!DOCTYPE party SYSTEM "party.dtd"> <party> <title>amphiox Gasque</title> <date> </date> <starttime>18.00</starttime> <endtime>03.00</endtime> </party> output <?xml version="1.0"?> Amphiox Gasque </title></head> Komplett exempel Party.xsl <xsl:apply-templates> </title></head> <xsl:template match= date /> <xsl:template match= starttime /> <xsl:template match= endtime /> Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH Kokboksmetod - 1 Kokboksmetod - 1 Här följer en kokboksmetod för hur man skapar ett stylesheet givet ett visst xmldokument, t.ex. party.xml. Figurerna till höger kommer användas. Dokumentrooten Processinstruktioner Dokumenttypdeklarationer Element Party.xml <?xml version="1.0"?> <?xsl-stylesheet type= text/xsl href= Party.xsl?> <!DOCTYPE party SYSTEM "party.dtd"> <party> <title>amphiox Gasque</title> <date> </date> <starttime>18.00</starttime> <endtime>03.00</endtime> </party> <?xml... <?xsl... <!DOC... <party> <title> <date> <starttime> <endtime> Textnoder Amphiox Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH

4 Kokboksmetod - 2 Skapa en template för varje typ av elementnod i trädet (dvs om elementet <guest> förekommer fler än en gång i inputdokumentet ska ändå endast en template skapas). Låt action vara Party.xsl <xsl:template match= date > <xsl:template match= starttime > <xsl:template match= endtime > Björn Hedin, NADA/KTH Kokboksmetod - 3 Tag bort apply-templates från de regler som ska returnera tomt resultat och ta eventuella templates som därigenom aldrig blir åtkomliga. Party.xsl <xsl:template match= date /> <xsl:template match= starttime /> <xsl:template match= endtime /> Björn Hedin, NADA/KTH Kokboksmetod - 4 Lägg till och modifiera action-delen på återstående templates. vis lägga till och till rootelementets action ifall output ska vara html. Party.xsl </title></head> <xsl:template match= date /> <xsl:template match= starttime /> <xsl:template match= endtime /> XSLT-dokument är även XML-dokument Ett XSLT-dokument är ett fullständigt XML-dokument. Det betyder att det måste vara well-formed, dvs exempelvis att alla starttags måste ha motsvarande sluttags på rätt plats. Korrekt template </title></head> Felaktig template Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH

5 Mer om XPath XPath: Root-noden Mönstren i ett match-attribut till ett xsl:template-element är XPath-mönster. De används huvudsakligen för att identifiera en eller flera delar (element, attribut mm) i ett XML-dokument. XPath är en W3Crekommendation Det finns 7 olika nod-typer i XML-dokument som kan kommas åt via XPath-uttryck. Root-noden Elementnoder Textnoder Attributnoder Kommentarnoder Processinstruktionsnoder Namespacenoder Uttrycket i XPath som matchar root-noden (dvs dokumentet) är /. Jämför filsystemet i Unix eller absoluta sökvägar i URLar. Rootnoden i XPath <xsl:template match= / > Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH XPath: Elementnoder XPath: Attributnoder Elementnoder matchas med sitt namn. Det går att matcha flera element i samma template genom att separera elementnamnen med Elementnoder i XPath med flera matchningar i samma template <xsl:template match= date title endtime > Attribut kan matchas Vad gäller templates är man oftast intresserad av om ett visst element har ett visst attribut och ibland också vad detta attribut har för värde. Attribut i XPath Matchar alla food-element som har ett type-attribut <xsl:template match= food[@type] /> Matchar alla food-element som har ett type-attribut med ett värde som är dairy. <xsl:template match= food[@type= dairy ] /> Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH

6 XPath: Kommentarer processinstruktioner, text XPath: Hierarkier och wildcards Det går även att matcha kommentarnoder, processinstruktionsnoder och textnoder genom speciella XPath-funktioner. Kommentarer <xsl:template match= comment() /> Processinstruktioner <xsl:template match= processinginstruction() /> Det går att matcha noder relativt deras position gentemot andra noder. Samtliga noder uttrycks med * Title-element som är barn till party-element <xsl:template match= party/title /> Title-element som är ättlingar till party-element <xsl:template match= party//title /> Alla element som är barn till party-element <xsl:template match= party/* /> Textnoder <xsl:template match= text() /> Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH XPath: Positionsmatchning <xsl:value-of> Element kan även matchas via sin position. Det första b-elementet <xsl:template match= b[first-of-type()] /> Det sista b-elementet <xsl:template match= b[last-of-type()] /> Alla b-element utom det sista <xsl:template match= b[not(last-oftype())] /> Dessutom last-of-any() first-of-any() Med <xsl:value-of> går det att plocka ut värdet av ett element eller ett attribut. <xsl:value-of> har ett attribut, select, vilket har ett XPath-värde. Sökvägen utgår från noden där matchningen görs. <xsl:value-of select= title /> </title></head> Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH

7 <xsl:value-of>:. och.. Villkor:<xsl:if>. matchar den nod i inputträdet i vilken matchningen görs... matchar noden ovanför. Jfr unix och dos. <xsl:template match= starttime > Fest mellan <xsl:value-of select=. /> - <xsl:value-of select=../endtime /> XSLT stöder även vissa typer av villkor <xsl:if> har ett attribut test som evalueras till sant eller falskt. Om sant så utföres innehållet i tagen, annars inte <xsl:if test=.[@type= dairy ] > </xsl:if> Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH Villkor:<xsl:choose> <xsl:element> och <xsl:attribute> <xsl:choose> används för ifthen-else-konstruktioner. För if -delen används <xsl:when> För else -delen används <xsl:otherwise> <xsl:choose> <xsl:when test=.[@type= dairy ] > <xsl:value-of select= foo /> </xsl:when> <xsl:when test=.[@type= meat ] > <xsl:apply-templates select= bar /> </xsl:when> <xsl:otherwise > </xsl:otherwise> </xsl:choose> Ibland kan det vara önskvärt att använda en speciell xsltkonstruktion för att sätta in ett element i resultat-trädet. T.ex. om man vill sätta in ett attribut vars värde måste evalueras. Detta kan göras med <xsl:attribute> <xsl:element name= a > <xsl:attribute name= href > <xsl:value-of select= gurka /> </xsl:attribute> </xsl:element> Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH

8 Attribute Value Templates <xsl:for-each> Ett smidigt sätt att inkludera värdet härledda värden i ett attribut i resultatträdet utan att använda xsl:attribute är att stoppa in en XPath inom {}. I resultatträdet evalueras värdet inom klamrarna. FEL (<> får ej finnas i ett attribut) <xsl:template match= foo > <a href= <xsl:value-of select= gurka /> >gurka </a> RÄTT <xsl:template match= foo > <a href= {gurka} >gurka</a> Med <xsl:for-each> kan man iterera över noder som väljs med ett select-attribut. <xsl:template match= foo > <xsl:for-each select= bar /> <xsl:value-of select= gurka /> </xsl:for-each> Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH <xsl:copy> <xsl:copy-of> <xsl:copy> kopierar den aktuella noden till resultatträdet. Barn-element eller attribut följer inte med. Om noden är en elementnod eller root-nod kan noden ges ett innehåll med en template. <xsl:template match= foo bar > <xsl:copy select= gurka /> <xsl:copy-of> kopierar ett trädfragment från input-trädet till resultatträdet. Trädfragmentet lokaliseras med ett select-attribut. Till skillnad från <xsl-copy> kopieras även attribut, barnelement och ättlingar. <xsl:template match= foo bar > <xsl:copy-of select= gurka /> Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH

9 <xsl:text> <xsl:output> <xsl:text> kan användas för att placera text i resultatträdet. Skillnaden är att man kan få in exempelvis & och < i resultatträdet istället för deras entitetsreferenser vilka annars hamnar i resultatträdet. <xsl:template match= foo > <xsl:text> Hejhopp < > </xsl:text> Med <xsl:output> som är barnelement till <xsl:stylesheet> kan man styra sådant som doctype, kodning, indrag och outputmetod för resultatträdet. <xsl:output> method= html standalone= no doctype-system= party.dtd indent= yes media-type= text/html /> Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH <xsl:number>, <xsl:counter> Default-templates <xsl:number> och <xsl:counter> kan användas för att skapa numreringar. <xsl:number opererar på inputträdet medan <xsl:counter> opererar på resultat-trädet Default är att alla noder av samma nodtyp och med samma nodnamn som den aktuella noden räknas. <xsl:template match= foo > Foo-element nummer <xsl:number/> Om inga templates explicit anges för ett visst mönster finns ett antal defaulttemplates. Attribut- och textnoder <xsl:template match= <xsl:value-of select=. /> Root- och elementnoder <xsl:template match= / * > Processinstruktion- och kommentarnoder <xsl:template match= processinginstruction() comment() /> Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH

10 Var sker transformerna? Mer information I en web-miljö finns tre alternativ för var och när transformerna ska ske. När dokumentet skapas på servern. T.ex. med Xalan vid en kommandoprompt. På servern precis när dokumentet ska skickas till klienten. T.ex. med Cocoon, en servlet som kan användas i t.ex. Apache-webservern. På klienten, i dagsläget främst IE6 men även i Mozilla. Vilka för- och nackdelar finns med respektive alternativ? Xpath innehåller mycket mer, bland annat en hel del aritmetiska operationer. I kapitel 19 i XML in a nutshell finns en referensmanual. XSLT innehåller ett antal ytterligare element + många trixigheter och features man måste labba med för att upptäcka. Bra källa till kunskap är kapitel 20 i XML in a Nutshell Björn Hedin, NADA/KTH Björn Hedin, NADA/KTH