AbstractDifferenceEngineTest.java

/*
  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.junit.Test;
import javax.xml.transform.Source;

import static org.hamcrest.Matchers.containsString;
import static org.junit.Assert.*;

public abstract class AbstractDifferenceEngineTest {

    protected abstract AbstractDifferenceEngine getDifferenceEngine();

    private static class ResultGrabber implements DifferenceEvaluator {
        private ComparisonResult outcome = ComparisonResult.SIMILAR;
        public ComparisonResult evaluate(Comparison comparison,
                                         ComparisonResult outcome) {
            this.outcome = outcome;
            return outcome;
        }
    }

    @Test public void compareTwoNulls() {
        ResultGrabber g = new ResultGrabber();
        AbstractDifferenceEngine d = getDifferenceEngine();
        d.setDifferenceEvaluator(g);
        assertEquals(wrap(ComparisonResult.EQUAL),
                     d.compare(new Comparison(ComparisonType.HAS_DOCTYPE_DECLARATION,
                                              null, null, null, null,
                                              null, null, null, null)));
        assertEquals(ComparisonResult.EQUAL, g.outcome);
    }

    @Test public void compareControlNullTestNonNull() {
        ResultGrabber g = new ResultGrabber();
        AbstractDifferenceEngine d = getDifferenceEngine();
        d.setDifferenceEvaluator(g);
        assertEquals(wrap(ComparisonResult.DIFFERENT),
                     d.compare(new Comparison(ComparisonType.HAS_DOCTYPE_DECLARATION,
                                              null, null, null, null,
                                              null, null, "", null)));
        assertEquals(ComparisonResult.DIFFERENT, g.outcome);
    }

    @Test public void compareControlNonNullTestNull() {
        ResultGrabber g = new ResultGrabber();
        AbstractDifferenceEngine d = getDifferenceEngine();
        d.setDifferenceEvaluator(g);
        assertEquals(wrap(ComparisonResult.DIFFERENT),
                     d.compare(new Comparison(ComparisonType.HAS_DOCTYPE_DECLARATION,
                                              null, null, "", null,
                                              null, null, null, null)));
        assertEquals(ComparisonResult.DIFFERENT, g.outcome);
    }

    @Test public void compareTwoDifferentNonNulls() {
        ResultGrabber g = new ResultGrabber();
        AbstractDifferenceEngine d = getDifferenceEngine();
        d.setDifferenceEvaluator(g);
        assertEquals(wrap(ComparisonResult.DIFFERENT),
                     d.compare(new Comparison(ComparisonType.HAS_DOCTYPE_DECLARATION,
                                              null, null, new Short("1"), null,
                                              null, null, new Short("2"), null)));
        assertEquals(ComparisonResult.DIFFERENT, g.outcome);
    }

    @Test public void compareTwoEqualNonNulls() {
        ResultGrabber g = new ResultGrabber();
        AbstractDifferenceEngine d = getDifferenceEngine();
        d.setDifferenceEvaluator(g);
        assertEquals(wrap(ComparisonResult.EQUAL),
                     d.compare(new Comparison(ComparisonType.HAS_DOCTYPE_DECLARATION,
                                              null, null, new Short("2"), null,
                                              null, null, new Short("2"), null)));
        assertEquals(ComparisonResult.EQUAL, g.outcome);
    }

    @Test public void compareNotifiesComparisonListener() {
        AbstractDifferenceEngine d = getDifferenceEngine();
        ComparisonListenerSupportTest.Listener l =
            new ComparisonListenerSupportTest.Listener(ComparisonResult.EQUAL);
        d.addComparisonListener(l);
        assertEquals(wrap(ComparisonResult.EQUAL),
                     d.compare(new Comparison(ComparisonType.HAS_DOCTYPE_DECLARATION,
                                              null, null, new Short("2"), null,
                                              null, null, new Short("2"), null)));
        assertEquals(1, l.getInvocations());
    }

    @Test
    public void compareNotifiesMatchListener() {
        AbstractDifferenceEngine d = getDifferenceEngine();
        ComparisonListenerSupportTest.Listener l =
            new ComparisonListenerSupportTest.Listener(ComparisonResult.EQUAL);
        d.addMatchListener(l);
        assertEquals(wrap(ComparisonResult.EQUAL),
                     d.compare(new Comparison(ComparisonType.HAS_DOCTYPE_DECLARATION,
                                              null, null, new Short("2"), null,
                                              null, null, new Short("2"), null)));
        assertEquals(1, l.getInvocations());
    }

    @Test
    public void compareNotifiesDifferenceListener() {
        AbstractDifferenceEngine d = getDifferenceEngine();
        ComparisonListenerSupportTest.Listener l =
            new ComparisonListenerSupportTest.Listener(ComparisonResult.SIMILAR);
        d.addDifferenceListener(l);
        assertEquals(wrap(ComparisonResult.SIMILAR),
                     d.compare(new Comparison(ComparisonType.HAS_DOCTYPE_DECLARATION,
                                              null, null, new Short("2"), null,
                                              null, null, new Short("3"), null)));
        assertEquals(1, l.getInvocations());
    }

    @Test public void compareUsesResultOfEvaluator() {
        AbstractDifferenceEngine d = getDifferenceEngine();
        ComparisonListenerSupportTest.Listener l =
            new ComparisonListenerSupportTest.Listener(ComparisonResult.SIMILAR);
        d.addComparisonListener(l);
        d.setDifferenceEvaluator(new DifferenceEvaluator() {
                public ComparisonResult evaluate(Comparison comparison,
                                                 ComparisonResult outcome) {
                    return ComparisonResult.SIMILAR;
                }
            });
        assertEquals(wrap(ComparisonResult.SIMILAR),
                     d.compare(new Comparison(ComparisonType.HAS_DOCTYPE_DECLARATION,
                                              null, null, new Short("2"), null,
                                              null, null, new Short("2"), null)));
        assertEquals(1, l.getInvocations());
    }

    @Test public void compareUsesResultOfController() {
        AbstractDifferenceEngine d = getDifferenceEngine();
        ComparisonListenerSupportTest.Listener l =
            new ComparisonListenerSupportTest.Listener(ComparisonResult.SIMILAR);
        d.addComparisonListener(l);
        d.setComparisonController(new ComparisonController() {
                @Override
                public boolean stopDiffing(Difference ignored) {
                    return true;
                }
            });
        assertEquals(wrapAndStop(ComparisonResult.SIMILAR),
                     d.compare(new Comparison(ComparisonType.HAS_DOCTYPE_DECLARATION,
                                              null, null, new Short("1"), null,
                                              null, null, new Short("2"), null)));
        assertEquals(1, l.getInvocations());
    }

    @Test
    public void ongoingComparisonStateBasics() {
        AbstractDifferenceEngine.ComparisonState cs = wrap(ComparisonResult.EQUAL);
        assertEquals(cs, new WrapHelper().empty());
    }

    @Test
    public void andThenUsesCurrentFinishedFlag() {
        AbstractDifferenceEngine.ComparisonState cs = wrapAndStop(ComparisonResult.SIMILAR);
        assertEquals(wrapAndStop(ComparisonResult.SIMILAR),
                     cs.andThen(new AbstractDifferenceEngine.DeferredComparison() {
                             @Override
                             public AbstractDifferenceEngine.ComparisonState apply() {
                                 return wrap(ComparisonResult.EQUAL);
                             }
                         }));
        cs = wrap(ComparisonResult.SIMILAR);
        assertEquals(wrap(ComparisonResult.EQUAL),
                     cs.andThen(new AbstractDifferenceEngine.DeferredComparison() {
                             @Override
                             public AbstractDifferenceEngine.ComparisonState apply() {
                                 return wrap(ComparisonResult.EQUAL);
                             }
                         }));
    }

    @Test
    public void andIfTrueThenUsesCurrentFinishedFlag() {
        AbstractDifferenceEngine.ComparisonState cs = wrapAndStop(ComparisonResult.SIMILAR);
        assertEquals(wrapAndStop(ComparisonResult.SIMILAR),
                     cs.andIfTrueThen(true, new AbstractDifferenceEngine.DeferredComparison() {
                             @Override
                             public AbstractDifferenceEngine.ComparisonState apply() {
                                 return wrap(ComparisonResult.EQUAL);
                             }
                         }));
        cs = wrap(ComparisonResult.SIMILAR);
        assertEquals(wrap(ComparisonResult.EQUAL),
                     cs.andIfTrueThen(true, new AbstractDifferenceEngine.DeferredComparison() {
                             @Override
                             public AbstractDifferenceEngine.ComparisonState apply() {
                                 return wrap(ComparisonResult.EQUAL);
                             }
                         }));
    }

    @Test
    public void andIfTrueThenIsNoopIfFirstArgIsFalse() {
        AbstractDifferenceEngine.ComparisonState cs = wrapAndStop(ComparisonResult.SIMILAR);
        assertEquals(wrapAndStop(ComparisonResult.SIMILAR),
                     cs.andIfTrueThen(false, new AbstractDifferenceEngine.DeferredComparison() {
                             @Override
                             public AbstractDifferenceEngine.ComparisonState apply() {
                                 return wrap(ComparisonResult.EQUAL);
                             }
                         }));
        cs = wrap(ComparisonResult.SIMILAR);
        assertEquals(wrap(ComparisonResult.SIMILAR),
                     cs.andIfTrueThen(false, new AbstractDifferenceEngine.DeferredComparison() {
                             @Override
                             public AbstractDifferenceEngine.ComparisonState apply() {
                                 return wrap(ComparisonResult.EQUAL);
                             }
                         }));
    }

    @Test(expected = IllegalArgumentException.class)
    public void cantAddNullComparisonListener() {
        getDifferenceEngine().addComparisonListener(null);
    }

    @Test(expected = IllegalArgumentException.class)
    public void cantAddNullMatchListener() {
        getDifferenceEngine().addMatchListener(null);
    }

    @Test(expected = IllegalArgumentException.class)
    public void cantAddNullDifferenceListener() {
        getDifferenceEngine().addDifferenceListener(null);
    }

    @Test(expected = IllegalArgumentException.class)
    public void cantSetNullNodeMatcher() {
        getDifferenceEngine().setNodeMatcher(null);
    }

    @Test(expected = IllegalArgumentException.class)
    public void cantSetNullComparisonController() {
        getDifferenceEngine().setComparisonController(null);
    }

    @Test(expected = IllegalArgumentException.class)
    public void cantSetNullDifferenceEvaluator() {
        getDifferenceEngine().setDifferenceEvaluator(null);
    }

    @Test(expected = IllegalArgumentException.class)
    public void cantSetNullAttributeFilter() {
        getDifferenceEngine().setAttributeFilter(null);
    }

    @Test(expected = IllegalArgumentException.class)
    public void cantSetNullNodeFilter() {
        getDifferenceEngine().setNodeFilter(null);
    }

    @Test
    public void comparisonStateEqualsLooksAtType() {
        WrapHelper w = new WrapHelper();
        assertNotEquals(w.wrap(ComparisonResult.SIMILAR), w.myOngoing());
    }

    @Test
    public void comparisonStateEqualsLooksAtResult() {
        assertNotEquals(wrap(ComparisonResult.SIMILAR), wrap(ComparisonResult.DIFFERENT));
    }

    @Test
    public void hashCodeLooksAtFinished() {
        assertNotEquals(wrap(ComparisonResult.SIMILAR).hashCode(),
                        wrapAndStop(ComparisonResult.SIMILAR).hashCode());
    }

    @Test
    public void trivialComparisonStateToString() {
        String s = wrap(ComparisonResult.SIMILAR).toString();
        assertThat(s, containsString("OngoingComparisonState"));
        assertThat(s, containsString("SIMILAR"));
    }

    protected static AbstractDifferenceEngine.ComparisonState wrap(ComparisonResult c) {
        return new WrapHelper().wrap(c);
    }

    protected static AbstractDifferenceEngine.ComparisonState wrapAndStop(ComparisonResult c) {
        return new WrapHelper().wrapAndStop(c);
    }

    private static class WrapHelper extends AbstractDifferenceEngine {
        private ComparisonState empty() {
            return new OngoingComparisonState();
        }
        private ComparisonState wrap(ComparisonResult r) {
            return new OngoingComparisonState(r);
        }
        private ComparisonState wrapAndStop(ComparisonResult r) {
            return new FinishedComparisonState(r);
        }
        private ComparisonState myOngoing() {
            return new ComparisonState(false, ComparisonResult.SIMILAR) {
            };
        }
        @Override
        public void compare(Source control, Source test) {
        }
    }
}