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 junit.framework.TestCase;
20 import org.apache.commons.logging.Log;
21 import org.apache.commons.logging.LogFactory;
23 import java.util.Arrays;
24 import java.util.Iterator;
30 * Useful assertions for use in test cases.
32 * @author Erik Brakkee
34 public final class AssertionUtils {
35 private static final Log LOG = LogFactory.getLog(AssertionUtils.class);
38 * Disabled constructor.
41 private AssertionUtils() {
46 * Asserts that two object arrays are equal.
49 * Expected object array.
51 * Actual object array.
53 public static <T> void assertEquals(T[] aExpected, T[] aActual) {
54 assertEquals("", aExpected, aActual);
58 * Asserts that two object arrays are equal.
67 public static <T> void assertEquals(String aMsg, T[] aExpected, T[] aActual) {
68 TestCase.assertEquals(aMsg + " expected " + Arrays.asList(aExpected) +
69 ", actual " + Arrays.asList(aActual) + ": Array lengths ",
70 aExpected.length, aActual.length);
72 for (int i = 0; i < aExpected.length; i++) {
73 TestCase.assertEquals(aMsg + ": Element " + i, aExpected[i],
79 * Asserts that two objects are equal, and in case the object is an Object[]
80 * delegates to {@link #assertEquals(String, Object[], Object[]).
89 public static <T> void assertEquals(String aMsg, T aExpected, T aActual) {
90 if (aExpected instanceof Object[]) {
91 AssertionUtils.assertEquals(aMsg, (Object[]) aExpected,
97 TestCase.assertEquals(aMsg, aExpected, aActual);
101 * Asserts that two maps are equal by comparing all keys and by checking
102 * that the values for the same keys are the same.
106 * @param aExpectedMap
111 public static <Key, Value> void assertEquals(String aMsg,
112 Map<Key, Value> aExpectedMap, Map<Key, Value> aActual) {
113 TestCase.assertEquals("Map sizes differ", aExpectedMap.size(),
116 Set keys = aExpectedMap.keySet();
118 for (Iterator i = keys.iterator(); i.hasNext();) {
119 String key = (String) i.next();
120 TestCase.assertTrue("Map does not containg entry for key:" + key,
121 aActual.containsKey(key));
122 AssertionUtils.assertEquals("Value of key " + key + " of map",
123 aExpectedMap.get(key), aActual.get(key));
128 * Asserts that an exception occurs.
129 * @param aRunnable Test cases should create a subclass of this which contains the
130 * code that should throw an exception.
131 * @param aType Type of exception that is expected.
133 public static void assertException(ErroneousCode aObject, Class aType) {
136 throw new RuntimeException("No exception occurred");
137 } catch (Throwable t) {
138 if (aType.isInstance(t)) {
139 LOG.info("Expected exception occured " + t.getMessage());
143 throw new RuntimeException(t);
148 public static interface ErroneousCode {
149 void run() throws Exception;