XML mit Java OpenSource. (c) Mark Egloff 2003 XSL << EXSLT >>

Transkript

1 XSL << EXSLT >> 1

2 Extensions for XSL Transformations EXSLT XSL 1.0 hat noch diverse Mängel an Funktionalität. Eine Initiative standardisiert vermisste Funktionalität und stellt sie als Stylesheet Library zur Verfügung EXSLT definiert Funktionen für folgende Bereiche Dates, Times, Dynamic, Common, Functions, Math, Random, Regular Expressions, Sets, Strings 2 Hersteller haben schon begonnen diese Funktionen direkt in die Prozessors wie Xalan fest zu integrieren d.h. externe Library ist nicht immer notwendig

3 3 Beispiel einer Anwendung einer EXLST Funktion Aufgabe Alle Länder der CD s ermitteln EXSLT set:distinct <catalog> <cd> <title>empire Burlesque</title> <artist>bob Dylan</artist> <country>usa</country> <price>10.90</price> </cd> <cd> <title>hide your heart</title> <artist>bonnie Tyler</artist> <country>uk</country> <price>9.90</price> </cd>... </catalog> USA UK EU Norway

4 4 <xsl:stylesheet... > EXSLT set:distinct Beispiel einer Anwendung einer EXLST Funktion Alle Länder der CD s ermitteln Erste Lösung, erfüllt aber Anforderung nicht so ganz. <xsl:template match="/catalog"> <xsl:for-each select="cd/country"> <xsl:value-of select="."/> </xsl:for-each> </xsl:template> </xsl:stylesheet> USA USA USA UK USA Resultat ergibt eine Liste in der mehrmals die gleichen Einträge vorkommen. Analogie SQL: select distinct country from cd oder select country from cd group by country

5 EXSLT set:distinct Beispiel einer Anwendung einer EXLST Funktion Alle Länder der CD s ermitteln Dieses Beispiel verwendet die externe Library von <xsl:stylesheet... xmlns:set=" extension-element-prefixes="set"> <xsl:import href="set/set.xsl" /> <xsl:template match="/catalog"> <xsl:for-each select="set:distinct(cd/country)"> <xsl:value-of select="."/> </xsl:for-each> </xsl:template> 5 </xsl:stylesheet>

6 Eingebettete Extensions in Xalan EXSLT In Xalan sind schon folgende EXSLT Module integriert. dynamic: map(), max(), min(), sum(), math: abs(), sin(), exp(), sqrt(), max(), sets: difference(), distinct(), leading(), strings: align(), concat(), padding(), tokenize() Xalan Javadoc: org.apache.xalan.lib.exsltbase 6 Um die Funktionen dieser Module aufzurufen muss nur der jeweilige Namespace zuvor aufgeführt werden z.b.

7 EXSLT set:distinct Beispiel einer Anwendung einer EXLST Funktion Alle Länder der CD s ermitteln Dieses Beispiel verwendet die eingebettete set:distinct() Funktion von Xalan. Keine zusätzliche EXSLT Library notwendig. <xsl:stylesheet... xmlns:set=" extension-element-prefixes="set"> <xsl:template match="/catalog"> <xsl:for-each select="set:distinct(cd/country)"> <xsl:value-of select="."/> </xsl:for-each> </xsl:template> 7 </xsl:stylesheet>

8 XSL << Xalan Java Extensions >> 8

9 Xalan Extensions XSL Xalan Extensions Xalan bietet verschiedene API s um Extensions zu realisieren. Es ist so flexibel das die Extensions z.t. direkt im XSL in der jeweiligen Sprache geschrieben werden können Xalan Extensions können in folgenden Sprachen geschrieben werden: Java JavaScript NetRexx(IBM) BML (IBM) JScript (MicroSoft) VBScript (MicroSoft) Python Perl TCL 9 Allerdings wird meist für die jeweilige Sprache ein Java JNI Wrapper oder ein entsprechender Interpreter in Java benötigt Zusatz Libraries

10 XSL Xalan Extensions Beispiel einer Xalan Extension verfass in Javascript und direkt im XSL integriert 10 <xsl:stylesheet... > <xalan:component prefix="myext" functions="getdate"> <xalan:script lang="javascript"> // This is javascript function getdate(numdays) { var d = new Date(); var totaldays = parseint(numdays); d.setdate(d.getdate() + totaldays); return d.tolocalestring(); } </xalan:script> </xalan:component> <xsl:template match="deadline"> <xsl:value-of select="myext:getdate(string(@numdays))"/> </xsl:template> </xsl:stylesheet>

11 XSL Xalan Java Extensions Java Integration bei Xalan App 1 <xml> <xml> XSLT Processor <xml> <xml> <xsl> <xsl> <JExt> <JExt> Java Class DB Das XSL enthält Funktionsaufrufe die mit einer bestimmten Java Klasse verknüpft sind. Die Funktionen selber werden in Java Klassen geschrieben. 11

12 XSL Xalan Java Extensions Erstellung von Xalan Java Extensions Die Java Klassen benötigen kein API von Xalan d.h. sie können unabhängig entwickelt werden keine Vererbung, Interfaces oder Relationen Dies bedeutet wiederum, dass jede Java Klasse verwendet werden kann 12 Es gibt 2 Prinzipien um Java Klassen in XSL zu verwenden: Mittels java Namespace einzelne Objektinstanzen erstellen und als <xsl:variable> handzuhaben für Instanzen Eigenen Namespace für die Klasse einrichten und static Methoden direkt aufrufen für static

13 XSL Xalan Java Extensions Erstellung von Xalan Java Extensions Verwendung von Objektinstanzen Um Objektinstanzen zu erstellen muss der Xalan java Namespace definiert werden. Danach kann auf jede Klasse im Classpath über diesen Namespace zugegriffen werden. xmlns:java=" Instanzierungen werden mit dem Syntax java:klasse.new(param) erzeugt und einer <xsl:variable> zugewiesen 13 Instanz Methoden werden mit dem Syntax java:methode($xslvar,param) aufgerufen

14 XSL Xalan Java Extensions Beispiel einer Xalan Java Extension (1/2) Verwendung von Objektinstanzen, einfache Java Klasse Counter public class Counter { long count = 0; } public long incr() { return ++count; } public long decr() { return --count; } public long get() { return count; } Klasse hat nur Instanz Members 14 Klasse ist unabhängig von Xalan

15 XSL Xalan Java Extensions 15 Beispiel einer Xalan Java Extension (2/2) Verwendung von Objektinstanzen, Klasse Counter im Stylesheet <xsl:stylesheet... xmlns:java=" <xsl:variable name="i" select="java:counter.new()"/> <xsl:template match="/catalog"> <xsl:apply-templates select="cd"/> </xsl:template> <xsl:template match="cd"> <xsl:variable name="temp" select="java:incr($i)"/> <xsl:value-of select="java:get($i)"/> </xsl:template> </xsl:stylesheet> Syntax ist gewöhnungsbedürftig. Temporäre Variabeln nötig um Java Methoden ausführen zu lassen

16 XSL Xalan Java Extensions Erstellung von Xalan Java Extensions Verwendung von static Methoden Um static Methoden aufzurufen muss der xalan Namespace definiert werden. Danach kann ein eigener Namespace für Klasse eingeführt werden xmlns:xalan=" xmlns:[myspace]="xalan://[klassennamen]" Static Methoden werden mit dem Syntax MySpace:Methode(param) aufgerufen 16

17 XSL Xalan Java Extensions Beispiel einer Xalan Java Extension (1/2) Verwendung von static Methoden, einfache Log4J Klasse import org.apache.log4j.logger; public class Log4JXslExtension { static Logger log = Logger.getLogger(Log4JXslExtension.class); public static void debug(string s){ log.debug(s);} public static void info(string s){ log.info(s); } public static void warn(string s){ log.warn(s); } } public static void error(string s){ log.error(s); } 17 Klasse ist unabhängig von Xalan

18 XSL Xalan Java Extensions Beispiel einer Xalan Java Extension (2/2) Verwendung von static Methoden im Stylesheet <xsl:stylesheet... xmlns:xalan=" xmlns:log4j="xalan://log4jxslextension"> <xsl:template match="/catalog"> <xsl:apply-templates select="cd"/> </xsl:template> <xsl:template match="cd"> <!-- Aufruf der static Methode --> <xsl:value-of select="log4j:info(title)"/> </xsl:template> </xsl:stylesheet> 18

19 XSL Xalan Java Extensions Mapping der Java Datentypen zu XSL Datentypen Folgende Ad-hoc Umwandlungen passieren bei Parameterübergaben Java Types org.w3c.dom.traversal.nodeiterator org.w3c.dom.node org.w3c.dom.nodelist java.lang.string java.lang.boolean java.lang.number org.w3c.dom.documentfragment XSLT Type NodeSet String Boolean Number Result Tree Fragment 19

20 XSL Xalan Java Extensions Beispiel einer Xalan Java Extension Integrierung von Jakarta RegExp in XSL Was ist Regexp? Ein Beispiel // Compile expression, looking for multiple a before b RE r = new RE("(a*)b"); // Match boolean matched = r.match("xaaaab"); // wholeexpr will be 'aaaab' String wholeexpr = r.getparen(0); // insideparens will be 'aaaa' String insideparens = r.getparen(1); 20 RegExp (Reguläre Expressions) dienen dazu um Textdaten anhand Patterns (Regeln) zu verarbeiten

21 XSL Xalan Java Extensions Beispiel einer Xalan Java Extension Integrierung von Jakarta RegExp in XSL Die grep() Funktion, Auszug aus dem Javadoc public java.lang.string[] grep(java.lang.object[] search) Returns an array of Strings, whose tostring representation matches a regular expression. This method works like the Perl function of the same name. Given a regular expression of "a*b" and an array of String objects of [foo, aab, zzz, aaaab], the array of Strings returned by grep would be [aab, aaaab]. Parameters: search - Array of Objects to search Returns: Array of Strings whose tostring() value matches this regular expression. 21 Mittels grep können wir nach bestimmten Stringpatterns suchen

22 XSL Xalan Java Extensions Beispiel einer Xalan Java Extension Integrierung von Jakarta RegExp in XSL grep() Funktion für XSL Funktion wrappen, Nodes als Parameter 22 public static NodeList grep(string pattern, NodeList nlist) { NodeSet resultset = new NodeSet(); String[] sarr = new String[nlist.getLength()]; } for (int i = 0; i < nlist.getlength(); i++) { Node n = nlist.item(i); sarr[i] = n.getnodevalue(); } RE re = new RE(pattern); String[] resultgrep = re.grep(sarr); for (int i = 0; i < resultgrep.length; i++) resultset.addnode(doc.createtextnode(resultgrep[i])); return resultset;

23 XSL Xalan Java Extensions Beispiel einer Xalan Java Extension Integrierung von Jakarta RegExp in XSL Die grep() Funktion im Stylesheet angewendet <xsl:stylesheet... xmlns:xalan=" xmlns:reg="xalan://regexp"> <xsl:template match="/catalog"> <xsl:for-each select="reg:grep('b.*t.*',cd//text())"> <xsl:value-of select="."/> </xsl:for-each> </xsl:template> </xsl:stylesheet> 23 Ausgabe Boonie Tyler

24 XSL Xalan Java Extensions Wann XSL Funktionen wann Java Extensions? Dort wo es Sinn macht! z.b. nützt es nichts 200 Zeilen XSL zu schreiben wenn man es mit Java Extensions in ca. 10 Linien erreichen kann (oder umgekehrt). Die Stärke von XSL liegt daran Baumstrukturen zu verarbeiten Die Stärke von Java sind vorwiegend im Bereich Datenumwandlungen u. Algorithmen 24 Falls Extensions eingesetzt werden müssen, so entwickelt ein offenes, generisches Design um die Wiederverwendbarkeit zu garantieren

25 XSL - Links W3C XSL: SUN Tutorial: Introducing XSL, XSLT and XPath IBM XSL Tutorial: Hands on XSL Apache Xalan: EXSLT: XSLT Standard Library: Jakarta RegExp: 25

26 JAXP << JAXP TRAX API >> 1

27 Was ist TRAX? JAXP TRAX TRAX = Transformation API for XML Mittels TRAX können XSL Transformationen in Java ausgeführt werden. TRAX ist in JAXP integriert und besteht aus folgendem Package: javax.xml.transform 2 Seit Java 1.4.x ist JAXP schon integriert und besitzt für das TRAX eine Xalan Implementation im rt.jar Java Endorsed für neuere Versionen

28 JAXP TRAX Konfiguration Implementationen festlegen: Die JAXP Implementationen können auf verschiedene Weise angegeben werden. Die JVM versucht dabei in folgender Reihenfolge die Konfiguration zu finden: 3 1. Über die System Properties 2. Über die jaxp.properties im JAVA_HOME 3. Mittels dem Jar Service Provider Mechanism 4. Falls nichts gefunden wurde wird jeweils die Standard Implementation der jeweiligen Plattform genommen. JAVA_HOME\jre\lib\rt.jar Xalan

29 JAXP TRAX Konfiguration Implementationen festlegen: Die Implementation kann beim Start der JVM mittels den SystemProperties festgelegt werden: javax.xml.transform.transformerfactory Als Wert muss eine Klasse angegeben werden, die dieses Interface unterstützt. z.b: java classpath xml-apis.jar -Djava.endorsed.dirs=lib/endorsed -Djavax.xml.transform.TransformerFactory= org.apache.xalan.processor.transformer FactoryImpl TestXSLT 4 Ab Java 1.4.x die neuen Xalan Libraries mit dem Endorsed Feature einbinden! Djava.endorsed.dirs!

30 JAXP TRAX Konfiguration JAXP- TRAX Implementationen festlegen: Die Implementation wird mittels dem Jar Service Provider Discovery Mechanism festgelegt. Hierbei wird ein Textfile mit dem gleichem Namen ins META-INF/services des *.jar Files abgelegt: javax.xml.transform.transformerfactory 5 Ab Java 1.4.x die neuen Xalan Libraries mit dem Endorsed Feature einbinden! Djava.endorsed.dirs!

31 Die wichtigsten Klassen von TRAX API: javax.xml.transform Transformer / TransfomerFactory Factory und XSLT Processor für die Ausführung einer Transformation Source XSL und XML EingabeMedium, kann eine SAXSource, DOMSource oder StreamSource sein Result AusgabeMedium kann ein SAXResult, DOMResult oder ein StreamResult sein 6 Templates vorkompilierte Stylesheets, können direkt für Transformationen verwendet werden (Perfomanceoptimierung)

32 Interface Transformer und TransformerFactory 7

33 Verwendung Klassen von TRAX API: Ein Transformer verwenden (single threading) XSL XSL Source Source Transformer Factory XML XML Source Source Trans former Result Result 8

34 Wann welche Source? Source Type DOMSource StreamSource SAXSource Beschreibung Daten liegen schon geparst als DOM vor für kleinere Datenmengen (< 1MB) Daten liegen als Stream vor z.b. als lokales File, oder über TCP/IP Socket für grosse Datenmengen (> 1MB) Daten liegen nicht in XML vor, müssen mit einen eigenen Parser in XML Form gebracht werden eigener SAXParser schreiben 9

35 Wann welches Result? 10 Result Type DOMResult StreamResult SAXResult Beschreibung Falls Ausgabe wieder ein XML in DOM Form sein muss, z.b. für weitere Verarbeitung mit XPath Aus einem DOMResult kann schnell wieder ein DOMSource gemacht werden, somit kann gerade eine weitere Folgetransformation erfolgen. für kleinere Datenmengen (< 1MB) Falls Ausgabe nicht unbedingt XML sein muss z.b. Text, CSV, HTML etc. für grosse Datenmengen (> 1MB) Falls Ausgabe zwar in XML erfolgen muss jedoch Endformat dennoch selber erstellt werden muss eigener ContentHandler schreiben

36 Vorgang einer XSL Transformation mit TRAX: (single threading) 1. TransformerFactory instanzieren 2. XSL Source erzeugen 3. Transformer erzeugen 4. XML Source erzeugen 5. Result Objekt erzeugen 6. Transformation durchführen 11 Der Transformer wird für ein XSL einmal erzeugt und kann dann für mehrere Transformationen verwendet werden

37 12 Beispiel XSL Transformation mit TRAX Stream 2 Stream Transformation (1/3) import javax.xml.transform.*; import javax.xml.transform.stream.*; import java.io.*; public class RunDOM2DOMTransformation { public static void main( String args[] ) { try { // Transformerfactory initialisieren TransformerFactory tfactory = TransformerFactory.newInstance(); 1. if (!tfactory.getfeature(streamsource.feature)!tfactory.getfeature(streamresult.feature)) throw new Exception("not Supported!");

38 Beispiel XSL Transformation mit TRAX Stream 2 Stream Transformation (2/3) //XSL einlesen und StreamSource erzeugen StreamSource ssxsl = new StreamSource(new File("cdhtml.xsl"); 2. // Transformer erzeugen Transformer trans = tfactory.newtransformer(ssxsl); 3. // Eingabe XML als StreamSource erzeugen StreamSource ssxml = new StreamSource(new File("catalog.xml")); 4. 13

39 Beispiel XSL Transformation mit TRAX Stream 2 Stream Transformation (3/3) // Result Objekt erzeugen um Ergebnis aufzunehmen StreamResult sr = new StreamResult( new File("cdcatalog.html")); 5. // Transformation durchführen trans.transform(ssxml,sr); 6. } catch(exception ex) {ex.printstacktrace();} } } 14

40 15 Beispiel XSL Transformation mit TRAX DOM 2 DOM Transformation (1/3) import javax.xml.transform.*; import javax.xml.transform.dom.*; import javax.xml.parsers.*; import java.io.*; import org.w3c.dom.*; public class RunDOM2DOMTransformation { public static void main( String args[] ) { try { // Transformerfactory initialisieren TransformerFactory tfactory = TransformerFactory.newInstance(); if (!tfactory.getfeature(domsource.feature)!tfactory.getfeature(domresult.feature)) throw new Exception("not Supported!"); 1.

41 Beispiel XSL Transformation mit TRAX DOM 2 DOM Transformation (2/3) // DOMBuilder initialisieren um XSL und XML zu lesen DocumentBuilderFactory dbfactory = DocumentBuilderFactory.newInstance(); DocumentBuilder dbuilder = dbfactory.newdocumentbuilder(); //XSL einlesen und DOMSource erzeugen Document docxsl = dbuilder.parse(new File("cdhtml.xsl")); 2. DOMSource dsxsl = new DOMSource(docXSL); // Transformer erzeugen Transformer trans = tfactory.newtransformer(dsxsl); // Eingabe XML als DOMSource erzeugen 4. Document docxml = dbuilder.parse(new File("catalog.xml")); DOMSource dsxml = new DOMSource(docXML);

42 Beispiel XSL Transformation mit TRAX DOM 2 DOM Transformation (3/3) 17 } } // Result Objekt erzeugen um Ergebnis aufzunehmen DOMResult dr = new DOMResult(); 5. // Transformation durchführen trans.transform(dsxml,dr); 6. // Ergebnis ist ein DOM aus Result Objekt extrahieren Document docres = (Document) dr.getnode();... // weitere Verarbeitung des Resultats } catch(exception ex) {ex.printstacktrace();}

43 Mehrstufige Transformation <xml> <xml> 1 XSLT Processor 1 <xml> <xml> 2 XSLT Processor 2 <xml> <xml> 3 <xsl> <xsl> XML1 XML1 <xsl> <xsl> XML2 XML2 Transformationen können hintereinander geschaltet werden Mehrstufige Transformation 18 Damit lassen sich komplexere Transformationen vereinfachen bessere Wartungsfreundlichkeit

44 Beispiel XSL Transformation mit TRAX Mehrstufige Transformation DOM 2 DOM //DOMSource für Eingabe XML festlegen DOMSource dsxml = new DOMSource(docXML); // Result Objekt erzeugen um Ergebnis aufzunehmen DOMResult dr = new DOMResult(); // 1. Transformation durchführen transformer1.transform(dsxml,dr); // Ergebnis ist neue Eingabe für nächste Transformation dsxml = new DOMSource(dr.getNode()); // neues Result Objekt erzeugen um Ergebnis aufzunehmen dr = new DOMResult(); 19 // 2. Transformation durchführen transformer2.transform(dsxml,dr);

45 Verwendung Klassen von TRAX API: Mehrere Transformer gleichzeitig verwenden (multi threading) XSL XSL Source Source Transformer Factory Templates ThreadThreadThread Workers XML XML Source Source Trans former Trans former Trans former Result Result 20

46 Nutzen der Templates Klasse: Bei einer Templates Instanzierung wird das XSL schon vorkompiliert und in Logik gewandelt Bei mehrer Verwendung entsteht dadurch eine enorme Performancegewinnung, da das XSL Stylesheet nicht ständig übersetzt werden muss Templates ist Threadsafe, kann von mehreren Threads gleichzeitig benützt werden 21

47 Vorgang einer XSL Transformation mit TRAX: (multi threading) 1. TransformerFactory instanzieren 2. XSL Source erzeugen 3. Template erzeugen 4. Thread erzeugen 5. Transformer erzeugen 6. XML Source erzeugen 7. Result Objekt erzeugen 8. Transformation durchführen 22 Aus einem Template werden mehrere Transformer erzeugt und einem Thread zugeordnet Threadsafe

48 23 Beispiel XSL Transformation mit TRAX Stream 2 Stream Transformation mit Templates (1/5) import javax.xml.transform.*; import javax.xml.transform.stream.*; import java.io.*; public class RunDOM2DOMTransformation { public static void main( String args[] ) { try { // Transformerfactory initialisieren TransformerFactory tfactory = TransformerFactory.newInstance(); 1. if (!tfactory.getfeature(streamsource.feature)!tfactory.getfeature(streamresult.feature)) throw new Exception("not Supported!");

49 Beispiel XSL Transformation mit TRAX Stream 2 Stream Transformation mit Templates (2/5) //XSL einlesen und StreamSource erzeugen StreamSource ssxsl = new StreamSource(new File("cdhtml.xsl"); 2. // Template erzeugen Templates templ = tfactory.newtemplates(ssxsl); // Threads erzeugen, Templates sharen Thread[] arrthread = new Thread[10]; for( int i=0; i<arrthread.length; i++) { MyTransiThread thread = new MyTransiThread(i,templ); arrthread[i] = thread; thread.start(); } 4.

50 Beispiel XSL Transformation mit TRAX Stream 2 Stream Transformation mit Templates (3/5) // auf Threads warten und beenden for( int i=0; i<arrthread.length; i++) { arrthread[i].join(); } } // end try catch( Exception ex ) { ex.printstacktrace(); } } // end main } end class 25

51 Beispiel XSL Transformation mit TRAX Stream 2 Stream Transformation mit Templates (4/5) import javax.xml.transform.*; import javax.xml.transform.stream.*; import java.io.*; public class MyTransiThread extends Thread { // gemeinsames Objekt, Referenz auf main templ Templates templ; 26 // Constructor public MyTransiThread(int i, Templates templ) { super("mytransi"+i); this.templ = templ; }

52 27 Beispiel XSL Transformation mit TRAX Stream 2 Stream Transformation mit Templates (5/5) public void run() { try { // Transformer erzeugen 5. Transformer trans = templ.newtransformer(); // Eingabe XML als StreamSource erzeugen StreamSource ssxml = new StreamSource(new File("catalog.xml")); // Result Objekt erzeugen um Ergebnis aufzunehmen StreamResult sr = new StreamResult( new File(getName()+".html")); // Transformation durchführen trans.transform(ssxml,sr); } catch(exception ex) {ex.printstacktrace();} }}

53 Klasse TransformatorFactory Verwendung von Features Features definieren in der TRAX API ob eine bestimmte Source oder Result Art unterstützt wird. z.b. So kann man zur Laufzeit überprüfen ob die verwendetete TRAX Implementation diese auch unterstützt z.b.: TransformerFactory tfactory = TransformerFactory.newInstance(); if (!tfactory.getfeature(streamsource.feature)!tfactory.getfeature(streamresult.feature)) throw new Exception("not Supported!"); 28

54 Klasse TransformatorFactory Verwendung von Attributes Die TRAX API erlaubt mittels Attributes herstellerspezifische Optionen zu aktivieren oder auszuschalten. 29 z.b.: import org.apache.xalan.processor.transformerfactoryimpl;... TransformerFactory tfact = TransformerFactory.newInstance(); if (tfact instanceof TransformerFactoryImpl) { tfact.setattribute( TransformerFactoryImpl.FEATURE_INCREMENTAL, Boolean.FALSE); }

55 Klasse Transformator Unterstützung von Parametern Es können für eine Transformation Parameter angegeben werden. Diese überschreiben die Standardwerte von globalen Parametern (Variabeln) welche im XSL definiert wurden z.b.: // Transformer erzeugen Transformer trans = tfactory.newtransformer(dsxsl); // Parameter setzen trans.setparameter("var55", new Integer(55)); trans.setparameter("src","c:/mydocs/pics/image.gif"); // transfomration durchführen trans.transform(dsxml,dsresult); 30

56 Klasse Transformator Ausgabeoptionen festlegen Es können für die Transformation bestimmte Optionen für die Ausgabeformatierung gesetzt werden Diese Angaben überschreiben die Angaben im XSL Stylesheet <xsl:output>. Von der TRAX API gibt es die Klasse OutputKeys welche die standardisierten Ausgabeoptionen als statische Konstanten vorgibt. Es gibt jedoch auch herstellerspezifische Optionen. 31

57 Klasse Transformator Ausgabeoptionen festlegen z.b.: // Transformer erzeugen Transformer trans = tfactory.newtransformer(dsxsl); // Standardisierte Ausgabeoptionen setzen trans.setoutputproperty(outputkeys.encoding, "ISO "); trans.setoutputproperty(outputkeys.indent,"yes"); // herstellerspezifische Ausgabeoptionen setzen trans.setoutputproperty(org.apache.xml.serializer.out putpropertiesfactory.s_key_indent_amount,"4"); // transfomration durchführen trans.transform(dsxml,dsresult); 32

58 Interface URIResolver Eigene Auflösung von Ressourceangaben realisieren Klasse Transformer sowie die Factory unterstützen die Möglichkeit einen eigenen URIResolver zu verwenden seturiresolver() Dadurch besitzt man die Möglichkeit Pfade zu externen Ressourcen in XSL selber aufzulösen siehe auch JAXP Parser API, EntityResolver 33 public interface URIResolver { public Source resolve(string href, String base) throws TransformerException; }

59 Interface URIResolver Eigene Auflösung von Ressourceangaben realisieren <xml> <xml> XSLT Processor result result <xsl> <xsl>? Res Res source source URIResolver File File etc. DB 34 XSL können auf externe Dateien verweisen. Der XSLT Prozessor benützt den Resolver um die Pfadangabe auf das jeweilige Environment anzupassen.

60 Interface URIResolver Eigene Auflösung von Ressourcepfaden realisieren javax.xml.transform URIResolver MyResolver resolve() public class MyResolver implements URIResolver { static final String ROOT = "D:/MyRoot"; public Source resolve(string href, String base) throws TransformerException 35 } { } return new StreamSource( new File(ROOT + "/" + href));

61 Interface ErrorListener Eigener ErrorListener realisieren Klasse Transformer sowie die Factory unterstützen die Möglichkeit einen eigenen ErrorListener zu verwenden seterrorlistener() Dadurch besitzt man die Möglichkeit eine eigene Fehlerbehandlung zu realisieren siehe auch JAXP Parser API, ErrorHandler 36 public interface ErrorListener { public void warning(transformerexception ex); public void error(transformerexception ex); public void fatalerror(transformerexception ex); }

62 Interface ErrorListener Eigener ErrorListener realisieren javax.xml.transform ErrorListener MyListener public class MyListener implements ErrorListener { public void warning(transformerexception ex) throws TransformerException { } logger.warning("mylistener.warning",ex); 37 }...

63 JAXP- TRAX Links JSR 63: Java API for XML Processing Xalan-J : Saxon: OnJava.com: XML Processing with TRAX developer.com: Optimizing Stylesheet Execution with the Java Transformation API for XML (TRAX) 38