com.deltaxml.core

Class TransformerInstantiationException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.deltaxml.api.DeltaXMLException

com.deltaxml.core.PipelinedComparatorException

com.deltaxml.core.TransformerInstantiationException

All Implemented Interfaces:

java.io.Serializable

public class TransformerInstantiationException
extends PipelinedComparatorException

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 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 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 InstantiationException or IllegalAccessException.

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

• StreamSource.FEATURE
• StreamResult.FEATURE
• SAXSource.FEATURE
• SAXResult.FEATURE
• SAXTransformerFactory.FEATURE
• 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:

TransformerFactoryConfigurationError, PipelinedComparator#PipelinedComparator(boolean), Serialized Form

Constructor Summary

Constructors

Constructor and Description
TransformerInstantiationException(java.lang.String message) Creates a new TransformerInstantiationException.
TransformerInstantiationException(java.lang.String message, java.lang.Throwable t) Creates a new TransformerInstantiationException.

Method Summary

Methods inherited from class com.deltaxml.api.DeltaXMLException

getCause, getThrowable

Methods inherited from class java.lang.Throwable

addSuppressed, fillInStackTrace, getLocalizedMessage, getMessage, getStackTrace, getSuppressed, initCause, printStackTrace, printStackTrace, printStackTrace, setStackTrace, toString

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

TransformerInstantiationException

public TransformerInstantiationException(java.lang.String message,
                                         java.lang.Throwable t)

Creates a new TransformerInstantiationException.

Parameters:

message - The message string

t - A nested throwable should it have lead to or caused this exception

TransformerInstantiationException

public TransformerInstantiationException(java.lang.String message)

Creates a new TransformerInstantiationException.

Parameters:

message - The message string