com.deltaxml.core.TransformerInstantiationException Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of xmlcalabash-extension-stubs Show documentation
This artifact defines API stubs for compiling extension classes.
The newest version!
package com.deltaxml.core;

import javax.xml.transform.TransformerFactory;
import javax.xml.transform.TransformerFactoryConfigurationError;
import javax.xml.transform.sax.SAXResult;
import javax.xml.transform.sax.SAXSource;
import javax.xml.transform.sax.SAXTransformerFactory;
import javax.xml.transform.stream.StreamResult;
import javax.xml.transform.stream.StreamSource;

/**
 * Thrown to indicate a problem instantiating or configuring an XSLT
 * Transformer.
 *
 * 
 * The {@link 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 {@link #getCause()} method could provide details of an underlying
 * {@link TransformerFactoryConfigurationError}. This may be the case if a
 * {@link TransformerFactory} is not available on the classpath (typically J2SE
 * versions 1.2 or 1.3) or if the JAXP factory property is misconfigured (see
 * {@link TransformerFactory#newInstance()}).
 *
 * 
 * Alternatively the {@link PipelinedComparator} may be configured to bypass the
 * JAXP factory mechanisms and instantiate the Saxon XSLT Transformer directly.
 * When using the bypass mechanism the {@link #getCause()} method could provide
 * details of exceptions related to locating the Saxon factory class via
 * reflection (see the exceptions thrown by the {@link Class#forName} methods)
 * or instantiating it when the underlying exceptions/errors could be
 * {@link InstantiationException} or {@link IllegalAccessException}.
 *
 * 
 * There is also a requirement that the {@link TransformerFactory} obtained via
 * JAXP lookup or the bypass mechanism supports the following features:
 *
 * 
 * {@link StreamSource#FEATURE}
 * {@link StreamResult#FEATURE}
 * {@link SAXSource#FEATURE}
 * {@link SAXResult#FEATURE}
 * {@link SAXTransformerFactory#FEATURE}
 * {@link SAXTransformerFactory#FEATURE_XMLFILTER}
 * 
 *
 * 
 * All of these {@code 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 
 * Class TransformerInstantiationException
 */
public class TransformerInstantiationException extends PipelinedComparatorException {

    public TransformerInstantiationException(String message) {
        super(message);
        throw new UnsupportedOperationException();
    }

    public TransformerInstantiationException(String message, Throwable t) {
        super(message, t);
        throw new UnsupportedOperationException();
    }

}