Package eu.bandm.tools.xslt.base

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

See: Description

Class Summary

Class	Description
Application<N>	Each instance of this class realizes the application of an xslt program, given as a Transformation, to a certain input.
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.
ElementMap	Auxiliary type for tdom models, which maps namespace names of DTD elements to implementing java classes and to parsing methods.
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.PCDataOnlyVisitor	Calls MultiTypeNodeList.PCDataOnlyVisitor.action(String) on all contained character data.
Options	Generated source for command line processing.
PathMap	Encoding of the target language parse automaton as states and relations.
ResultContext	Convenience class for accessing all data which depends on the target DTD and is required for xslt parsing and execution.
Rt	Created on 2022-06-25_16h56m36 by program bandm/metatools/umod, version 0.17 command line = 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.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.
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.
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].

Enum Summary

Enum	Description
ElementMap.group
MultiTypeNodeList.frequency	The static info, how often a MixedContentContainer must be evaluated.
Options.traceflag	This enum type indicates: Switch on/off different trace outputs individually.
TPathCache.sensitivity	This value is ONLY related to the current-node-(list)-context, not to referred variables & functions!
Transformation.NumberLevel

Exception Summary

Exception	Description
Application.UserInterruptionException

Package eu.bandm.tools.xslt.base Description

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 = eu.bandm.tools.xslt.base.MultiTypedNodeLists.
• 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)