&cr;"> ]> Interne Funktionen Dieses Stylesheet enthält interne Templates und Funktionen, z.B. für Logging und Debug-Meldungen. Autor: Stefan Krause Homepage: http://www.expedimentum.org/ Lizenz (duale Lizenzierung): Dieses Stylesheet und die dazugehörige Dokumentation sind unter einer Creative Commons-Lizenz (CC-BY 3.0) lizenziert. Die Weiternutzung ist bei Namensnennung erlaubt. Dieses Stylesheet und die dazugehörige Dokumentation sind unter der sogenannten Expat License (einer GPL-kompatiblen MIT License) lizensiert. Es darf – als Ganzes oder auszugweise – unter Beibehaltung der Copyright-Notiz kopiert, verändert, veröffentlicht und verbreitet werden. Die Copyright-Notiz steht im Quelltext des Stylesheets und auf der Startseite der Dokumentation. Stylesheet: &XSL-Base-Directory;/internals.xsl Dokumentation: &doc-Base-Directory;/internals.html Test-Stylesheet: &XSL-Base-Directory;/internals_tests.xsl Test-Dokumentation: &doc-Base-Directory;/internals_tests.html XSLT-SB: &XSL-Base-Directory;/ Google Code: http://code.google.com/p/xslt-sb/ 0.2.25 2011-05-29 Stf xsb:type-annotation und xsb:cast hinzugefügt. 0.2.0 2011-05-14 Stf erste veröffentlichte Version 0.129 2011-02-27 Stf Erweiterung der Lizenz auf Expath/MIT license 0.82 2010-04-02 Stf Auslagerung von Test-Logik nach internals.testing.xsl und der Tests für internals.xsl und strings.xsl 0.53 2009-10-25 Stf Umstellung auf Namespaces xsb: und intern: 0.50 2009-10-11 Stf Ausgliederung von Logging aus internals.xsl nach internals.logging.xml; Eingliederung von strings-2.xsl 0.36 2009-08-02 Stf initiale Version gültige Werte: »ALL« > »TRACE« > »DEBUG« > »INFO« > »WARN« > »ERROR« > »FATAL« Meldungen können einen Level entsprechend den Log4j-Stufen »ALL« > »TRACE« > »DEBUG« > »INFO« > »WARN« > »ERROR« > »FATAL« haben (siehe Template xsb:internals.Error). Dieser Parameter bestimmt, ab welchem Wert Meldungen geloggt (d.h. angezeigt bzw. ausgegeben) werden. INFO Hilfsvariable, da dieser Wert häufig benötigt wird. gültige Werte: »ja«, »nein«, »yes«, »no«, »0«, »1« und andere verbale Wahrheitswerte, die xsb:parse-string-to-boolean() versteht Fehlermeldungen können einen Level entsprechend den Log4j-Stufen »ALL« > »TRACE« > »DEBUG« > »INFO« > »WARN« > »ERROR« > »FATAL« haben (siehe Template xsb:internals.Error). Bei »ERROR« wird die Verarbeitung normalerweise sofort beendet. Ist aber dieser Parameter auf »No« gesetzt, wird die Verarbeitung fortgesetzt, z.B. für Debugging. Bei »FATAL« wird die Verarbeitung in jedem Fall abgebrochen. Yes Hilfsvariable, da dieser Wert häufig benötigt wird. gültige Werte: »console«, »file« oder »both« Loggingmeldungen können via xsl:message auf die Konsole ausgegeben oder in die Ergebnis-Datei geschrieben werden. Auch beides ist möglich. Entsprechend ist als Ziel »console«, »file« oder »both« zu wählen. Bei einer davon abweichenden Eingabe wird nur auf die Konsole geschrieben console Hilfsvariable, da dieser Wert häufig benötigt wird. Bei der Ermittlung dieser Variablen wird außerdem der Parameter internals.logging.output-target auf Gültigkeit geprüft. _internals.logging.write-to-console Ungültige Eingabe für $internals.logging.output-target: "", es wird auf der Konsole ausgegeben. WARN Hilfsvariable, da dieser Wert häufig benötigt wird. gültige Werte: »comment«, »element«, »html«, »text« Nur bei Ausgabe in Datei: Loggingmeldungen können als HTML, XML-Elemente, Kommentare oder Text in das Ausgabedokument geschrieben werden. HTML eignet sich für die sofortige Anzeige, XML-Elemente für eine spätere maschinelle Auswertung, Kommentare für ad-hoc-Meldungen zur späteren Durchsicht. Text bietet sich an, wenn eine reine Report-Datei generiert werden soll. Ist die Eingabe ungültig, wird als Kommentar ausgegeben. comment Hilfsvariable, da dieser Wert häufig benötigt wird. Bei der Ermittlung dieser Variablen wird außerdem der Parameter internals.logging.write-to-file-style auf Gültigkeit geprüft. _internals.logging.write-to-file-as-comment Ungültige Eingabe für $internals.logging.write-to-file-style: "", es wird als Kommentar geschrieben. WARN Hilfsvariable, da dieser Wert häufig benötigt wird. Hilfsvariable, da dieser Wert häufig benötigt wird. Hilfsvariable, da dieser Wert häufig benötigt wird. Dieses Zeichen wird bei Textausgabe als Zeilenwechsel ausgegeben, per Default 
 Dokumentenknoten. Hilfsvariable, um einen Kontext in kontextlose Funktionen und Templates zu transportieren. Dieses Template ist ein Wrapper für intern:internals.logging.Output für ein einfaches Logging. Viele Template-Parameter sind mit den Werten der Stylesheet-Parameter oder mit Werten von XPath-Funktionen vorbelegt, um die Benutzung zu vereinfachen. 0.36 2009-08-02 Stf Status: beta initiale Version siehe intern:internals.logging.Output#log-entry.preText Default: leer siehe intern:internals.logging.Output#log-entry.ID Default: leer siehe intern:internals.logging.Output#log-entry.timeStamp Default: current-dateTime() siehe intern:internals.logging.Output#log-entry.processedFile Default: document-uri(/) siehe intern:internals.logging.Output#log-entry.level Default: ALL siehe intern:internals.logging.Output#log-entry.text Default: leer siehe intern:internals.logging.Output#log-entry.category Default: leer siehe intern:internals.logging.Output#log-entry.postText Default: leer siehe intern:internals.logging.Output#log-entry.linebreak-string Default: $internals.logging.linebreak-string siehe intern:internals.logging.Output#log-entry.write-to-console Default: $_internals.logging.write-to-console siehe intern:internals.logging.Output#log-entry.write-to-file Default: $_internals.logging.write-to-file siehe intern:internals.logging.Output#log-entry.write-to-file-as-comment Default: $_internals.logging.write-to-file-as-comment siehe intern:internals.logging.Output#log-entry.write-to-file-as-element Default: $_internals.logging.write-to-file-as-element siehe intern:internals.logging.Output#log-entry.write-to-file-as-html Default: $_internals.logging.write-to-file-as-html siehe intern:internals.logging.Output#log-entry.write-to-file-as-text Default: $_internals.logging.write-to-file-as-text siehe intern:internals.logging.Output#log-entry.write-preText Default: false() siehe intern:internals.logging.Output#log-entry.write-ID Default: false() siehe intern:internals.logging.Output#log-entry.write-timeStamp Default: false() siehe intern:internals.logging.Output#log-entry.write-processedFile Default: false() siehe intern:internals.logging.Output#log-entry.write-level Default: true() siehe intern:internals.logging.Output#log-entry.write-text Default: true() siehe intern:internals.logging.Output#log-entry.write-category Default: false() siehe intern:internals.logging.Output#log-entry.write-postText Default: false() ALL Dieses Template gibt eine einfache Fehlermeldung aus. Ausgabeart und -ziel werden über die Stylesheet-Parameter bestimmt, wenn keine expliziten Einstellungen übergeben werden. Es ist ein Wrapper mit sinvollen Vorgabewerten für das Template xsb:internals.Logging. Außerdem sorgt es dafür, dass bei Fehlern der Stufen ERROR (wenn mit $internals.errors.die-on-critical-errors erlaubt) und FATAL die Verarbeitung des Stylesheets abgebrochen wird. 0.36 2009-08-02 Stf Status: beta initiale Version Fehlermeldung Level der Fehlermeldung. In Anlehnung an Log4j werden per Vorgabe die Stufen »ALL« > »TRACE« > »DEBUG« > »INFO« > »WARN« > »ERROR« > »FATAL« (in aufsteigender Reihenfolge der Dringlichkeit) verwendet. Default: »ALL«. Aufrufende(s) Funktion/Template, z.B. xsb:get-context-as-string() Falls true(), wird zum Kontextkonten der Kontext angezeigt. Achtung! Das schlägt fehl, wenn es keinen Kontextknoten gibt, z.B. innerhalb von Funktionen oder innerhalb von xsl:for-each-Schleifen über dokumentenexterne Sequenzen. Deshalb gibt es auch ein Template xsb:internals.FunctionError, das dieses Problem umgeht. Falls true(), wird die Ausgabe in die Datei geschrieben. Standardwert: $_internals.logging.write-to-file. In bestimmten Umgebungen, z.B. innerhalb einer Funktion, darf das Template keinen Rückgabewert liefern (siehe deshalb auch xsb:internals.FunctionError). Über diesen Parameter kan der stylesheet-weite Standardwert überschrieben werden. ALL Verarbeitung abgebrochen Dieses Template gibt eine einfache Fehlermeldung aus. Es ist ein Wrapper für xsb:internals.Error, der die Rückgabe von Werten durch das Template unterbindet (was innerhalb von Funktionen in der Regel unerwünscht ist und ggfs. zu Fehlern führen kann). Achtung! Dadurch werden keine Meldungen (als Kommentar, Text, HTML, XML) in Ausgabedateien geschrieben! 0.59 2009-10-26 Stf Status: beta initiale Version Fehlermeldung Level der Fehlermeldung. In Anlehnung an Log4j werden per Vorgabe die Stufen »ALL« > »TRACE« > »DEBUG« > »INFO« > »WARN« > »ERROR« > »FATAL« (in aufsteigender Reihenfolge der Dringlichkeit) verwendet. Default: »ALL«. Aufrufende(s) Funktion/Template, z.B. xsb:get-context-as-string() ALL Dieses Template gibt eine Fehlermeldung bei Fehlern in der Logik der XSL-SB aus. Da das Ausführungsverhalten in solchen Situationen nicht vorhersehbar ist, wird die Verarbeitung abgebrochen. Dieses Template ist ein Wrapper für xsb:internals.Error, der die Rückgabe von Werten durch das Template unterbindet (was innerhalb von Funktionen in der Regel unerwünscht ist und ggfs. zu Fehlern führen kann). Achtung! Dadurch werden keine Meldungen (als Kommentar, Text, HTML, XML) in Ausgabedateien geschrieben! 0.2.35 2011-06-26 Stf Status: beta initiale Version Fehler-Codenummer Aufrufende(s) Funktion/Template, z.B. xsb:get-context-as-string() Uups, das hätte nicht passieren dürfen :-(. Fataler Fehler innerhalb der XSLT-SB, Verarbeitung wurde abgebrochen () Dieses Template erzeugt bei der Ausgabe in eine Datei den Dateikopf, z.B. das Wurzelelement in XML oder Wurzel und Head in HTML. Genaugenommen verteilt das Template nur entsprechend des Ausgabeformates auf Untertemplates wie intern:internals.logging.MakeHeader.element und intern:internals.logging.MakeHeader.html. 0.139 2011-04-24 Stf Status: alpha initiale Version Dieses Template erzeugt bei der Ausgabe in eine Datei den Fuß, z.B. das schließende HTML-Tag oder XML-Element. Genaugenommen verteilt das Template nur entsprechend des Ausgabeformates auf Untertemplates wie intern:internals.logging.MakeFooter.element und intern:internals.logging.MakeFooter.html. Hook: kann zum Umformatieren überschrieben werden. 0.139 2011-04-24 Stf Status: alpha initiale Version Logging-Level, mit dem die Ausgabe erfolgt. Default: "DEBUG" Dieses Template gibt die Werte der Funktion system-property() für die im XSLT-Standard vorgegebenen Parameter vgl. http://www.w3.org/TR/xslt20/#function-system-property aus. 0.36 2009-08-02 Stf Status: beta initiale Version DEBUG Laufzeitumgebung: Datei: current-date(): current-time(): os.name: os.version: xsl:version: xsl:vendor: xsl:vendor-url: xsl:product-name: xsl:product-version: xsl:is-schema-aware: xsl:supports-serialization: xsl:supports-backwards-compatibility: xsb:java-available: xsb:vendor-hash: Zu Beginn der Verarbeitung von internals.xsl (und damit von allen Stylesheets, die internals.xsl einbinden), sind ein paar Parameter für das Logging noch nicht gesetzt. Um trotzdem eine Fehlermeldung zu ermöglichen (beispielsweise bei der Prüfung von Stylesheet-Parametern), wird im diesen Template eine Fehlermeldung unter Verzicht aus betroffene Parameter auf der Konsole ausgegeben. Das Template ist ein Wrapper für das Template xsb:internals.Logging und hat die selbe Signatur wie xsb:internals.Error. Achtung! Im Unterschied zu xsb:internals.Error wird bei ERROR in jedem Fall abgebrochen, d.h. der Parameter $internals.errors.die-on-critical-errors beinflusst dieses Template nicht. 0.60 2009-11-01 Stf Status: beta initiale Version siehe xsb:internals.Error siehe xsb:internals.Error siehe xsb:internals.Error siehe xsb:internals.Error siehe xsb:internals.Error Achtung! Dieser Parameter wird nur empfangen, um die Signatur von xsb:internals.Error zu erhalten, er wird aber nicht ausgewertet, d.h. es wird nie in die Ausgabedatei geschrieben. ALL : Verarbeitung abgebrochen Kontextknoten vom Typ node(), kann also vom Typ element(), attribute(), text(), comment() usw. sein Diese Funktion erzeugt aus dem Kontext eines Knotens und dessen Elternknoten einen String in Form eines XPath-Ausdruckes, der diesen Knoten beschreibt. Kann z.B. zur Erläuterung bei Fehlermeldungen eingesetzt werden. 0.36 2009-08-02 Stf Status: beta initiale Version // / // Kontextknoten vom Typ node(), kann also vom Typ element(), attribute(), text(), comment() usw. sein Diese Funktion erzeugt aus dem Kontext eines Knotens einen String in Form eines XPath-Ausdruckes, der diesen Knoten beschreibt. Kann z.B. zur Erläuterung bei Fehlermeldungen eingesetzt werden. 0.36 2009-08-02 Stf Status: beta initiale Version document-node() [ ( @ =" " ) and ] text() @[. =""] comment() processing-instruction() namespace:: xsb:render-context-as-string() ERROR keine Anzeigemöglichkeit für Kontext-Art Eingabe (String) (Boolean) Erzeugt eine Fehlermeldung, wenn der eingegebene String nicht in der Liste der gültigen Werte enthalten ist. Diese Funktion wandelt eine String-Eingabe in einen Boolean-Wert um. Sie kennt dabei mehr Begriffe als boolean(), z.B. »ja«/»nein«. 0.36 2009-08-02 Stf Status: beta initiale Version xsb:parse-string-to-boolean Ungültiger Wert für "$input" (»«) übergeben, false() als Ergebnis zurückgegeben. WARN Eingabe (String) Shortcut für xsb:parse-string-to-boolean($input, true()). 0.36 2009-08-02 Stf Status: beta initiale Version Eingabe (String) Erzeugt zu den verbalen Fehlerwerten »ALL« > »TRACE« > »DEBUG« > »INFO« > »WARN« > »ERROR« > »FATAL« einen String, der bei xsb:internals.Error und verwandten Templates als preText verwendet werden kann. Wird ein ungültiger Wert übergeben, wird der Wert für ALL gewählt. 0.60 2009-11-01 Stf Status: beta initiale Version Eingabe (ohne Typ) Eingabe (ohne Typ) Diese Funktion vergleicht zwei beliebig getypte Werte und gibt bei Idendität true() zurück, d.h. der Vergleich ist eine Kombination aus eq und deep-equal() mit höherer Empfindlichkeit und einigen Sonderfällen. Im Unterschied zum XPath-Operator is können auch atomic values verglichen werden. Sind die Eingabewerte nicht vom gleichen Typ, ist das Ergebnis false(). Werden -0.0e0 und +0.0e0 verglichen, und unterstützt der jeweilie Typ diesen Unterschied, ist das Ergebnis false(). Werden NaN und NaN verglichen, ist das Ergebnis true(). Werden zwei Leersequenzen verglichen, ist das Ergebnis true(). 0.2.37 2011-06-26 Stf Status: alpha Bugfix für "NaN" unter AltovaXML (bis einschließlich 2011 sp 3) eingefügt 0.2.34 2011-06-26 Stf Status: alpha Unterscheidung von -0.0e0 und +0.0e0 eingefügt 0.139 2011-04-24 Stf Status: alpha explizite Behandlung für Leersequenzen eingefügt 0.61 2009-11-16 Stf Status: beta initiale Version Eingabeknoten Erzeugt eine Fehlermeldung, wenn für den eingegebenen Knoten keine gültige Art ermittelt werden kann. Da die Tests vollständig sind, dürfet dieser Fehler nie auftreten. Diese Funktion ermittelt die Art eines node(), d.h. sie gibt je nach übergebenen Knoten einen der Werte »document-node«, »element«, »attribute«, »text«, »comment«, »processing-instruction« oder »namespace« zurück. Schlagen all Versuche zur Ermittlung fehl, wird der Wert #undefined zurückgegeben (Mir ist kein entsprechender Input-node() bekannt). Diese Funktion ist eine Implementierung des dm:node-kind-Accessors aus dem XQuery 1.0 and XPath 2.0 Data Model (XDM). 0.61 2009-11-16 Stf Status: beta initiale Version document-node element attribute text comment processing-instruction namespace #undefined xsb:node-kind Ungültiger Wert für "$context" übergeben, "#undefined" als Ergebnis zurückgegeben. ERROR Eingabeknoten (ohne Typ) Shortcut für xsb:node-kind($context, true()) 0.61 2009-11-16 Stf Status: beta initiale Version s Eingabeknoten (ohne Typ) Erzeugt eine Fehlermeldung, wenn der eingegebenen String nicht »ALL« > »TRACE« > »DEBUG« > »INFO« > »WARN« > »ERROR« > »FATAL« ist. Diese Funktion wandelt die verbalen Logging-Level »ALL« > »TRACE« > »DEBUG« > »INFO« > »WARN« > »ERROR« > »FATAL« in korrspondierende Integer-Werte von 0 bis 6 um. Bei einer ungültigen Eingabe wird »4« (entspricht »WARN«) zurückgegeben. 0.114 2010-07-16 Stf Status: beta initiale Version xsb:logging-level WARN Ungültige Eingabe: »«, statt dessen »4« (entspricht »WARN«) zurückgegeben. Eingabeknoten (ohne Typ) Shortcut für xsb:logging-level($verbal-logging-level, true() ). 0.114 2010-07-16 Stf Status: beta initiale Version Wert der entsprechenden System-Eigenschaft (String) Wert der entsprechenden System-Eigenschaft (String) Wert der entsprechenden System-Eigenschaft (Boolean) (Boolean)Wert der entsprechenden System-Eigenschaft (muss ggfs. von String umgewandelt werden, etwa mit xsb:parse-string-to-boolean()) Erzeugt eine Fehlermeldung, wenn der eingegebene String nicht in der Liste der gültigen Werte enthalten ist. (Boolean) Diese Funktion ermittelt aus den übergebenen System-Parameter einen Hashwert, der z.B. für Vergleiche verwendet werden kann 0.141 2011-04-25 Stf Status: alpha initiale Version Saxon-PE_9.3 Saxon-EE_9.3 Saxon-HE_9.3 Saxon-HE_9.4 Saxon-PE_9.2 Saxon-HE_9.2 Saxon-EE_9.2 Saxon-B_9.1 AltovaXML_CE_2012.2 AltovaXML_CE_2012.2 AltovaXML_CE_2012.sp1 AltovaXML_CE_2011.2sp1 AltovaXML_CE_2010.3sp1 xsb:vendor-hash() WARN xsb:vendor-hash() konnte nicht ermittelt werden, "FEHLER" zurückgegeben Wert der entsprechenden System-Eigenschaft (String) Wert der entsprechenden System-Eigenschaft (String) Wert der entsprechenden System-Eigenschaft (Boolean) (Boolean)Wert der entsprechenden System-Eigenschaft (muss ggfs. von String umgewandelt werden, etwa mit xsb:parse-string-to-boolean()) Erzeugt eine Fehlermeldung, wenn der eingegebene String nicht in der Liste der gültigen Werte enthalten ist. (Boolean) Shortcut für xsb:vendor-hash($product-name, $product-version, $java-available, true()). 0.141 2011-04-25 Stf Status: alpha initiale Version Diese Funktion ermittelt – zusammen mit der folgenden – ob Java auf dem ausführenden System zur Verfügung steht. 0.141 2011-04-25 Stf Status: alpha initiale Version Diese Funktion ermittelt – zusammen mit der vorhergehenden – ob Java auf dem ausführenden System zur Verfügung steht. 0.141 2011-04-25 Stf Status: alpha initiale Version Diese Funktion ermittelt den Vendor-Hash für das aktuelle System. 0.141 2011-04-25 Stf Status: alpha initiale Version Eingabeknoten (ohne Typ) Erzeugt eine Fehlermeldung, wenn der Typ nicht ermittelt werden kann. Da die Tests vollständig sind und zumindest xs:untypedAtomic immer das Ergebnis sein sollte, dürfet dieser Fehler nie auftreten. ermittelt den Typ eines Atomic Values Dazu wird das Argument mit einer Reihe von instance of … geprüft. Geprüft werden diejenigen Typen, die ein Basic-XSLT-Prozessor laut XSLT-Standard unterstützen muss (vgl. 3.13 Built-in Types). Das sind xs:double, xs:decimal, xs:integer, xs:float, xs:dateTime, xs:date, xs:time, xs:boolean, xs:yearMonthDuration, xs:dayTimeDuration, xs:duration, xs:string, xs:QName, xs:anyURI, xs:gYearMonth, xs:gMonthDay, xs:gYear, xs:gMonth, xs:gDay, xs:base64Binary, xs:hexBinary, xs:untypedAtomic und xs:anyAtomicType. Achtung: Die XSLT-Prozessor-Hersteller sind nicht verpflichtet, intern den jeweils »richtigen« Typ zu verwenden, $arg kann auch von einem beliebigen Subtyp sein (vgl. hier). 0.2.25 2011-05-29 Stf Status: alpha initiale Version xs:double xs:integer xs:decimal xs:float xs:dateTime xs:date xs:time xs:boolean xs:yearMonthDuration xs:dayTimeDuration xs:duration xs:string xs:QName xs:anyURI xs:gYearMonth xs:gMonthDay xs:gYear xs:gMonth xs:gDay xs:base64Binary xs:hexBinary xs:untypedAtomic xs:anyAtomicType xsb:type-annotation Typ des Argumentes konnte nicht ermittelt werden, "#undefined" als Ergebnis zurückgegeben. ERROR Eingabeknoten (ohne Typ) Shortcut für xsb:type-annotation($arg, true() ) 0.2.25 2011-05-29 Stf Status: alpha initiale Version Eingabeknoten (ohne Typ) Typ, auf den gecastet werden soll wandelt einen Atomic Value beliebigen Types in einen Atomic Value mit Typ entsprechend dem Parameter "as" um Unterstützt werden diejenigen Typen, die ein Basic-XSLT-Prozessor laut XSLT-Standard unterstützen muss (vgl. 3.13 Built-in Types): xs:double, xs:decimal, xs:integer, xs:float, xs:dateTime, xs:date, xs:time, xs:boolean, xs:yearMonthDuration, xs:dayTimeDuration, xs:duration, xs:string, xs:QName, xs:anyURI, xs:gYearMonth, xs:gMonthDay, xs:gYear, xs:gMonth, xs:gDay, xs:base64Binary, xs:hexBinary, xs:untypedAtomic mit Ausnahme von xs:anyAtomicType (weil ein Cast dahin nicht möglich ist). Laut Standard kann nicht auf xs:QName gecastet werden, da dieser Cast ein statisches String Literal erfordert und deshalb nicht mit dynamisch zu evaluierenden Variablen bzw. Parametern funktioniert. Details siehe im XPath-Standard, Punkt 4.a., und err:XPTY0004. 0.2.25 2011-05-29 Stf Status: alpha initiale Version xsb:cast [err:XPTY0004] ein Cast auf xs:QName ist nur mit einem String _Literal_ als Argument zulässig, nicht mit einer dynamisch zu evaluierenden Variablen, vgl. http://www.w3.org/TR/xpath20/#id-cast, Nr. 4.a. ERROR xsb:cast Typ »« wird nicht unterstützt. ERROR