TransformerInstantiationException ClassXML Compare .NET API Documentation
XML Compare .NET API Documentation - DEPRECATED
Thrown to indicate a problem instantiating or configuring an XSLT Transformer.
Inheritance Hierarchy

System Object
  System Exception
    Throwable
      Exception
        com.deltaxml.api DeltaXMLException
          com.deltaxml.core PipelinedComparatorException
            com.deltaxml.core TransformerInstantiationException

Namespace: com.deltaxml.core
Assembly: deltaxml (in deltaxml.dll) Version: 10.4.0.1000
Syntax

[SerializableAttribute]
public class TransformerInstantiationException : PipelinedComparatorException
Remarks

Thrown to indicate a problem instantiating or configuring an XSLT Transformer.

The PipelinedComparator may make use of JAXP XSLT Transformers in its implementation. If there are problems instantiating or configuring these Transformers this exception may be thrown.

The getCause() method could provide details of an underlying javax.xml.transform.TransformerFactoryConfigurationError. This may be the case if a TransformerFactory is not available on the classpath (typically J2SE versions 1.2 or 1.3) or if the JAXP factory property is misconfigured (see javax.xml.transform.TransformerFactory.newInstance).

Alternatively the PipelinedComparator may be configured to bypass the JAXP factory mechanisms and instantiate the Saxon XSLT Transformer directly. When using the bypass mechanism the getCause() method could provide details of exceptions related to locating the Saxon factory class via reflection (see the exceptions thrown by the Class.forName() methods) or instaniating it when the underlying exceptions/errors could be java.lang.InstantiationException or java.lang.IllegalAccessException.

There is also a requirement that the TransformerFactory obtained via JAXP lookup or the bypass mechanism supports the folling features:

  • javax.xml.transform.stream.StreamSource.FEATURE
  • javax.xml.transform.stream.StreamResult.FEATURE
  • javax.xml.transform.sax.SAXSource.FEATURE
  • javax.xml.transform.sax.SAXResult.FEATURE
  • javax.xml.transform.sax.SAXTransformerFactory.FEATURE
  • javax.xml.transform.sax.SAXTransformerFactory.FEATURE_XMLFILTER

All of these FEATURE requirements are met with J2SE versions 1.4 and 5.0 and also by using Saxon version 6.5.3, 6.5.4 or 8.x or Xalan-J Versions 2.5.2 or later.

If this exception is encountered we suggest checking any JAXP factory property settings and classpath contents. If the problems cannot be resolved please contact DeltaXML support for further assistance.

See Also