com.deltaxml.core

Class FilterClassInstantiationException

java.lang.Object

java.lang.Throwable

java.lang.Exception

com.deltaxml.api.DeltaXMLException

com.deltaxml.core.PipelinedComparatorException

com.deltaxml.core.FilterClassInstantiationException

All Implemented Interfaces:

java.io.Serializable

public class FilterClassInstantiationException
extends PipelinedComparatorException

Thrown to indicate that a filter class instantiation problem has been detected.

SAX event filters implemented in Java need to be instantiated. A class, rather than an object, is used as a parameter as in some cases two distinct object instances are required, one for each comparator input. In the process of creating the filter object exceptions such as InstantiationException or IllegalAccessException may be thrown. This exception class wraps these exceptions and also provides information about possible aggregate indicies, when use is made of filter lists or arrays.

See Also:

PipelinedComparator#setInputFilters(Class[]), PipelinedComparator#setInputFilters(java.util.List), PipelinedComparator#setOutputFilters(Class[]), PipelinedComparator#setOutputFilters(java.util.List), Serialized Form

Constructor Summary

Constructors

Constructor and Description
FilterClassInstantiationException(java.lang.String message, java.lang.Throwable t, java.lang.Class<?> filterClass) Creates a new FilterClassInstantiationException.
FilterClassInstantiationException(java.lang.String message, java.lang.Throwable t, java.lang.Class<?> filterClass, int aggregatePosition) Creates a new FilterClassInstantiationException.
FilterClassInstantiationException(java.lang.String message, java.lang.Throwable t, java.lang.Class<?> filterClass, int aggregatePosition, PipelineIOIdentifier pipelineId) Creates a new FilterClassInstantiationException.

Method Summary

Modifier and Type	Method and Description
int	getAggregatePosition() Reports the member of an aggregate which caused the problem.
java.lang.Class<?>	getFilterClass() Provides information about the class which cannot be used as a filter.
PipelineIOIdentifier	getLocationId() 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

FilterClassInstantiationException

public FilterClassInstantiationException(java.lang.String message,
                                         java.lang.Throwable t,
                                         java.lang.Class<?> filterClass)

Creates a new FilterClassInstantiationException.

Parameters:

message - The exception message String

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

filterClass - the class which cannot be instantiated

FilterClassInstantiationException

public FilterClassInstantiationException(java.lang.String message,
                                         java.lang.Throwable t,
                                         java.lang.Class<?> filterClass,
                                         int aggregatePosition)

Creates a new FilterClassInstantiationException.

Parameters:

message - The exception message String

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

filterClass - the class which cannot be instantiated

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

FilterClassInstantiationException

public FilterClassInstantiationException(java.lang.String message,
                                         java.lang.Throwable t,
                                         java.lang.Class<?> filterClass,
                                         int aggregatePosition,
                                         PipelineIOIdentifier pipelineId)

Creates a new FilterClassInstantiationException.

Parameters:

message - The exception message String

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

filterClass - the class which cannot be instantiated

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

pipelineId - specifies which input or output filter chain caused the problem

Since:

6.0

Method Detail

getLocationId

public PipelineIOIdentifier getLocationId()

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

Returns:

An identifier of the problem filter-chain

Since:

6.0

getFilterClass

public java.lang.Class<?> getFilterClass()

Provides information about the class which cannot be used as a filter.

Returns:

the class which cannot be used in this context

getAggregatePosition

public int getAggregatePosition()

Reports the member of an aggregate which caused the problem.

Returns:

an index into a list or array for the erroneous class