MultiLevelByNameAndTextSelector (XMLUnit for Java 2.10.1 API)

java.lang.Object
- org.xmlunit.diff.MultiLevelByNameAndTextSelector

All Implemented Interfaces:

ElementSelector
```
public class MultiLevelByNameAndTextSelector
extends Object
implements ElementSelector
```
ElementSelector that allows two elements to be compared if their name (including namespace URI, if any) and textual content is the same at a certain level of nesting.
This means ElementSelectors.byNameAndText and MultiLevelByNameAndTextSelector(1) should lead to the same results.

Any attribute values are completely ignored. Only works on elements with exactly one child element at each level.

This class mostly exists as an example for custom ElementSelectors and may need to be combined inside a conditionalSelector in order to be useful for the document as a whole.

Constructor Summary

Constructors
Constructor	Description
`MultiLevelByNameAndTextSelector(int levels)`	Uses element names and the text nested `levels` child elements deeper into the element to compare elements.
`MultiLevelByNameAndTextSelector(int levels, boolean ignoreEmptyTexts)`	Uses element names and the text nested `levels` child elements deeper into the element to compare elements.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`boolean`	`canBeCompared(Element controlElement, Element testElement)`	Determine whether the two elements from the control and test XML can be compared.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - MultiLevelByNameAndTextSelector
```
public MultiLevelByNameAndTextSelector(int levels)
```
    Uses element names and the text nested levels child elements deeper into the element to compare elements.
    Does not ignore empty text nodes.
    
    Parameters:
    
    levels - level of nesting to use when looking up the text
  - MultiLevelByNameAndTextSelector
```
public MultiLevelByNameAndTextSelector(int levels,
                                       boolean ignoreEmptyTexts)
```
    Uses element names and the text nested levels child elements deeper into the element to compare elements.
    
    Parameters:
    
    levels - level of nesting to use when looking up the text
    
    ignoreEmptyTexts - whether whitespace-only textnodes should be ignored.
- Method Detail
  - canBeCompared
```
public boolean canBeCompared(Element controlElement,
                             Element testElement)
```
    Description copied from interface: ElementSelector
    
    Determine whether the two elements from the control and test XML can be compared.
    
    Specified by:
    
    canBeCompared in interface ElementSelector
    
    Parameters:
    
    controlElement - element of the control XML
    
    testElement - element of the test XML
    
    Returns:
    
    true if the two elements can be compared