org.custommonkey.xmlunit

Class ElementNameAndAttributeQualifier

java.lang.Object

org.custommonkey.xmlunit.ElementNameQualifier

org.custommonkey.xmlunit.ElementNameAndAttributeQualifier

All Implemented Interfaces:

ElementQualifier

public class ElementNameAndAttributeQualifier
extends ElementNameQualifier

More complex interface implementation that tests two elements for tag name and attribute name comparability.

See Also:

DifferenceEngine.compareNodeList(java.util.List, java.util.List, int, DifferenceListener, ElementQualifier), Diff.overrideElementQualifier(ElementQualifier)

Constructor Summary

Constructors

Constructor and Description
ElementNameAndAttributeQualifier() No-args constructor: use all attributes from all elements to determine whether elements qualify for comparability
ElementNameAndAttributeQualifier(String attrName) Simple constructor for a single qualifying attribute name
ElementNameAndAttributeQualifier(String[] attrNames) Extended constructor for multiple qualifying attribute names

Method Summary

Modifier and Type	Method and Description
protected boolean	areAttributesComparable(Element control, Element test) Deprecated. this method is no longer used by this class and is only kept for backwards compatibility, overriding it won't have any effect anymore
boolean	qualifyForComparison(Element control, Element test) Determine whether two elements qualify for further Difference comparison.

Methods inherited from class org.custommonkey.xmlunit.ElementNameQualifier

equalsNamespace, getNonNamespacedNodeName

Methods inherited from class java.lang.Object

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

Constructor Detail

ElementNameAndAttributeQualifier

public ElementNameAndAttributeQualifier()

No-args constructor: use all attributes from all elements to determine whether elements qualify for comparability

ElementNameAndAttributeQualifier

public ElementNameAndAttributeQualifier(String attrName)

Simple constructor for a single qualifying attribute name

Parameters:

attrName - the value to use to qualify whether two elements can be compared further for differences

ElementNameAndAttributeQualifier

public ElementNameAndAttributeQualifier(String[] attrNames)

Extended constructor for multiple qualifying attribute names

Parameters:

attrNames - the array of values to use to qualify whether two elements can be compared further for differences

Method Detail

qualifyForComparison

public boolean qualifyForComparison(Element control,
                                    Element test)

Determine whether two elements qualify for further Difference comparison.

Specified by:

qualifyForComparison in interface ElementQualifier

Overrides:

qualifyForComparison in class ElementNameQualifier

Parameters:

control -

test -

Returns:

true if the two elements qualify for further comparison based on both the superclass qualification (namespace URI and non- namespaced tag name), and the presence of qualifying attributes with the same values; false otherwise

areAttributesComparable

@Deprecated
protected final boolean areAttributesComparable(Element control,
                                                            Element test)

Deprecated. this method is no longer used by this class and is only kept for backwards compatibility, overriding it won't have any effect anymore

Determine whether the qualifying attributes are present in both elements and if so whether their values are the same

Parameters:

control -

test -

Returns:

true if all qualifying attributes are present with the same values, false otherwise