java.lang.Object
- junit.framework.Assert
- - junit.framework.TestCase
  - - org.custommonkey.xmlunit.XMLTestCase

All Implemented Interfaces:

junit.framework.Test, XMLConstants, XSLTConstants
```
public abstract class XMLTestCase
extends junit.framework.TestCase
implements XSLTConstants
```
JUnit TestCase subclass: extend this to add XML assertion facilities to your test suites. Available assertions are provided by static methods of the XMLAssert class. NB: All underlying similarity and difference testing is done using Diff instances which can be instantiated and evaluated independently of an XMLTestCase.

See Also:

Diff.similar(), Diff.identical()

Field Summary
- Fields inherited from interface org.custommonkey.xmlunit.XMLConstants
  CLOSE_NODE, END_CDATA, END_COMMENT, END_PROCESSING_INSTRUCTION, NULL_NS_URI, OPEN_END_NODE, OPEN_START_NODE, START_CDATA, START_COMMENT, START_DOCTYPE, START_PROCESSING_INSTRUCTION, W3C_XML_SCHEMA_INSTANCE_NO_NAMESPACE_SCHEMA_LOCATION_ATTR, W3C_XML_SCHEMA_INSTANCE_NS_URI, W3C_XML_SCHEMA_INSTANCE_SCHEMA_LOCATION_ATTR, W3C_XML_SCHEMA_NS_URI, XML_DECLARATION, XMLNS_PREFIX, XPATH_ATTRIBUTE_IDENTIFIER, XPATH_CHARACTER_NODE_IDENTIFIER, XPATH_COMMENT_IDENTIFIER, XPATH_NODE_INDEX_END, XPATH_NODE_INDEX_START, XPATH_PROCESSING_INSTRUCTION_IDENTIFIER, XPATH_SEPARATOR
- Fields inherited from interface org.custommonkey.xmlunit.XSLTConstants
  JAVA5_XSLTC_FACTORY_NAME, XSLT_END, XSLT_IDENTITY_TEMPLATE, XSLT_START, XSLT_START_NO_VERSION, XSLT_STRIP_COMMENTS_TEMPLATE, XSLT_STRIP_WHITESPACE, XSLT_XML_OUTPUT_NOINDENT

Constructor Summary

Constructors
Constructor Description

XMLTestCase()
Construct a new XML test case.

XMLTestCase(String name)
Construct a new test case.

Method Summary

All Methods Instance Methods Concrete Methods
Modifier and Type	Method	Description
`void`	`assertNodeTestPasses(String xmlString, NodeTester tester, short nodeType)`	Execute a `NodeTest` for a single node type and assert that it passes
`void`	`assertNodeTestPasses(NodeTest test, NodeTester tester, short[] nodeTypes, boolean assertion)`	Execute a `NodeTest` for multiple node types and make an assertion about it whether it is expected to pass
`void`	`assertNodeTestPasses(InputSource xml, NodeTester tester, short nodeType)`	Execute a `NodeTest` for a single node type and assert that it passes
`void`	`assertXMLEqual(Reader control, Reader test)`	Assert that two XML documents are similar
`void`	`assertXMLEqual(String err, Reader control, Reader test)`	Assert that two XML documents are similar
`void`	`assertXMLEqual(String control, String test)`	Assert that two XML documents are similar
`void`	`assertXMLEqual(String err, String control, String test)`	Assert that two XML documents are similar
`void`	`assertXMLEqual(String msg, Diff diff, boolean assertion)`	Assert that the result of an XML comparison is or is not similar.
`void`	`assertXMLEqual(String err, Document control, Document test)`	Assert that two XML documents are similar
`void`	`assertXMLEqual(String err, InputSource control, InputSource test)`	Assert that two XML documents are similar
`void`	`assertXMLEqual(Diff diff, boolean assertion)`	Assert that the result of an XML comparison is or is not similar.
`void`	`assertXMLEqual(Document control, Document test)`	Assert that two XML documents are similar
`void`	`assertXMLEqual(InputSource control, InputSource test)`	Assert that two XML documents are similar
`void`	`assertXMLIdentical(String msg, Diff diff, boolean assertion)`	Assert that the result of an XML comparison is or is not identical
`void`	`assertXMLIdentical(Diff diff, boolean assertion)`	Assert that the result of an XML comparison is or is not identical
`void`	`assertXMLNotEqual(Reader control, Reader test)`	Assert that two XML documents are NOT similar
`void`	`assertXMLNotEqual(String err, Reader control, Reader test)`	Assert that two XML documents are NOT similar
`void`	`assertXMLNotEqual(String control, String test)`	Assert that two XML documents are NOT similar
`void`	`assertXMLNotEqual(String err, String control, String test)`	Assert that two XML documents are NOT similar
`void`	`assertXMLNotEqual(String err, Document control, Document test)`	Assert that two XML documents are NOT similar
`void`	`assertXMLNotEqual(String err, InputSource control, InputSource test)`	Assert that two XML documents are NOT similar
`void`	`assertXMLNotEqual(Document control, Document test)`	Assert that two XML documents are NOT similar
`void`	`assertXMLNotEqual(InputSource control, InputSource test)`	Assert that two XML documents are NOT similar
`void`	`assertXMLValid(String xmlString)`	Assert that a String containing XML contains valid XML: the String must contain a DOCTYPE declaration to be validated
`void`	`assertXMLValid(String xmlString, String systemId)`	Assert that a String containing XML contains valid XML: the String must contain a DOCTYPE to be validated, but the validation will use the systemId to obtain the DTD
`void`	`assertXMLValid(String xmlString, String systemId, String doctype)`	Assert that a String containing XML contains valid XML: the String will be given a DOCTYPE to be validated with the name and systemId specified regardless of whether it already contains a doctype declaration.
`void`	`assertXMLValid(Validator validator)`	Assert that a Validator instance returns `isValid() == true`
`void`	`assertXMLValid(InputSource xml)`	Assert that a piece of XML contains valid XML: the input must contain a DOCTYPE declaration to be validated
`void`	`assertXMLValid(InputSource xml, String systemId)`	Assert that a piece of XML contains valid XML: the document must contain a DOCTYPE to be validated, but the validation will use the systemId to obtain the DTD
`void`	`assertXMLValid(InputSource xml, String systemId, String doctype)`	Assert that a piece of XML contains valid XML: the document will be given a DOCTYPE to be validated with the name and systemId specified regardless of whether it already contains a doctype declaration.
`void`	`assertXpathEvaluatesTo(String expectedValue, String xpathExpression, String inXMLString)`	Assert the value of an Xpath expression in an XML String
`void`	`assertXpathEvaluatesTo(String expectedValue, String xpathExpression, Document inDocument)`	Assert the value of an Xpath expression in an DOM Document
`void`	`assertXpathEvaluatesTo(String expectedValue, String xpathExpression, InputSource control)`	Assert the value of an Xpath expression in an XML String
`void`	`assertXpathExists(String xPathExpression, String inXMLString)`	Assert that a specific XPath exists in some given XML
`void`	`assertXpathExists(String xPathExpression, Document inDocument)`	Assert that a specific XPath exists in some given XML
`void`	`assertXpathExists(String xPathExpression, InputSource xml)`	Assert that a specific XPath exists in some given XML
`void`	`assertXpathNotExists(String xPathExpression, String inXMLString)`	Assert that a specific XPath does NOT exist in some given XML
`void`	`assertXpathNotExists(String xPathExpression, Document inDocument)`	Assert that a specific XPath does NOT exist in some given XML
`void`	`assertXpathNotExists(String xPathExpression, InputSource xml)`	Assert that a specific XPath does NOT exist in some given XML
`void`	`assertXpathsEqual(String controlXpath, String testXpath, String inXMLString)`	Assert that the node lists of two Xpaths in the same XML string are equal
`void`	`assertXpathsEqual(String controlXpath, String inControlXMLString, String testXpath, String inTestXMLString)`	Assert that the node lists of two Xpaths in two XML strings are equal
`void`	`assertXpathsEqual(String controlXpath, String testXpath, Document document)`	Assert that the node lists of two Xpaths in the same document are equal
`void`	`assertXpathsEqual(String controlXpath, String testXpath, InputSource document)`	Assert that the node lists of two Xpaths in the same document are equal
`void`	`assertXpathsEqual(String controlXpath, Document controlDocument, String testXpath, Document testDocument)`	Assert that the node lists of two Xpaths in two documents are equal
`void`	`assertXpathsEqual(String controlXpath, InputSource control, String testXpath, InputSource test)`	Assert that the node lists of two Xpaths in two XML pieces are equal
`void`	`assertXpathsNotEqual(String controlXpath, String testXpath, String inXMLString)`	Assert that the node lists of two Xpaths in the same XML string are NOT equal
`void`	`assertXpathsNotEqual(String controlXpath, String inControlXMLString, String testXpath, String inTestXMLString)`	Assert that the node lists of two Xpaths in two XML strings are NOT equal
`void`	`assertXpathsNotEqual(String controlXpath, String testXpath, Document document)`	Assert that the node lists of two Xpaths in the same document are NOT equal
`void`	`assertXpathsNotEqual(String controlXpath, String testXpath, InputSource control)`	Assert that the node lists of two Xpaths in the same XML are NOT equal
`void`	`assertXpathsNotEqual(String controlXpath, Document controlDocument, String testXpath, Document testDocument)`	Assert that the node lists of two Xpaths in two documents are NOT equal
`void`	`assertXpathsNotEqual(String controlXpath, InputSource control, String testXpath, InputSource test)`	Assert that the node lists of two Xpaths in two pieces of XML are NOT equal
`void`	`assertXpathValuesEqual(String controlXpath, String testXpath, String inXMLString)`	Assert that the evaluation of two Xpaths in the same XML string are equal
`void`	`assertXpathValuesEqual(String controlXpath, String inControlXMLString, String testXpath, String inTestXMLString)`	Assert that the evaluation of two Xpaths in two XML strings are equal
`void`	`assertXpathValuesEqual(String controlXpath, String testXpath, Document document)`	Assert that the evaluation of two Xpaths in the same document are equal
`void`	`assertXpathValuesEqual(String controlXpath, String testXpath, InputSource control)`	Assert that the evaluation of two Xpaths in the same XML are equal
`void`	`assertXpathValuesEqual(String controlXpath, Document controlDocument, String testXpath, Document testDocument)`	Assert that the evaluation of two Xpaths in two documents are equal
`void`	`assertXpathValuesEqual(String controlXpath, InputSource control, String testXpath, InputSource test)`	Assert that the evaluation of two Xpaths in two XML strings are equal
`void`	`assertXpathValuesNotEqual(String controlXpath, String testXpath, String inXMLString)`	Assert that the evaluation of two Xpaths in the same XML string are NOT equal
`void`	`assertXpathValuesNotEqual(String controlXpath, String inControlXMLString, String testXpath, String inTestXMLString)`	Assert that the evaluation of two Xpaths in two XML strings are NOT equal
`void`	`assertXpathValuesNotEqual(String controlXpath, String testXpath, Document document)`	Assert that the evaluation of two Xpaths in the same document are NOT equal
`void`	`assertXpathValuesNotEqual(String controlXpath, String testXpath, InputSource control)`	Assert that the evaluation of two Xpaths in the same XML string are NOT equal
`void`	`assertXpathValuesNotEqual(String controlXpath, Document controlDocument, String testXpath, Document testDocument)`	Assert that the evaluation of two Xpaths in two documents are NOT equal
`void`	`assertXpathValuesNotEqual(String controlXpath, InputSource control, String testXpath, InputSource test)`	Assert that the evaluation of two Xpaths in two XML strings are NOT equal
`Diff`	`compareXML(Reader control, Reader test)`	Compare XML documents provided by two Reader classes
`Diff`	`compareXML(Reader control, String test)`	Compare XML documents provided by two Reader classes
`Diff`	`compareXML(String control, Reader test)`	Compare XML documents provided by two Reader classes
`Diff`	`compareXML(String control, String test)`	Compare two XML documents provided as strings
`Diff`	`compareXML(Document control, Document test)`	Compare two XML documents provided as strings
`Diff`	`compareXML(InputSource control, InputSource test)`	Compare XML documents provided by two InputSource classes

Methods inherited from class junit.framework.TestCase
countTestCases, createResult, getName, run, run, runBare, runTest, setName, setUp, tearDown, toString

Methods inherited from class junit.framework.Assert
assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertEquals, assertFalse, assertFalse, assertNotNull, assertNotNull, assertNotSame, assertNotSame, assertNull, assertNull, assertSame, assertSame, assertTrue, assertTrue, fail, fail

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

Constructor Detail
- XMLTestCase
```
public XMLTestCase()
```
  Construct a new XML test case.
- XMLTestCase
```
public XMLTestCase(String name)
```
  Construct a new test case.
  
  Parameters:
  
  name - Name of test

Method Detail

compareXML
```
public Diff compareXML(InputSource control,
                       InputSource test)
                throws SAXException,
                       IOException
```
Compare XML documents provided by two InputSource classes

Parameters:

control - Control document

test - Document to test

Returns:

Diff object describing differences in documents

Throws:

SAXException - if the parser says so

IOException - on I/O errors

compareXML
```
public Diff compareXML(Reader control,
                       Reader test)
                throws SAXException,
                       IOException
```
Compare XML documents provided by two Reader classes

Parameters:

control - Control document

test - Document to test

Returns:

Diff object describing differences in documents

Throws:

SAXException - if the parser says so

IOException - on I/O errors

compareXML
```
public Diff compareXML(String control,
                       Reader test)
                throws SAXException,
                       IOException
```
Compare XML documents provided by two Reader classes

Parameters:

control - Control document

test - Document to test

Returns:

Diff object describing differences in documents

Throws:

SAXException - if the parser says so

IOException - on I/O errors

compareXML
```
public Diff compareXML(Reader control,
                       String test)
                throws SAXException,
                       IOException
```
Compare XML documents provided by two Reader classes

Parameters:

control - Control document

test - Document to test

Returns:

Diff object describing differences in documents

Throws:

SAXException - if the parser says so

IOException - on I/O errors

compareXML
```
public Diff compareXML(String control,
                       String test)
                throws SAXException,
                       IOException
```
Compare two XML documents provided as strings

Parameters:

control - Control document

test - Document to test

Returns:

Diff object describing differences in documents

Throws:

SAXException - if the parser says so

IOException - on I/O errors

compareXML
```
public Diff compareXML(Document control,
                       Document test)
```
Compare two XML documents provided as strings

Parameters:

control - Control document

test - Document to test

Returns:

Diff object describing differences in documents

assertXMLEqual
```
public void assertXMLEqual(Diff diff,
                           boolean assertion)
```
Assert that the result of an XML comparison is or is not similar.

Parameters:

diff - the result of an XML comparison

assertion - true if asserting that result is similar

assertXMLEqual
```
public void assertXMLEqual(String msg,
                           Diff diff,
                           boolean assertion)
```
Assert that the result of an XML comparison is or is not similar.

Parameters:

msg - additional message to display if assertion fails

diff - the result of an XML comparison

assertion - true if asserting that result is similar

assertXMLIdentical
```
public void assertXMLIdentical(Diff diff,
                               boolean assertion)
```
Assert that the result of an XML comparison is or is not identical

Parameters:

diff - the result of an XML comparison

assertion - true if asserting that result is identical

assertXMLIdentical
```
public void assertXMLIdentical(String msg,
                               Diff diff,
                               boolean assertion)
```
Assert that the result of an XML comparison is or is not identical

Parameters:

msg - Message to display if assertion fails

diff - the result of an XML comparison

assertion - true if asserting that result is identical