Package eu.bandm.tools.xslt.base

package eu.bandm.tools.xslt.base

txsl = typed xslt 1.0 interpreter with "fragmented validation".

Control flow and data structures are as follows:

• Each XSLT source file is realized as a Templates object. (Possibly more than one for more than one application contexts = ResultContext!)
  "Fragmented Validation" is applied when loading the xslt source into a Templates object.
• The application of one particular top-level xslt file to one particular output format is realized by a Transformation.
• For each of these, a TemplateRegistry stores all templates with a "@match" attribute for later efficient matching decisions.
• The run w.r.t. one particular input is realized as an Application.
• The templates are tdom instances of xslt and of the target model, joined by bi-colored nodes = MultiTypeNodeLists.
• CombinedVisitor and CombinedDumper visit these trees transparently.
• The evaluation process is simply to replace all xslt-world elements in these mixed nodes by target-world elements and then reducing the sequence of sub-elements to one target element. This may fail.
• All expressions are cached for optimization: TPathCache for tpath expressions; attributes with embedded "{..}" code in AttributeValueTemplate; all source files and instantiated programs in TemplatesCache and TransformationCache, resp.

Sketch of the overall architecture:

     --> ctrl and data flow / => data flow only
     local and aux classes in (brackets)

         /----------------> tpath.runtime.FunctionLibrary / BuiltinFunctions <==
        /                                                                        \\
     Main -----------> resultContext.newInstance()--------------------->PathMap    \\
       |\\                                                                 //        \\
       | \ \ getTransformation(uri, resultCtx, FunLib,...)               //            ||
       |  \   ------------> TranformationCache  ------> TemplatesCache //              ||
       |   \                     |   |      ^            ^   |       //(validation)    ||
       |    \                    V   |      |(import)    |   V      VV                 ||
       |     \              Transformation--'   (include)| Templates                   ||
       |      |                 ||(Modifiers,XslOutput,  |   | V                       ||  
       |      |                 || XslAttributeSet, Loader,  | MultiTypedNodeList      ||
       |      |                 || ContextChecker)           | | (frequency)           ||
       |      |                 ||   |   |                   | V                       ||
       |      |                 ||   |   |                   | AttributeChecks_valueTemplates
       |      |                 ||   |   |                   V   (extends dtm.AttributeChecks)
       |      |                 ||   |   |                  TPathCache                 ||
       |      |                 ||   |   |                     V                       ||
       |      |                 ||   |   |                     ExprClassified          ||
       |      |                 ||   |   |                       V                     ||
       |      |                 ||   |   |                       AttributeValueTemplate||
       |      |                 ||   V   |                 Templates                   ||
       |      |                 ||   Transformation                                    ||
       |      |                 ||       V                 Templates ...               ||
       |      |                 VV       Transformation ...                            ||
       |      |             TemplateRegistry                                           ||
       |      |new(...)         || (Finder<N>)                                         ||
       |      |execute()        ||                                                    //
       |       \__________      ||                                                  //
       V                   \    ||                                                //
     org.w3c.dom.Document    V  VV                                              // 
     tpath.dom.DOMClient  ==> Application -->BuiltinFunctions.AdditionalContext 
                                 (Binding)
                                   
                                   ||
     org.w3c.dom.Document          VV
     tpath.dom.DOMClient  ==> Application 
                 
                  ...         Application ...
                             /
         (returns)          /
      MultiTypedNodeList <-/
         |
         V
        CombinedDumper
          (prints to file)
  

Class	Description
Application<N>	Each instance of this class realizes the application of an xslt program, given as a Transformation, to a certain input.
Application.UserInterruptionException
AttributeChecks_valueTemplates	This is a refinement necessary for xslt of AttributeChecks.
AttributeValueTemplate	Parses an xslt "attribute value template" into an xpath expression with explicit string operations.
Binding<L,R>	Represents lexical context, i.e mappings from name to value as a linked list.
BuiltInFunctions<N>	Realizes all built-in functions for xslt, including those already defined for xpath.
BuiltInFunctions.AdditionalContext<M>	Container for the application specific values required by the built-in xslt standard function.
CombinedDumper	Descends through an xslt tdom, and dumps the SAX events to some ContentHandler.
CombinedVisitor	Descends through an xslt tdom, and switches automatically to result tree fragment visitation (= MultiTypeNodeList visitation), if those are found as contents of xslt leaf elements (of particular types only!), as indicated by the map CombinedVisitor.subtrees.
ForeignFilter	A ContentHandler which suppresses all top-level elementes which are not from the xslt namespace.
GuiOptions	Generated source of a graphical user interface (GUI) for command line processing.
Main	Command line tool for checking and excuting one single xslt transformations from file to file, internally: a w3c model into a tdom model.
MainGui	COPIED from d2d2/base/MainGui, which is a modified copy from book2.
MessageSender	Common local superclass for different phases of processing; provides methods to send to a MessageReceiver and the Trace control.
MultiTypeNodeList	Holds the contents of one future result element, as long as it is incomplete and the tdom element can not yet be constructed.
MultiTypeNodeList.frequency	The static info, how often a MixedContentContainer must be evaluated.
MultiTypeNodeList.PCDataOnlyVisitor	Calls MultiTypeNodeList.PCDataOnlyVisitor.action(String) on all contained character data.
Options	Generated source for command line processing.
Options.traceflag	This enum type indicates: Switch on/off different trace outputs individually.
PathMap	Encoding of the target language parse automaton as states and relations.
PathMap.MakeDifferent	Rewriter which gives object identity to element references in content models.
PathMap.SingletonObject	Derived from DTM.Singleton, for imposing object identity.
ResultContext	Convenience class for accessing all data which depends on the target DTD and is required for xslt parsing and execution.
Rt	Created on 2024-12-03_12h19m12 by program bandm/metatools/umod, version 0.17 command line = java bandm/metatools/umod --visitordebug false --xmlgen true --getterfunctions true --visitoroptimize false --monolithic true $(HOME)/metatools/src eu.bandm.tools.xslt.base Rt.umod
Rt.__Formatter	(Ancillary class for generating pretty-print format objects).
Rt.__SAX_Parser	Decoder for umod's own XML serialisation.
Rt.__SAX_Writer	Encoder for umod's own XML serialisation.
Rt.Definition
Rt.Dump_rt	Visitor generated by umod according to field selection #0.
Rt.MATCH_ONLY_00	(Ancillary class as basis for all visitors).
Rt.Report
Rt.SinglePhase_rt	Visitor generated by umod according to field selection #0.
Rt.TemplateEntry
Rt.TemplatesByKind
Rt.TemplatesByPrior
TemplateRegistry	Stores and organizes template codes and retrieves the best fitting for a given element.
TemplateRegistry.testKind
TemplateRegistry.XDump
Templates	Represents one single xslt source file, w/o further context info.
TemplatesCache	Caches xslt source files, e.g.
TemplatesCache.LoadResult	Stores error messages and (OPT) the result object of the parsing process.
TPathCache	Maintains a cache for parsing and analyzing xpath/tpath expressions in context of txsl.
TPathCache.ExprClassified	Holds the results of parsing and analysis.
TPathCache.PatternPart	Statistic data on the sub-expressions of the top-level TPath.Union expression.
TPathCache.sensitivity	This value is ONLY related to the current-node-(list)-context, not to referred variables nor functions!
Trace	Control for showing/suppressing different kinds of trace messages.
Transformation	Represents one complete xslt program, which processes any xml input (for which a tpath interpreter exists), and delivers a bandm tdom result of a given type (or just plain text, in case of non-xml mode).
Transformation.Modifiers	Parameters to modify the execution of a Transformation.
Transformation.NumberLevel
TransformationCache	Caches Transformation objects, ie top-level xslt source files for one particular backend.
TransformationCache.LoadResult	Stores error messages and (OPT) the result object of the parsing process.
WsFilter	Skips all whitespace-only textnodes in xslt elements (except xsl:text).
XslNumberFormat	Aux class for parsing and formatting numbers according to the xsl:Element_number conversion parameters, see [XSLT 1.0:7.7.1].