Loads a PipelinedComparator from a DXP configuration.
|DXPParameterDefinition<T extends java.lang.Comparable<?>>||
A comparison parameter definition.
A utility class for identifying the space required to display a list of parameter definitions.
|DXPParameterInstance<T extends java.lang.Comparable<?>>||
An instance of a DXPParameterDefinition object.
A filter with associated parameters which can modify its runtime behaviour.
Defines the type of the underlying filter associated with a
Provides a Pipeline abstraction for the Comparator.
A type-safe enumeration used to define the various filter chains associated with a
Thrown to indicate a problem instantiating or configuring a DeltaXML Comparator.
Indicates an error condition in the DXPConfiguration.
Thrown to indicate that a feature name has not been recognized.
Thrown to indicate that a feature has been set to a value which is not supported or is disallowed.
Thrown to indicate that a filter class incompatibility has been detected.
Thrown to indicate that a filter class instantiation problem has been detected.
Thrown to indicate a failure in creating or configuring an XSLT-based SAX event filter.
Thrown to indicate that a filter parameterization problem has been detected.
Thrown to report a problem with XSLT filter parameterization.
Thrown to indicate a problem instantiating or configuring an identity XSLT Transformer.
Used to indicate that the DXP File loaded by a DXPConfiguration is not valid.
An exception class corresponding to the licensing related issues that can occur during the various compare(), isEqual() and setRedistributionLicenseContent() methods.
Thrown when a SystemId cannot be determined in the DXPConfiguration constructors.
Thrown when the DXP pipelineParameter names are not unique.
Thrown when an a parameter or feature has incorrect DXP syntax.
Thrown to indicate a problem instantiating or configuring a SAX Parser.
Indicates an error condition in the PipelinedComparator.
Thrown to indicate an exception during pipeline execution or processing, produced during an invocation of a compare() method.
Thrown to indicate a problem setting a property on the PipelinedComparator.
Thrown to indicate a problem setting a property with an unsupported value or type.
Thrown to indicate a problem instantiating or configuring an XSLT Transformer.
Thrown when an attempt was made to reference an unknown or undeclared DXP parameter.
Used to indicate that the throwing class does not support the DXP version of the loaded DXP file.
Thrown to indicate the use of an unsupported filter in a filter List.
Thrown to indicate the use of a pipeline Source input which is not supported.
Specifies an unresolvable error condition in a DXPConfiguration.
Specifies an error condition in the PipelinedComparator.
A JAXP compatible API to facilitate construction of XML comparison pipelines.
This package uses the features of the JAXP API including XMLFilters and TransformerHandlers to link the pipeline stages together, but tries to hide the complexity of JAXP pipeline construction from the user.
A similar, but more efficient and feature-rich, pipeline is provided by the new
com.deltaxml.cores9api package. Its
provides similar classes and methods to this package (which should make upgrading fairly easy), but its internal implementation
is based on s9api providing better performance and some extra features.
Support Note: This package will be supported for a number of future releases according to customer demand, but it should be considered 'deprecated'. We encourage new users to use the new cores9api package in preference to this one and will provide support to users who wish to upgrade.
NOTE: This package is called:
com.deltaxml.core while the JAXP orientated API is:
com.deltaxml.api. The api package name was/is a poor choice of name, but it is preserved for backwards
compatibility reasons with existing 2.x releases. This package is built on-top of and uses the code in the api
This API requires:
JAXP is required to provide a pluggable SAX Parsers and XSLT Processors. This API is included in the JDK and JRE from versions 1.4 onwards. Included with this release are jar files for Saxon 9.3 and Xerces-J 2.9, these provide alternative JAXP implementations and we recommend their use over those included in the JDK/JRE. Some of the provided filters are written using XSLT 2.0 and these require the use of an XSLT processor such as Saxon.
Saxon 9.3 and Xerces 2.9 are our recommended implementations and have undergone thorough testing. However, we have also tested a number of alternate implementations, which although unable to support all of the provided filters are compatible with this package, these include:
Usage notes/comments in the various XSLT scripts included as samples describe some known bugs in some of the XSLT processors we have tested. We would recommend reading the script comments and/or the Java filter documentation when choosing filters or considering the use of different JAXP implementations.
A samples directory provides code samples and data together with a ReadMe file explaining compilation/running. We recommend using the provided Ant scripts for compilation and running . The Ant build tool is available from ant.apache.org.
The currently supported properties and features are documented in Features and Properties.
A single PipelinedComparator should not be used by multiple threads running concurrently. Different PipelinedComparators may be used concurrently by different threads.
Feature and property settings are preserved between invocations of the compare methods.
Please visit our Support Page to find the relevant channels to use for any questions, bug-reports, suggested enhancements or any other matter related to this software.
Copyright © 2001-2018 DeltaXML Ltd. All Rights Reserved.