Package org.xmlunit.diff

Class DOMDifferenceEngine

java.lang.Object

org.xmlunit.diff.AbstractDifferenceEngine

org.xmlunit.diff.DOMDifferenceEngine

All Implemented Interfaces:

DifferenceEngine

public final class DOMDifferenceEngine
extends AbstractDifferenceEngine

Difference engine based on DOM.

Nested Class Summary

Nested classes/interfaces inherited from class org.xmlunit.diff.AbstractDifferenceEngine

AbstractDifferenceEngine.ComparisonState, AbstractDifferenceEngine.DeferredComparison, AbstractDifferenceEngine.FinishedComparisonState, AbstractDifferenceEngine.OngoingComparisonState

Constructor Summary

Constructors

Constructor	Description
DOMDifferenceEngine()	Creates a new DOMDifferenceEngine using the default DocumentBuilderFactory.
DOMDifferenceEngine(javax.xml.parsers.DocumentBuilderFactory f)	Creates a new DOMDifferenceEngine.

Method Summary

Modifier and Type	Method	Description
void	compare(javax.xml.transform.Source control, javax.xml.transform.Source test)	Compares two pieces of XML and invokes the registered listeners.
void	setDocumentBuilderFactory(javax.xml.parsers.DocumentBuilderFactory f)	Deprecated. use the one-arg constructor instead

Methods inherited from class org.xmlunit.diff.AbstractDifferenceEngine

addComparisonListener, addDifferenceListener, addMatchListener, compare, getAttributeFilter, getComparisonController, getDifferenceEvaluator, getNamespaceContext, getNodeFilter, getNodeMatcher, getParentXPath, getXPath, setAttributeFilter, setComparisonController, setDifferenceEvaluator, setNamespaceContext, setNodeFilter, setNodeMatcher

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DOMDifferenceEngine

public DOMDifferenceEngine()

Creates a new DOMDifferenceEngine using the default DocumentBuilderFactory.

DOMDifferenceEngine

public DOMDifferenceEngine(javax.xml.parsers.DocumentBuilderFactory f)

Creates a new DOMDifferenceEngine.

The DocumentBuilderFactory is only used if the Source passed to compare(javax.xml.transform.Source, javax.xml.transform.Source) is not already a DOMSource.

Parameters:

f - DocumentBuilderFactory to use when creating a Document from the Sources to compare.

Since:

XMLUnit 2.7.0

Method Detail

setDocumentBuilderFactory

public void setDocumentBuilderFactory(javax.xml.parsers.DocumentBuilderFactory f)

Deprecated.

use the one-arg constructor instead

Sets the DocumentBuilderFactory to use when creating a Document from the Sources to compare.

This is only used if the Source passed to compare(javax.xml.transform.Source, javax.xml.transform.Source) is not already a DOMSource.

Parameters:

f - DocumentBuilderFactory to use when creating a Document from the Sources to compare.

Since:

XMLUnit 2.2.0

compare

public void compare(javax.xml.transform.Source control,
                    javax.xml.transform.Source test)

Description copied from interface: DifferenceEngine

Compares two pieces of XML and invokes the registered listeners.

Parameters:

control - the reference source of "good" XML

test - the source under test to compare against control