EclipseXSLT - XSLT Support for Eclipse » Usage » XSLT processor preferences
XSLT processor preferencesXPATH Navigator

4.5.1.  Add a new XSLT processor

Orangevolt EclipseXSLT provides and Eclipse extension point to plugin a xslt processors.

As you might guess, dear reader, the 3 provided XSLT transformers use also the Eclipse extension point to introduce themself. To go indepth with how to plugin a new XSLT transformer see the other transformer declarations in the Orangevolt plugins (especially the com.orangevolt.eclipse.xslt.saxon fragment).

To add roll your own XSLT processor for Orangevolt Eclipse XSLT simply create an eclipse fragment and define transformer class, needed class libraries, output properties and features.

Lets take the Saxon transformer definition as an example:

<?xml version="1.0" encoding="UTF-8"?>
<?eclipse version="3.0"?>
  <!-- start descriptions -->
<!DOCTYPE fragment [  
  <!ENTITY saxon.output_property.cdata_section_elements 'specifies a whitespace delimited list of the names of elements whose text node children should be output using CDATA sections'>
  <!ENTITY saxon.output_property.doctype_public 'see the documentation for the DOCTYPE_SYSTEM property for a description of what the value of the key should be'>
  <!ENTITY saxon.output_property.doctype_system 'specifies the public identifier to be used in the document type declaration'>
  <!ENTITY saxon.output_property.encoding 'specifies the preferred character encoding that the Transformer should use to encode sequences of characters as sequences of bytes'>
  <!ENTITY saxon.output_property.indent 'specifies whether the Transformer may add additional whitespace when outputting the result tree; the value must be yes or no'>
10    <!ENTITY saxon.output_property.media_type 'specifies the media type (MIME content type) of the data that results from outputting the result tree. The charset parameter should not be specified explicitly; instead, when the top-level media type is text, a charset parameter should be added according to the character encoding actually used by the output method'>
11    <!ENTITY saxon.output_property.method '(xml | html | text | [expanded name]) the method attribute identifies the overall method that should be used for outputting the result tree'>
12    <!ENTITY saxon.output_property.omit_xml_declaration 'specifies whether the XSLT processor should output an XML declaration; the value must be yes or no'>
13    <!ENTITY saxon.output_property.standalone 'specifies whether the Transformer should output a standalone document declaration; the value must be yes or no'>
14    <!ENTITY saxon.output_property.version 'specifies the version of the output method'>
15    <!ENTITY saxon.output_property.indent_spaces '(integer value).Defines the number of spaces used for indentation of output'>
16    <!ENTITY saxon.output_property.use_character_maps '(list-of-qnames)Defines the character maps used in this output definition. The QNames are represented in Clark notation as {uri}local-name.'>
17    <!ENTITY saxon.output_property.include_content_type 'include-content-type = "yes" | "no". This attribute is defined in XSLT 2.0. Indicates whether the META tag is to be added to HTML output.'>
18    <!ENTITY saxon.output_property.undeclare_namespaces 'include-content-type = "yes" | "no". This attribute is defined in XSLT 2.0. Indicates XML 1.1 namespace declarations are to be output.'>
19    <!ENTITY saxon.output_property.escape_uri_attributes 'escape-uri-attributes = "yes" | "no". This attribute is defined in XSLT 2.0. Indicates whether HTML attributes of type URI are to be URI-escaped.'>
20    <!ENTITY saxon.output_property.character_representation '(rep1[;rep2]). Indicates the preferred way of representing non-ASCII characters in HTML and XML output. rep1 is for characters in the range 128-256, rep2 for those above 256.'>
21    <!ENTITY saxon.output_property.next_in_chain '(uri). Indicates that the output is to be piped into another XSLT stylesheet to perform another transformation. The auxiliary property NEXT_IN_CHAIN_BASE_URI records the base URI of the stylesheet element where this attribute was found.'>
22    <!ENTITY saxon.output_property.type_information '(none|preserve|strict|lax). Indicates the value of the type-information attribute: "none", "preserve", "strict", "lax"'>
23    <!ENTITY saxon.output_property.byte_order_mark '(yes|no). Indicates whether UTF-8/UTF-16 output is to start with a byte order mark. Values are "yes" or "no", default is "no".'>
24    <!ENTITY saxon.output_property.require_well_formed '(yes|no). Indicates whether a user-supplied ContentHandler requires the stream of SAX events to be well-formed (that is, to have a single element node and no text nodes as children of the root). The default is "no".'>
26    <!ENTITY saxon.feature.allow_external_functions 'true if the stylesheet allows external functions to be called. Default is true. The setting false is recommended in an environment where untrusted stylesheets may be executed. Setting this value to false also disables user-defined extension elements, together with the writing of multiple output files, all of which carry similar security risks.'>
27    <!ENTITY saxon.feature.trace_external_functions 'true if the tracing of calls to external Java methods is required. Default is false. This switch is useful when analyzing why Saxon fails to find a Java method to match an extension function call in the stylesheet, or why it chooses one method over another when several are available. The trace output is sent to System.err.'>
28    <!ENTITY saxon.feature.timing 'true if basic timing information is to be output to the standard error output stream.'>
29    <!ENTITY saxon.feature.tree_model 'Builder.STANDARD_TREE or Builder.TINY_TREE. Selects an implementation of the Saxon tree model. The default is Builder.TINY_TREE.'>
30    <!ENTITY saxon.feature.trace_listener 'an instance of the class net.sf.saxon.trace.TraceListener. This object will be notified of significant events occurring during the transformation, for tracing or debugging purposes.'>
31    <!ENTITY saxon.feature.line_numbering 'indicates whether line numbers are to be maintained for the source document. This will not be possible if the source document is supplied as a DOM. The line numbers are accessible through the tracing interface, and also via the saxon:line-number() extension function.'>
32    <!ENTITY saxon.feature.recovery_policy 'An Integer. Indicates how dynamic errors should be handled. One of the values (defined as constants in the Controller class) RECOVER_SILENTLY, RECOVER_WITH_WARNINGS, or DO_NOT_RECOVER).'>
33    <!ENTITY saxon.feature.message_emitter_class 'The full name of a saxon emitter class. that implements the net.sf.saxon.output.Emitter interface; the class will be used to format the output of the xsl:message instruction.'>
34    <!ENTITY saxon.feature.source_parser_class 'The full name of a class that implements the org.xml.sax.XMLReader interface; the class will be used to parse source documents (that is, the principal source document plus any secondary source documents read using the document() function)'>
35    <!ENTITY saxon.feature.style_parser_class 'The full name of a class that implements the org.xml.sax.XMLReader interface; the class will be used to parse stylesheet documents (that is, the principal stylesheet module plus any secondary source documents read using xsl:include or xsl:import)'>
36    <!ENTITY saxon.feature.uri_output_resolver 'An instance of the class net.sf.saxon.OutputURIResolver; this object will be used to resolve URIs of secondary result documents specified in the href attribute of the xsl:result-document instruction'>
37    <!ENTITY saxon.feature.dtd_validation 'Indicates whether the XML parser should be asked to validate source documents against their DTD. This applies to the initial source document and any source documents read using the document() function, unless handled by a user-written URIResolver.'>
38    <!ENTITY saxon.feature.validation_warnings 'This determines whether validation errors in result documents should be treated as fatal. By default they are fatal; with this option set, they are treated as warnings.'>
39    <!ENTITY saxon.feature.schema_validation '(boolean) This determines whether source documents should be parsed with schema-validation enabled.'>
40    <!ENTITY saxon.feature.version_warning 'This determines whether a warning should be output when running an XSLT 2.0 processor against an XSLT 1.0 stylesheet. The XSLT specification requires this to be done by default.'>
41    <!ENTITY saxon.feature.name_pool 'A instance of class Indicates that the supplied NamePool should be used as the target (run-time) NamePool by all stylesheets compiled (using newTemplates()) after this call on setAttribute. Normally a single system-allocated NamePool is used for all stylesheets compiled while the Java VM remains loaded; this attribute allows user control over the allocation of NamePools. Note that source trees used as input to a transformation must be built using the same NamePool that is used when the stylesheet is compiled: this will happen automatically if the input to a transformation is supplied as a SAXSource or StreamSource but it is under user control if you build the source tree yourself.'>  
42  ]>
43    <!-- end descriptions -->
44  <fragment>
45    <extension point="com.orangevolt.eclipse.xslt.transformer">
46      <transformer
47        name="Saxon-B 8.9"
48        class="net.sf.saxon.TransformerFactoryImpl"
49        classpath="lib/saxon*.jar">
50        <description>
51    Saxon-B 8.9. - the Open Source SAXON XSLT processor developed by Michael Kay
52        </description>
53        <output-properties>
54          <output-property name="CDATA_SECTION_ELEMENTS" key="cdata-section-elements">&saxon.output_property.cdata_section_elements;</output-property>
55          <output-property name="DOCTYPE_PUBLIC" key="doctype-public">&saxon.output_property.doctype_public;</output-property>
56          <output-property name="DOCTYPE_SYSTEM" key="doctype-system">&saxon.output_property.doctype_system;</output-property>
57          <output-property name="ENCODING" key="encoding">&saxon.output_property.encoding;</output-property>
58          <output-property name="INDENT" key="indent" default="yes">&saxon.output_property.indent;</output-property>
59          <output-property name="MEDIA_TYPE" key="media-type">&saxon.output_property.media_type;</output-property>
60          <output-property name="METHOD" key="method">&saxon.output_property.method;</output-property>
61          <output-property name="OMIT_XML_DECLARATION" key="omit-xml-declaration">&saxon.output_property.omit_xml_declaration;</output-property>
62          <output-property name="STANDALONE" key="standalone">&saxon.output_property.standalone;</output-property>
63          <output-property name="VERSION" key="version">&saxon.output_property.version;</output-property>
64          <output-property name="INDENT_SPACES" key="{}indent-spaces" default="4">&saxon.output_property.indent_spaces;</output-property>
65          <output-property name="USE_CHARACTER_MAPS" key="{}use-character-maps">&saxon.output_property.use_character_maps;</output-property>
66          <output-property name="INCLUDE_CONTENT_TYPE" key="{}include-content-type">&saxon.output_property.include_content_type;</output-property>
67          <output-property name="UNDECLARE_NAMESPACES" key="{}undeclare-namespaces">&saxon.output_property.undeclare_namespaces;</output-property>
68          <output-property name="ESCAPE_URI_ATTRIBUTES" key="{}escape-uri-attibutes">&saxon.output_property.escape_uri_attributes;</output-property>
69          <output-property name="CHARACTER_REPRESENTATION" key="{}character-representation">&saxon.output_property.character_representation;</output-property>
70          <output-property name="NEXT_IN_CHAIN" key="{}next-in-chain">&saxon.output_property.next_in_chain;</output-property>
71          <output-property name="TYPE_INFORMATION" key="{}type-information">&saxon.output_property.type_information;</output-property>
72          <output-property name="BYTE_ORDER_MARK" key="{}byte-order-mark">&saxon.output_property.byte_order_mark;</output-property>
73          <output-property name="REQUIRE_WELL_FORMED" key="{}require-well-formed">&saxon.output_property.require_well_formed;</output-property>
74        </output-properties>
75        <features>
76          <feature name="ALLOW_EXTERNAL_FUNCTIONS" type="boolean" key="">&saxon.feature.allow_external_functions;</feature>
77          <feature name="TRACE_EXTERNAL_FUNCTIONS" type="boolean" key="">&saxon.feature.trace_external_functions;</feature>
78          <feature name="TIMING" type="boolean" key="">&saxon.feature.timing;</feature>
79          <feature name="TREE_MODEL" type="int" key="">&saxon.feature.tree_model;</feature>
80          <feature name="TRACE_LISTENER" type="object" key="">&saxon.feature.trace_listener;</feature>
81          <feature name="LINE_NUMBERING" type="boolean" key="">&saxon.feature.line_numbering;</feature>
82          <feature name="RECOVERY_POLICY" type="int" key="">&saxon.feature.recovery_policy;</feature>
83          <feature name="MESSAGE_EMITTER_CLASS" type="class" key="">&saxon.feature.message_emitter_class;</feature>
84          <feature name="SOURCE_PARSER_CLASS" type="class" key="">&saxon.feature.source_parser_class;</feature>
85          <feature name="STYLE_PARSER_CLASS" type="class" key="">&saxon.feature.style_parser_class;</feature>
86          <feature name="OUTPUT_URI_RESOLVER" type="object" key="">&saxon.feature.uri_output_resolver;</feature>
87          <feature name="DTD_VALIDATION" type="boolean" key="">&saxon.feature.dtd_validation;</feature>
88          <feature name="VALIDATION_WARNINGS" type="boolean" key="">&saxon.feature.validation_warnings;</feature>
89          <feature name="SCHEMA_VALIDATION" type="boolean" key="">&saxon.feature.schema_validation;</feature>
90          <feature name="VERSION_WARNING" type="boolean" key="">&saxon.feature.version_warning;</feature>
91          <feature name="NAME_POOL" type="object" key="">&saxon.feature.name_pool;</feature>
92        </features>
93      </transformer>
94    </extension>
95  </fragment>