长沙专业做网站公司,开发一个网站一般需要多少钱,射阳做企业网站哪家好,做二手网站有哪些问题idea内置junit5在通过JUnit和Hamcrest改善对assertEquals的文章中#xff0c;我简要讨论了Hamcrest “ 核心 ”匹配器与JUnit的现代版本“结合”在一起的情况。 在那篇文章中#xff0c;我特别关注了JUnit的assertThat#xff08;T#xff0c;Matcher#xff09;静态方法与… idea内置junit5 在通过JUnit和Hamcrest改善对assertEquals的文章中我简要讨论了Hamcrest “ 核心 ”匹配器与JUnit的现代版本“结合”在一起的情况。 在那篇文章中我特别关注了JUnit的assertThatTMatcher静态方法与Hamcrest核心is()匹配器的结合使用该方法自动包含在更高版本的JUnit中。 在本文中我将介绍与最新版本的JUnit捆绑在一起的其他Hamcrest“核心”匹配器。 JUnit包括开箱即用的Hamcrest “核心”匹配器的两个优点是无需专门下载Hamcrest也无需在单元测试类路径中明确包含它。 在查看更多方便的Hamcrest“核心”匹配器之前重要的是要在此指出我有意重复提及“核心” Hamcrest匹配器因为JUnit的最新版本仅提供“核心” 并非全部 Hamcrest匹配器自动。 仍然需要单独下载核心匹配器之外的任何Hamcrest匹配器并在单元测试类路径上明确指定。 了解什么是Hamcrest“核心”以及在最新版本的JUnit中默认情况下可用的匹配器的一种方法是查看该程序包的基于Javadoc的API文档 从JUnit提供的org.hamcrest.core软件包的文档中我们可以找到以下匹配器及其描述 类 Javadoc类说明 覆盖这里 AllOf T 计算两个匹配器的逻辑合。 是 AnyOf T 计算两个匹配器的逻辑和。 是 DescribedAs T 为另一个匹配器提供自定义描述。 是 是T 装饰另一个Matcher保留其行为但允许测试更具表现力。 再次 IsAnything T 始终返回true的匹配器。 没有 IsEqual T 根据Object.equalsjava.lang.ObjectinvokedMethod测试该值是否等于另一个值 是 IsInstanceOf 测试值是否为类的实例。 是 IsNot T 计算匹配器的逻辑取反。 是 IsNull T 值是否为空 是 IsSame T 该值与另一个值是同一对象吗 是 在我先前的演示Hamcrest is()匹配器与JUnit的assertThat()结合使用的文章中我使用了IntegerArithmetic实现作为测试工具。 我将在这里再次使用它来演示其他一些Hamcrest核心匹配器。 为方便起见该类复制如下。 IntegerArithmetic.java package dustin.examples;/*** Simple class supporting integer arithmetic.* * author Dustin*/
public class IntegerArithmetic
{/*** Provide the product of the provided integers.* * param firstInteger First integer to be multiplied.* param secondInteger Second integer to be multiplied.* param integers Integers to be multiplied together for a product.* return Product of the provided integers.* throws ArithmeticException Thrown in my product is too small or too large* to be properly represented by a Java integer.*/public int multiplyIntegers(final int firstInteger, final int secondInteger, final int ... integers){int returnInt firstInteger * secondInteger;for (final int integer : integers){returnInt * integer;}return returnInt;}
} 在“ 使用JUnit和Hamcrest改进assertEquals”中 我主要依靠is()来比较预期结果和实际结果以测试整数乘法。 另一个选择是使用equalTo匹配器如下面的代码清单所示。 使用Hamcrest equalTo /*** Test of multiplyIntegers method, of class IntegerArithmetic, using core* Hamcrest matcher equalTo.*/Testpublic void testWithJUnitHamcrestEqualTo(){final int[] integers {4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15};final int expectedResult 2 * 3 * 4 * 5 * 6 * 7 * 8 * 9 * 10 * 11 * 12 *13 * 14 * 15;final int result this.instance.multiplyIntegers(2, 3, integers);assertThat(result, equalTo(expectedResult));} 尽管不是必需的但有些开发人员喜欢将is和equalTo一起使用因为它们对他们来说更流利。 这就是is的存在的原因更流畅地使用其他匹配器。 我经常equalTo()使用is() 暗示equalTo() 如通过JUnit和Hamcrest改进对assertEquals所讨论的。 下一个示例演示了将is()匹配器与equalTo匹配器结合使用。 将Hamcrest equalTo与is结合使用 /*** Test of multiplyIntegers method, of class IntegerArithmetic, using core* Hamcrest matcher equalTo with is Matcher..*/Testpublic void testWithJUnitHamcrestEqualToAndIsMatchers(){final int[] integers {4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15};final int expectedResult 2 * 3 * 4 * 5 * 6 * 7 * 8 * 9 * 10 * 11 * 12 *13 * 14 * 15;final int result this.instance.multiplyIntegers(2, 3, integers);assertThat(result, is(equalTo(expectedResult)));} equalTo Hamcrest匹配器执行类似于调用Object.equalsObject的比较。 实际上其比较功能依赖于底层对象的equals(Object)实现的使用。 这意味着最后两个示例将通过因为所比较的数字在逻辑上是等效的。 当想要确保更大的身份相等性时实际上是相同的对象而不仅仅是相同的逻辑内容可以使用Hamcrest sameInstance匹配器如下面的代码清单所示。 因为断言是正确的所以也应用了not匹配器因为只有预期的和实际的结果不是相同的实例因此测试仅在“不”的情况下通过测试 使用Hamcrest sameInstance和not /*** Test of multiplyIntegers method, of class IntegerArithmetic, using core* Hamcrest matchers not and sameInstance.*/Testpublic void testWithJUnitHamcrestNotSameInstance(){final int[] integers {4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15};final int expectedResult 2 * 3 * 4 * 5 * 6 * 7 * 8 * 9 * 10 * 11 * 12 *13 * 14 * 15;final int result this.instance.multiplyIntegers(2, 3, integers);assertThat(result, not(sameInstance(expectedResult)));} 有时需要控制从失败的单元测试的断言中输出的文本。 JUnit包括核心Hamcrest匹配器asDescribed()来支持此功能。 下一个清单中显示了这样的代码示例代码清单后的NetBeans IDE的屏幕快照中显示了失败测试和相应的断言的输出。 将Hamcrest asDescribed与sameInstance一起使用 /*** Test of multiplyIntegers method, of class IntegerArithmetic, using core* Hamcrest matchers sameInstance and asDescribed. This one will assert a* failure so that the asDescribed can be demonstrated (dont do this with* your unit tests as home)!*/Testpublic void testWithJUnitHamcrestSameInstanceDescribedAs(){final int[] integers {4, 5, 6, 7, 8, 9, 10, 11, 12, 13, 14, 15};final int expectedResult 2 * 3 * 4 * 5 * 6 * 7 * 8 * 9 * 10 * 11 * 12 *13 * 14 * 15;final int result this.instance.multiplyIntegers(2, 3, integers);assertThat(result,describedAs(Not same object (different identity reference),sameInstance(expectedResult)));} 当关联的单元测试断言失败时使用describedAs()允许报告更有意义的消息。 现在我将使用另一个人为设计的类来帮助说明最新版本的JUnit可用的其他核心Hamcrest匹配器。 接下来显示“需要测试”。 SetFactory.java package dustin.examples;import java.lang.reflect.InvocationTargetException;
import java.util.*;
import java.util.logging.Level;
import java.util.logging.Logger;/*** A Factory that provides an implementation of a Set interface based on* supplied SetType that indicates desired type of Set implementation.* * author Dustin*/
public class SetFactoryT extends Object
{public enum SetType{ENUM(EnumSet.class),HASH(HashSet.class),SORTED(SortedSet.class), // SortedSet is an interface, not implementationTREE(TreeSet.class),RANDOM(Set.class); // Set is an interface, not a concrete collectionprivate Class setTypeImpl null;SetType(final Class newSetType){this.setTypeImpl newSetType;}public Class getSetImplType(){return this.setTypeImpl;}}private SetFactory() {}public static SetFactory newInstance(){return new SetFactory();}/*** Creates a Set using implementation corresponding to the provided Set Type* that has a generic parameterized type of that specified.* * param setType Type of Set implementation to be used.* param parameterizedType Generic parameterized type for the new set.* return Newly constructed Set of provided implementation type and using* the specified generic parameterized type; null if either of the provided* parameters is null.* throws ClassCastException Thrown if the provided SetType is SetType.ENUM,* but the provided parameterizedType is not an Enum.*/public SetT createSet(final SetType setType, final ClassT parameterizedType){if (setType null || parameterizedType null){return null;}SetT newSet null;try{switch (setType){case ENUM:if (parameterizedType.isEnum()){newSet EnumSet.noneOf((ClassEnum)parameterizedType);}else{throw new ClassCastException(Provided SetType of ENUM being supplied with parameterized type that is not an enum [ parameterizedType.getName() ].);}break;case RANDOM:newSet LinkedHashSet.class.newInstance();break;case SORTED:newSet TreeSet.class.newInstance();break;default:newSet (SetT) setType.getSetImplType().getConstructor().newInstance();break;}}catch ( InstantiationException| IllegalAccessException| IllegalArgumentException| InvocationTargetException| NoSuchMethodException ex){Logger.getLogger(SetFactory.class.getName()).log(Level.SEVERE, null, ex);}return newSet;}
} 刚刚显示了代码的人为的类提供了使用其他Hamcrest“核心”匹配器的机会。 如上所述可以将所有这些匹配与is匹配器一起使用以提高语句的流畅性。 两个有用的“核心”的匹配是nullValue()和notNullValue()这两者在未来基于JUnit的代码列表被证实和is结合使用在一种情况下。 使用Hamcrest nullValue和notNullValue /*** Test of createSet method, of class SetFactory, with null SetType passed.*/Testpublic void testCreateSetNullSetType(){final SetFactory factory SetFactory.newInstance();final SetString strings factory.createSet(null, String.class);assertThat(strings, nullValue());}/*** Test of createSet method, of class SetFactory, with null parameterized type* passed.*/Testpublic void testCreateSetNullParameterizedType(){final SetFactory factory SetFactory.newInstance();final SetString strings factory.createSet(SetType.TREE, null);assertThat(strings, is(nullValue()));}Testpublic void testCreateTreeSetOfStringsNotNullIfValidParams(){final SetFactory factory SetFactory.newInstance();final SetString strings factory.createSet(SetType.TREE, String.class);assertThat(strings, notNullValue());} Hamcrest匹配器instanceOf也很有用并在下一个代码清单中进行演示一个单独使用instanceOf的示例和一个与is一起使用的示例。 使用Hamcrest instanceOf Testpublic void testCreateTreeSetOfStringsIsTreeSet(){final SetFactory factory SetFactory.newInstance();final SetString strings factory.createSet(SetType.TREE, String.class);assertThat(strings, is(instanceOf(TreeSet.class)));}Testpublic void testCreateEnumSet(){final SetFactory factory SetFactory.newInstance();final SetRoundingMode roundingModes factory.createSet(SetType.ENUM, RoundingMode.class);roundingModes.add(RoundingMode.UP);assertThat(roundingModes, instanceOf(EnumSet.class));} 到目前为止许多Hamcrest核心匹配器都提供了更高的流畅性和可读性但出于更多原因我喜欢接下来的两个匹配器。 Hamcrest hasItem()匹配器检查集合中指定项的存在更有用的Hamcrest hasItems()匹配器检查集合中多个规定项的存在。 在代码中更容易看到这一点下面的代码演示了它们的实际作用。 使用Hamcrest hasItem和hasItems Testpublic void testCreateTreeSetOfStringsHasOneOfAddedStrings(){final SetFactory factory SetFactory.newInstance();final SetString strings factory.createSet(SetType.TREE, String.class);strings.add(Tucson);strings.add(Arizona);assertThat(strings, hasItem(Tucson));}Testpublic void testCreateTreeSetOfStringsHasAllOfAddedStrings(){final SetFactory factory SetFactory.newInstance();final SetString strings factory.createSet(SetType.TREE, String.class);strings.add(Tucson);strings.add(Arizona);assertThat(strings, hasItems(Tucson, Arizona));} 有时需要测试某种测试方法的结果以确保它满足各种各样的期望。 这就是Hamcrest allOf匹配器派上用场的地方。 此匹配器确保所有条件表示为匹配器都为真。 在下面的代码清单中对此进行了说明该清单测试了一个断言即所生成的Set不为null具有两个特定的String且是TreeSet的实例。 使用Hamcrest allOf Testpublic void testCreateSetAllKindsOfGoodness(){final SetFactory factory SetFactory.newInstance();final SetString strings factory.createSet(SetType.TREE, String.class);strings.add(Tucson);strings.add(Arizona);assertThat(strings,allOf(notNullValue(), hasItems(Tucson, Arizona), instanceOf(TreeSet.class)));} 为了演示Hamcrest核心“ anyOf”匹配器提供了现成的JUnit更新版本我将使用另一个需要单元测试的可笑的Java类。 今天.java package dustin.examples;import java.util.Calendar;
import java.util.Locale;/*** Provide what day of the week today is.* * author Dustin*/
public class Today
{/*** Provide the day of the week of todays date.* * return Integer representing todays day of the week, corresponding to* static fields defined in Calendar class.*/public int getTodayDayOfWeek(){return Calendar.getInstance(Locale.US).get(Calendar.DAY_OF_WEEK);}
} 现在我需要测试上述类中的唯一方法是否正确返回了代表星期几的有效整数。 我希望我的测试确保返回代表星期天到星期六的一天的有效整数但是要测试的方法是这样的使得它可能与任何给定的测试运行都不是一周中的同一天。 下面的代码清单指示如何使用包含JUnit的Hamcrest“ anyOf”匹配器进行测试。 使用Hamcrest anyOf /*** Test of getTodayDayOfWeek method, of class Today.*/Testpublic void testGetTodayDayOfWeek(){final Today instance new Today();final int todayDayOfWeek instance.getTodayDayOfWeek();assertThat(todayDayOfWeek,describedAs(Day of week not in range.,anyOf(is(Calendar.SUNDAY),is(Calendar.MONDAY),is(Calendar.TUESDAY),is(Calendar.WEDNESDAY),is(Calendar.THURSDAY),is(Calendar.FRIDAY),is(Calendar.SATURDAY))));} 尽管Hamcrest的allOf要求所有条件都必须匹配才能避免断言但任何一个条件的存在足以确保anyOf不会导致失败的断言。 我最喜欢的确定JUnit可用的核心Hamcrest匹配器的方法是在Java IDE中使用导入完成。 当我静态导入org.hamcrest.CoreMatchers.*软件包内容时将显示所有可用的匹配器。 我可以在IDE中查看*代表什么以查看对我可用的匹配器。 JUnit包含Hamcrest“核心”匹配器真是太好了这篇文章试图演示其中的大多数。 Hamcrest在“核心”之外还提供了许多有用的匹配器它们也很有用。 有关详细信息请参见Hamcrest教程 。 参考在Inspired by Actual Events博客上我们的JCG合作伙伴 Dustin Marx提供了JUnit的内置Hamcrest Core Matcher支持 。 翻译自: https://www.javacodegeeks.com/2012/06/junits-built-in-hamcrest-core-matcher.htmlidea内置junit5
