Package eu.bandm.tools.d2d2.base

Class Def2Xslt

java.lang.Object

eu.bandm.tools.d2d2.model.MATCH_ONLY_00

eu.bandm.tools.d2d2.model.SinglePhase

eu.bandm.tools.d2d2.base.Navigate.VisitReachable<Object>

eu.bandm.tools.d2d2.base.Def2Xslt

public class Def2Xslt
extends Navigate.VisitReachable<Object>

Implements the extraction of all xslt rules for all definitions in a given module into the given target format. This is achieved by constructing an instance of this class (always anew, no re-usage) and then calling extract(Module,Module,String,String,XMLDocumentIdentifier,LocationMap,String,PrintWriter).

When parsing any d2d-encoded xslt source, namespace declarations. i.e. mappings from prefix to nsUri, are relevant in three(3) different concerns, and (luckily) non-relevant in some others:

• The element structure of the d2d-encoded xslt source is parsed from d2d-tags, which are (possibly context sensitive) wordings, not including any namespace information. These yield elements, which in turn may have a namspaceUri in their xml encoding. This holds for both xslt elements and target elements. It holds for target formats given by a ddf or by a dtd (in that case the Dtd2ddf collects the namespace declarations by the tdom-pi, resolves the prefices into nsUris of the generated Definition and strips them.) The target model definition must be addressable by the normal d2d Module finding. The d2d xslt source identifies the top-level target model in its headline "d2d xslt producing XY".
• In case of explicitly written, stand alone xslt files, the input xml model is present only in "match" patterns of templates, and in all xpath expressions in attributes of xslt elements and in attribute templates of some xslt elements and all result elements. The namespaces of the input model can NOT be derived from the d2d-data, and the prefix-nsUri-relation must be THE SAME as written/meant in the source text in the expressions. Since these are not analysed here, and thus no re-mapping of the prefices is possible, this relation must (a) be declared manually, by a "from"-declaration, must (b) be taken over to the resulting xslt model verbatim, and (c) must not conflict with any other declaration of this kind.
• In case of an xslt source *extracted* from a "docu_to[]" entry in the d2d Module, the input model namespace uris are known, and the prefix COULD be re-mapped for the automatically generated top-level "xsl.template match='...'" attributes. BUT this does not hold for other xpath expressions written explicitly by the user in xslt attributes or result attribute templates, as described for the preceding case.
• The same holds for third-party documents, inquired explicitly, eg. by xpath:"document(...)", with different nsUris internally.
• The declarations of the input document in this "extracted" case are contained completely in the currently processed d2d Module and all its imported modules. For these, "from" namespace declarations are added automatically, by this code. The declaration of the target model is completely defined when resolving the key part of the "docu_to_[key]" into a d2d Module and will be identified by the generated headline.
• All third-party ns mappings must be defined explicitly in the former! HOW ???? FIXME

The "meta" module will be extracted to the same target format, iff it is provided as an parameter.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected class	Def2Xslt.CollectNs	Visit all reachable modules and store their namespace declarations.

Field Summary

Fields

Modifier and Type	Field	Description
protected Set<String>	defsVisited
protected XMLDocumentIdentifier	generatedDoc
protected int	linenumber
protected Module	mod
protected Set<String>	moduleCodes
protected Set<Module>	modulesVisited
protected MessageTee<SimpleMessage<XMLDocumentIdentifier>>	msg
protected MessageCounter	msg_c
(package private) final Map<String,Module>	namespaceOrig
(package private) final Map<String,String>	namespaces
protected PrintWriter	printwriter
protected int	rulecount
protected LocationMap<XMLDocumentIdentifier,XMLDocumentIdentifier>	stringpos2orig
protected String	target
protected Set<String>	written
protected String	xtarget

Fields inherited from class eu.bandm.tools.d2d2.base.Navigate.VisitReachable

done, result, todo

Fields inherited from class eu.bandm.tools.d2d2.model.MATCH_ONLY_00

_visitor_debug_stream, partial

Constructor Summary

Constructors

Constructor	Description
Def2Xslt(MessageReceiver<SimpleMessage<XMLDocumentIdentifier>> msg)

Method Summary

Modifier and Type	Method	Description
void	action(Definition def)
void	action(Reference ref)
void	extract(Module mod, Module metaModule, String target, String topElement, XMLDocumentIdentifier docid, LocationMap<XMLDocumentIdentifier,XMLDocumentIdentifier> stringpos2orig, String genComment, PrintWriter printwriter)	Entry method for conversion.
protected void	markModule(Module mod)
protected void	output(CheckedList<LocString> docu)
protected void	putSeparator()

Methods inherited from class eu.bandm.tools.d2d2.base.Navigate.VisitReachable

markToDo, markToDo, process, process, processAll, processPublic

Methods inherited from class eu.bandm.tools.d2d2.model.SinglePhase

action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, action, descend_ImportItem$globalSubsts, descend_ImportItem$localSubsts, descend_Module$definitions, descend_Module$imports, descend_Module$modules, descend_TagsRegExp$localdefs

Methods inherited from class eu.bandm.tools.d2d2.model.MATCH_ONLY_00

_visitor_trace, action, action, action, action, compile, descend_Alt$on, descend_Perm$on, descend_Seq$on, foreignObject, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, match, nomatch

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

msg

protected MessageTee<SimpleMessage<XMLDocumentIdentifier>> msg

msg_c

protected MessageCounter msg_c

mod

protected Module mod

target

protected String target

xtarget

protected String xtarget

printwriter

protected PrintWriter printwriter

generatedDoc

protected XMLDocumentIdentifier generatedDoc

linenumber

protected int linenumber

rulecount

protected int rulecount

stringpos2orig

protected LocationMap<XMLDocumentIdentifier,XMLDocumentIdentifier> stringpos2orig

written

protected Set<String> written

modulesVisited

protected Set<Module> modulesVisited

moduleCodes

protected Set<String> moduleCodes

defsVisited

protected Set<String> defsVisited

namespaces

final Map<String,String> namespaces

namespaceOrig

final Map<String,Module> namespaceOrig

Constructor Details

Def2Xslt

public Def2Xslt(MessageReceiver<SimpleMessage<XMLDocumentIdentifier>> msg)

Method Details

extract

public void extract(Module mod,
 Module metaModule,
 String target,
 String topElement,
 XMLDocumentIdentifier docid,
 LocationMap<XMLDocumentIdentifier,XMLDocumentIdentifier> stringpos2orig,
 String genComment,
 PrintWriter printwriter)

Entry method for conversion.

Parameters:

mod - the Module all of its definitions shall be translated

metaModule - optional argument for a second module

target - the name of the target format for filtering rules

topElement - inserted in the "d2d xslt" declaration for later xslt parsing Can be ==null for unstructured targets = non-xml output.

docid - the identifier to identify the generated lines

stringpos2orig - an OUTPUT parameter where to put the relation from generated lines to original lines, for later Location re-translation from error messages.

genComment - generation comment, supplied by the caller, added to the beginning of the ouput (as NON-doc comment).

printwriter - drain for the resulting source text.

putSeparator

protected void putSeparator()

output

protected void output(CheckedList<LocString> docu)

markModule

protected void markModule(Module mod)

action

public void action(Definition def)

Overrides:

action in class SinglePhase

action

public void action(Reference ref)

Overrides:

action in class SinglePhase