2 * Copyright 2006 the original author or authors.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
16 package org.wamblee.test;
18 import java.util.Arrays;
19 import java.util.Comparator;
20 import java.util.Iterator;
21 import java.util.List;
25 import junit.framework.TestCase;
28 * Useful assertions for use in test cases.
30 * @author Erik Brakkee
32 public final class AssertionUtils {
35 * Disabled constructor.
38 private AssertionUtils() {
43 * Asserts that two object arrays are equal.
46 * Expected object array.
48 * Actual object array.
50 public static <T> void assertEquals(T[] aExpected, T[] aActual) {
51 assertEquals("", aExpected, aActual);
56 * Asserts that two object arrays are equal.
65 public static <T> void assertEquals(String aMsg, T[] aExpected,
67 TestCase.assertEquals(aMsg + " expected " +
68 Arrays.asList(aExpected) + ", actual " +
69 Arrays.asList(aActual) + ": Array lengths ", aExpected.length,
72 for (int i = 0; i < aExpected.length; i++) {
73 TestCase.assertEquals(aMsg + ": Element " + i, aExpected[i],
80 * Asserts that two objects are equal, and in case the object is an Object[]
81 * delegates to {@link #assertEquals(String, Object[], Object[]).
90 public static <T> void assertEquals(String aMsg, T aExpected,
92 if (aExpected instanceof Object[]) {
93 AssertionUtils.assertEquals(aMsg, (Object[]) aExpected,
99 TestCase.assertEquals(aMsg, aExpected, aActual);
103 * Asserts that two maps are equal by comparing all keys and by checking
104 * that the values for the same keys are the same.
108 * @param aExpectedMap
113 public static <Key,Value> void assertEquals(String aMsg,
114 Map<Key,Value> aExpectedMap, Map<Key,Value> aActual) {
115 TestCase.assertEquals("Map sizes differ", aExpectedMap.size(), aActual
118 Set keys = aExpectedMap.keySet();
120 for (Iterator i = keys.iterator(); i.hasNext();) {
121 String key = (String) i.next();
122 TestCase.assertTrue("Map does not containg entry for key:" + key,
123 aActual.containsKey(key));
124 AssertionUtils.assertEquals("Value of key " + key + " of map",
125 aExpectedMap.get(key), aActual.get(key));
129 public static interface ErroneousCode {
130 void run() throws Exception;
134 * Asserts that an exception occurs.
135 * @param aRunnable Test cases should create a subclass of this which contains the
136 * code that should throw an exception.
137 * @param aType Type of exception that is expected.
139 public static void assertException(ErroneousCode aObject, Class aType) {
142 throw new RuntimeException("No exception occurred");
143 } catch (Throwable t) {
144 if ( aType.isInstance(t)) {
148 throw new RuntimeException(t);