在JUnit中超越核心Hamcrest

在通过JUnit和Hamcrest改进对assertEquals的文章中，我介绍了将Hamcrest与JUnit一起使用。然后，我查看了JUnit的内置Hamcrest Core Matcher支持。在本文中，我将介绍如何将Hamcrest的非核心匹配器与JUnit一起应用。这些非核心匹配器默认情况下不包含在JUnit中，但可以通过在类路径中包含Hamcrest JAR来使用。

尽管JUnit包含Hamcrest核心匹配器，如果只想使用核心匹配器，则使它们更易于使用，但这种包含可能使非核心匹配器的使用更加困难，这是一个众所周知的问题。

由于JUnit不包含非核心Hamcrest匹配器，因此需要下载 Hamcrest JAR。对于本文中的示例，我正在使用hamcrest-all-1.2.jar 。

下一个屏幕快照显示了将所有繁琐的JAR与常规JUnit库（在本例中为NetBeans 7.2 beta提供的JUnit 4.10）组合在一起时遇到的问题。如屏幕快照所示，在hamcrest-all-1.2.jar之前，当junit-4.10.jar包含在NetBeans库中时，先前的工作代码（来自我的上 hamcrest-all-1.2.jar 文章）会中断。 NetBeans和命令行编译器均在此屏幕快照中显示此损坏。

切换测试库的顺序，以便首先列出Hamcrest库，然后列出其后的JUnit JAR，这会使编译器中断测试代码。这显示在下一个屏幕快照中。

尽管切换依赖库的顺序，以便在JUnit JAR确实防止构建问题之前就包含Hamcrest JAR，但这通常不是令人满意的方法。这种方法对于长期可维护性来说太脆弱了。幸运的是，JUnit直接支持一种更好的方法来处理此问题。

可以下载特殊的无Hamcrest的JUnit JAR。下一个屏幕快照显示了本示例中使用的快照： junit-dep-4.10.jar 。 JAR名称中的-dep是不包含Hamcrest的线索。下载页面上JAR旁边的符号（下图显示了屏幕快照）也指出了这一点（“无障碍的JAR”）。

借助JUnit JAR的无Hamcrest“ dep”版本，我可以在与Hamcrest JAR相关的任何时候将其包含在测试库中，并且仍然可以构建测试代码。这比依赖于特定顺序的测试库更有利。下一个图像显示了NetBeans的屏幕快照，并且即使首先列出了JUnit JAR，命令行构建仍然成功。

使用适当的库（JUnit-dep JAR和Hamcrest“ all” JAR）后，所有Hamcrest的匹配器都可以与基于JUnit的测试一起使用。除了与JUnit捆绑在一起的核心匹配之外，Hamcrest还提供了许多匹配器。了解可用的其他匹配器的一种方法是查看Hamcrest JAR中的类。以下是对Hamcrest JAR运行jar tvf命令并删除许多条目以留下一些最有趣的条目的输出。 “核心”匹配器倾向于基于“核心”程序包中的类，而非核心匹配器倾向于基于所有其他程序包中其名称中没有“核心”的类。

4029 Thu May 21 23:21:20 MDT 2009 org/hamcrest/core /AllOf.java3592 Thu May 21 23:21:20 MDT 2009 org/hamcrest/ core /AnyOf.java1774 Thu May 21 23:21:20 MDT 2009 org/hamcrest/ core /CombinableMatcher.java1754 Thu May 21 23:21:20 MDT 2009 org/hamcrest/ core /DescribedAs.java1104 Thu May 21 23:21:20 MDT 2009 org/hamcrest/ core /Every.java2088 Thu May 21 23:21:20 MDT 2009 org/hamcrest/ core /Is.java1094 Thu May 21 23:21:20 MDT 2009 org/hamcrest/ core /IsAnything.java2538 Thu May 21 23:21:20 MDT 2009 org/hamcrest/ core /IsCollectionContaining.java1862 Thu May 21 23:21:20 MDT 2009 org/hamcrest/ core /IsEqual.java2882 Thu May 21 23:21:20 MDT 2009 org/hamcrest/ core /IsInstanceOf.java1175 Thu May 21 23:21:20 MDT 2009 org/hamcrest/ core /IsNot.java1230 Thu May 21 23:21:20 MDT 2009 org/hamcrest/ core /IsNull.java960 Thu May 21 23:21:20 MDT 2009 org/hamcrest/ core /IsSame.java675 Thu May 21 23:21:20 MDT 2009 org/hamcrest/ core /StringContains.java667 Thu May 21 23:21:20 MDT 2009 org/hamcrest/ core /StringEndsWith.java678 Thu May 21 23:21:20 MDT 2009 org/hamcrest/ core /StringStartsWith.java2557 Thu May 21 23:21:20 MDT 2009 org/hamcrest/collection/IsArray.java1805 Thu May 21 23:21:20 MDT 2009 org/hamcrest/collection/IsArrayContaining.java1883 Thu May 21 23:21:20 MDT 2009 org/hamcrest/collection/IsArrayContainingInAnyOrder.java1765 Thu May 21 23:21:20 MDT 2009 org/hamcrest/collection/IsArrayContainingInOrder.java1388 Thu May 21 23:21:20 MDT 2009 org/hamcrest/collection/IsArrayWithSize.java1296 Thu May 21 23:21:20 MDT 2009 org/hamcrest/collection/IsCollectionWithSize.java812 Thu May 21 23:21:20 MDT 2009 org/hamcrest/collection/IsEmptyCollection.java866 Thu May 21 23:21:20 MDT 2009 org/hamcrest/collection/IsEmptyIterable.java1086 Thu May 21 23:21:20 MDT 2009 org/hamcrest/collection/IsIn.java3426 Thu May 21 23:21:20 MDT 2009 org/hamcrest/collection/IsIterableContainingInAnyOrder.java3479 Thu May 21 23:21:20 MDT 2009 org/hamcrest/collection/IsIterableContainingInOrder.java993 Thu May 21 23:21:20 MDT 2009 org/hamcrest/collection/IsIterableWithSize.java1899 Thu May 21 23:21:20 MDT 2009 org/hamcrest/collection/IsMapContaining.java1493 Thu May 21 23:21:20 MDT 2009 org/hamcrest/collection/IsMapContainingKey.java1421 Thu May 21 23:21:20 MDT 2009 org/hamcrest/collection/IsMapContainingValue.java1380 Thu May 21 23:21:20 MDT 2009 org/hamcrest/number/IsCloseTo.java2878 Thu May 21 23:21:20 MDT 2009 org/hamcrest/number/OrderingComparison.java1082 Thu May 21 23:21:20 MDT 2009 org/hamcrest/object/HasToString.java918 Thu May 21 23:21:20 MDT 2009 org/hamcrest/object/IsCompatibleType.java2080 Thu May 21 23:21:20 MDT 2009 org/hamcrest/object/IsEventFrom.java1164 Thu May 21 23:21:20 MDT 2009 org/hamcrest/text/IsEmptyString.java1389 Thu May 21 23:21:20 MDT 2009 org/hamcrest/text/IsEqualIgnoringCase.java2058 Thu May 21 23:21:20 MDT 2009 org/hamcrest/text/IsEqualIgnoringWhiteSpace.java1300 Thu May 21 23:21:20 MDT 2009 org/hamcrest/text/StringContainsInOrder.java4296 Thu May 21 23:21:20 MDT 2009 org/hamcrest/xml/HasXPath.java