org.xmlunit.diff.Comparison Maven / Gradle / Ivy
/*
This file is licensed to You under the Apache License, Version 2.0
(the "License"); you may not use this file except in compliance with
the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
*/
package org.xmlunit.diff;
import org.w3c.dom.Node;
/**
* Details of a single comparison XMLUnit has performed.
*/
public class Comparison {
/**
* The details of a target (usually some representation of an XML
* Node) that took part in the comparison.
*/
public static class Detail {
private final Node target;
private final String xpath;
private final Object value;
private final String parentXPath;
private Detail(Node n, String x, Object v, String parentX) {
target = n;
xpath = x;
value = v;
parentXPath = parentX;
}
/**
* The actual target.
*/
public Node getTarget() { return target; }
/**
* XPath leading to the target.
*/
public String getXPath() { return xpath; }
/**
* The value for comparison found at the current target.
*/
public Object getValue() { return value; }
/**
* XPath leading to the target's parent.
*/
public String getParentXPath() {
return parentXPath;
}
}
private final Detail control, test;
private final ComparisonType type;
public Comparison(ComparisonType t,
Node controlTarget, String controlXPath, Object controlValue, String controlParentXPath,
Node testTarget, String testXPath, Object testValue, String testParentXPath) {
type = t;
control = new Detail(controlTarget, controlXPath, controlValue, controlParentXPath);
test = new Detail(testTarget, testXPath, testValue, testParentXPath);
}
/**
* The kind of comparison performed.
*/
public ComparisonType getType() {
return type;
}
/**
* Details of the control target.
*/
public Detail getControlDetails() {
return control;
}
/**
* Details of the test target.
*/
public Detail getTestDetails() {
return test;
}
/**
* Returns a string representation of this comparison using the
* given {@link ComparisonFormatter}
* @param formatter the ComparisonFormatter to use
* @return a string representation of this comparison
*/
public String toString(ComparisonFormatter formatter) {
return formatter.getDescription(this);
}
/**
* Returns a string representation of this comparison using {@link DefaultComparisonFormatter}
* @return a string representation of this comparison
*/
@Override
public String toString(){
return toString(new DefaultComparisonFormatter());
}
}