MRUNIT-108: copy ExtendedAssert.assertListEquals to src/test/java and deprecate entire class and all methods in ExtendedAssert in src/main/java

git-svn-id: https://svn.apache.org/repos/asf/incubator/mrunit/trunk@1335332 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/main/java/org/apache/hadoop/mrunit/testutil/ExtendedAssert.java b/src/main/java/org/apache/hadoop/mrunit/testutil/ExtendedAssert.java
index bbcfcdd..05420cb 100644
--- a/src/main/java/org/apache/hadoop/mrunit/testutil/ExtendedAssert.java
+++ b/src/main/java/org/apache/hadoop/mrunit/testutil/ExtendedAssert.java
@@ -22,6 +22,10 @@
 
 import java.util.List;
 
+/**
+ * @deprecated No replacement due to automatic comparisons using runTest()
+ */
+@Deprecated
 public final class ExtendedAssert {
 
   private ExtendedAssert() {
@@ -34,7 +38,9 @@
    *          a list full of expected values
    * @param actual
    *          a list full of actual test values
+   * @deprecated No replacement due to automatic list comparison using runTest()
    */
+  @Deprecated
   public static void assertListEquals(final List<?> expected,
       final List<?> actual) {
     if (expected.size() != actual.size()) {
@@ -59,24 +65,44 @@
 
   /**
    * asserts x &gt; y
+   * 
+   * @deprecated No replacement since extension methods to JUnit assert methods
+   *             dont fit well with MRUnit's goals
    */
+  @Deprecated
   public static void assertGreater(final int x, final int y) {
     assertTrue("Expected " + x + " > " + y, x > y);
   }
 
-  /** asserts x &gt;= y) */
+  /**
+   * asserts x &gt;= y)
+   * 
+   * @deprecated No replacement since extension methods to JUnit assert methods
+   *             dont fit well with MRUnit's goals
+   */
+  @Deprecated
   public static void assertGreaterOrEqual(final int x, final int y) {
     assertTrue("Expected " + x + " >= " + y, x >= y);
   }
 
   /**
    * asserts x &lt; y
+   * 
+   * @deprecated No replacement since extension methods to JUnit assert methods
+   *             dont fit well with MRUnit's goals
    */
+  @Deprecated
   public static void assertLess(final int x, final int y) {
     assertTrue("Expected " + x + " < " + y, x < y);
   }
 
-  /** asserts x &gt;= y) */
+  /**
+   * asserts x &gt;= y)
+   * 
+   * @deprecated No replacement since extension methods to JUnit assert methods
+   *             dont fit well with MRUnit's goals
+   * */
+  @Deprecated
   public static void assertLessOrEqual(final int x, final int y) {
     assertTrue("Expected " + x + " <= " + y, x <= y);
   }
diff --git a/src/test/java/org/apache/hadoop/mrunit/ExtendedAssert.java b/src/test/java/org/apache/hadoop/mrunit/ExtendedAssert.java
new file mode 100644
index 0000000..3adb020
--- /dev/null
+++ b/src/test/java/org/apache/hadoop/mrunit/ExtendedAssert.java
@@ -0,0 +1,58 @@
+/**
+ * Licensed to the Apache Software Foundation (ASF) under one
+ * or more contributor license agreements.  See the NOTICE file
+ * distributed with this work for additional information
+ * regarding copyright ownership.  The ASF licenses this file
+ * 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.apache.hadoop.mrunit;
+
+import static org.junit.Assert.fail;
+
+import java.util.List;
+
+public final class ExtendedAssert {
+
+  private ExtendedAssert() {
+  }
+
+  /**
+   * Asserts that all the elements of the list are equivalent under equals()
+   * 
+   * @param expected
+   *          a list full of expected values
+   * @param actual
+   *          a list full of actual test values
+   */
+  public static void assertListEquals(final List<?> expected,
+      final List<?> actual) {
+    if (expected.size() != actual.size()) {
+      fail("Expected list of size " + expected.size() + "; actual size is "
+          + actual.size());
+    }
+
+    for (int i = 0; i < expected.size(); i++) {
+      final Object t1 = expected.get(i);
+      final Object t2 = actual.get(i);
+
+      final boolean same = (t1 == t2) || (t1 != null && t1.equals(t2))
+          || (t2 != null && t2.equals(t1));
+      if (!same) {
+        fail("Expected element " + t1 + " ("
+            + ((t2 == null) ? "unknown type" : t2.getClass().getName())
+            + ") at index " + i + " != actual element " + t2 + " ("
+            + ((t2 == null) ? "unknown type" : t2.getClass().getName()) + ")");
+      }
+    }
+  }
+}
diff --git a/src/test/java/org/apache/hadoop/mrunit/TestMapDriver.java b/src/test/java/org/apache/hadoop/mrunit/TestMapDriver.java
index 1deb8a6..e9574bc 100644
--- a/src/test/java/org/apache/hadoop/mrunit/TestMapDriver.java
+++ b/src/test/java/org/apache/hadoop/mrunit/TestMapDriver.java
@@ -17,7 +17,7 @@
  */
 package org.apache.hadoop.mrunit;
 
-import static org.apache.hadoop.mrunit.testutil.ExtendedAssert.assertListEquals;
+import static org.apache.hadoop.mrunit.ExtendedAssert.assertListEquals;
 import static org.junit.Assert.assertEquals;
 
 import java.io.IOException;
diff --git a/src/test/java/org/apache/hadoop/mrunit/TestMapReduceDriver.java b/src/test/java/org/apache/hadoop/mrunit/TestMapReduceDriver.java
index c35711f..e341b60 100644
--- a/src/test/java/org/apache/hadoop/mrunit/TestMapReduceDriver.java
+++ b/src/test/java/org/apache/hadoop/mrunit/TestMapReduceDriver.java
@@ -17,7 +17,7 @@
  */
 package org.apache.hadoop.mrunit;
 
-import static org.apache.hadoop.mrunit.testutil.ExtendedAssert.assertListEquals;
+import static org.apache.hadoop.mrunit.ExtendedAssert.assertListEquals;
 import static org.junit.Assert.assertEquals;
 
 import java.io.IOException;
diff --git a/src/test/java/org/apache/hadoop/mrunit/TestReduceDriver.java b/src/test/java/org/apache/hadoop/mrunit/TestReduceDriver.java
index 119b8ef..0abbff4 100644
--- a/src/test/java/org/apache/hadoop/mrunit/TestReduceDriver.java
+++ b/src/test/java/org/apache/hadoop/mrunit/TestReduceDriver.java
@@ -17,7 +17,7 @@
  */
 package org.apache.hadoop.mrunit;
 
-import static org.apache.hadoop.mrunit.testutil.ExtendedAssert.assertListEquals;
+import static org.apache.hadoop.mrunit.ExtendedAssert.assertListEquals;
 
 import java.io.IOException;
 import java.util.ArrayList;
diff --git a/src/test/java/org/apache/hadoop/mrunit/TestTestDriver.java b/src/test/java/org/apache/hadoop/mrunit/TestTestDriver.java
index b0cce96..a189563 100644
--- a/src/test/java/org/apache/hadoop/mrunit/TestTestDriver.java
+++ b/src/test/java/org/apache/hadoop/mrunit/TestTestDriver.java
@@ -17,7 +17,7 @@
  */
 package org.apache.hadoop.mrunit;
 
-import static org.apache.hadoop.mrunit.testutil.ExtendedAssert.assertListEquals;
+import static org.apache.hadoop.mrunit.ExtendedAssert.assertListEquals;
 import static org.junit.Assert.assertEquals;
 
 import java.util.ArrayList;
diff --git a/src/test/java/org/apache/hadoop/mrunit/mapreduce/TestMapDriver.java b/src/test/java/org/apache/hadoop/mrunit/mapreduce/TestMapDriver.java
index 66cdc5e..7eaff18 100644
--- a/src/test/java/org/apache/hadoop/mrunit/mapreduce/TestMapDriver.java
+++ b/src/test/java/org/apache/hadoop/mrunit/mapreduce/TestMapDriver.java
@@ -17,7 +17,7 @@
  */
 package org.apache.hadoop.mrunit.mapreduce;
 
-import static org.apache.hadoop.mrunit.testutil.ExtendedAssert.assertListEquals;
+import static org.apache.hadoop.mrunit.ExtendedAssert.assertListEquals;
 import static org.junit.Assert.assertEquals;
 
 import java.io.IOException;
diff --git a/src/test/java/org/apache/hadoop/mrunit/mapreduce/TestMapReduceDriver.java b/src/test/java/org/apache/hadoop/mrunit/mapreduce/TestMapReduceDriver.java
index 7de675a..05ead70 100644
--- a/src/test/java/org/apache/hadoop/mrunit/mapreduce/TestMapReduceDriver.java
+++ b/src/test/java/org/apache/hadoop/mrunit/mapreduce/TestMapReduceDriver.java
@@ -17,7 +17,7 @@
  */
 package org.apache.hadoop.mrunit.mapreduce;
 
-import static org.apache.hadoop.mrunit.testutil.ExtendedAssert.assertListEquals;
+import static org.apache.hadoop.mrunit.ExtendedAssert.assertListEquals;
 import static org.junit.Assert.assertEquals;
 
 import java.io.IOException;
diff --git a/src/test/java/org/apache/hadoop/mrunit/mapreduce/TestReduceDriver.java b/src/test/java/org/apache/hadoop/mrunit/mapreduce/TestReduceDriver.java
index 978d5fb..38e506e 100644
--- a/src/test/java/org/apache/hadoop/mrunit/mapreduce/TestReduceDriver.java
+++ b/src/test/java/org/apache/hadoop/mrunit/mapreduce/TestReduceDriver.java
@@ -18,7 +18,7 @@
 
 package org.apache.hadoop.mrunit.mapreduce;
 
-import static org.apache.hadoop.mrunit.testutil.ExtendedAssert.assertListEquals;
+import static org.apache.hadoop.mrunit.ExtendedAssert.assertListEquals;
 import static org.junit.Assert.assertEquals;
 
 import java.io.IOException;