com.deltaxml.core

Class FilterConfigurationException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.deltaxml.api.DeltaXMLException

com.deltaxml.core.PipelinedComparatorException

com.deltaxml.core.FilterConfigurationException

All Implemented Interfaces:

java.io.Serializable

public class FilterConfigurationException
extends PipelinedComparatorException

Thrown to indicate a failure in creating or configuring an XSLT-based SAX event filter.

Pipeline input or output filters can be implemented in Java or XSLT. When XSLT is used, filter setting methods allow Templates Objects, Files and URLs to specify the location of an XSLT filter. These filters should then be converted into an XMLFilterImpl or TransformerHandler as appropriate. However, a number of problems can arise during XSLT compilation or filter instantiation. This exception allows the underlying cause to be determined from a nested exception (through getCause()) and also allows details of aggregatePosition to be determined when the filter was supplied as part of an aggregate parameter.

The getCause() method will usually provide access to a TransformerConfigurationException with more information about the underlying cause. This in turn may provide a further getCause() method providing further information (for example a FileNotFoundException).

See Also:

TransformerConfigurationException, Serialized Form

Constructor Summary

Constructors

Constructor and Description
FilterConfigurationException(java.lang.String message, java.lang.Throwable t, java.lang.String filterSource) Creates a new FilterConfigurationException.
FilterConfigurationException(java.lang.String message, java.lang.Throwable t, java.lang.String filterSource, int aggregatePosition) Creates a new FilterConfigurationException.
FilterConfigurationException(java.lang.String message, java.lang.Throwable t, java.lang.String filterSource, int aggregatePosition, PipelineIOIdentifier pipelineId) Creates a new FilterConfigurationException.

Method Summary

Modifier and Type	Method and Description
int	getAggregatePosition() Reports the member of a filter aggregate which caused the problem.
java.lang.String	getFilterSource() Provides information about the origins of the filter, for example the file or URL from which the XSLT was loaded.
PipelineIOIdentifier	getPipelineId() Returns the identity of the filter chain in which the problem occurred.

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

FilterConfigurationException

public FilterConfigurationException(java.lang.String message,
                                    java.lang.Throwable t,
                                    java.lang.String filterSource,
                                    int aggregatePosition,
                                    PipelineIOIdentifier pipelineId)

Creates a new FilterConfigurationException.

Parameters:

message - The exception message String

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

filterSource - identifies the original XSLT if possible

aggregatePosition - an index into an aggregate of filters to identify the one at fault

pipelineId - the pipeline identifier

FilterConfigurationException

public FilterConfigurationException(java.lang.String message,
                                    java.lang.Throwable t,
                                    java.lang.String filterSource,
                                    int aggregatePosition)

Creates a new FilterConfigurationException.

Parameters:

message - the Exception message String

t - a nested Throwable that caused or lead to this Exception

filterSource - identifies the original XSLT if possible

aggregatePosition - an index into an aggregate of filters to identify the one at fault

FilterConfigurationException

public FilterConfigurationException(java.lang.String message,
                                    java.lang.Throwable t,
                                    java.lang.String filterSource)

Creates a new FilterConfigurationException.

Parameters:

message - The exception message String

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

filterSource - identifies the original XSLT if possible

Method Detail

getFilterSource

public java.lang.String getFilterSource()

Provides information about the origins of the filter, for example the file or URL from which the XSLT was loaded.

Returns:

a description of the filter origin

getAggregatePosition

public int getAggregatePosition()

Reports the member of a filter aggregate which caused the problem.

Returns:

an index into a list or array for the erroneous filter

getPipelineId

public PipelineIOIdentifier getPipelineId()

Returns the identity of the filter chain in which the problem occurred.

Returns:

An identifier of the problem filter-chain