在JUnit4中使用参数化测试时,有没有办法设置我自己的自定义测试用例名称?
我想将默认值 - 更改为[Test class].runTest[n]
有意义的内容.
此功能已进入JUnit 4.11.
要使用更改参数化测试的名称,您可以说:
@Parameters(name="namestring")
namestring
是一个字符串,可以有以下特殊占位符:
{index}
- 这组参数的索引.默认namestring
是{index}
.
{0}
- 来自此测试调用的第一个参数值.
{1}
- 第二个参数值
等等
测试的最终名称将是测试方法的名称,后面是namestring
括号,如下所示.
例如(改编自Parameterized
注释的单元测试):
@RunWith(Parameterized.class) static public class FibonacciTest { @Parameters( name = "{index}: fib({0})={1}" ) public static Iterable
会给出像testFib[1: fib(1)=1]
和的名字testFib[4: fib(4)=3]
.(testFib
名称的一部分是方法名称@Test
).
看看JUnit 4.5,它的运行者显然不支持它,因为该逻辑被隐藏在Parameterized类中的私有类中.您无法使用JUnit参数化运行器,而是创建自己的运行器,这将理解名称的概念(这导致您可能如何设置名称的问题......).
从JUnit的角度来看,如果不是(或除了)只是传递一个增量,它们会传递逗号分隔的参数.TestNG就是这么做的.如果该功能对您很重要,您可以在www.junit.org上引用的yahoo邮件列表上发表评论.
我最近在使用JUnit 4.3.1时遇到了同样的问题.我实现了一个扩展Parameterized的新类,名为LabelledParameterized.它已使用JUnit 4.3.1,4.4和4.5进行了测试.它使用@Parameters方法中每个参数数组的第一个参数的String表示来重构Description实例.您可以在以下位置查看此代码:
http://code.google.com/p/migen/source/browse/trunk/java/src/.../LabelledParameterized.java?r=3789
以及它在以下地方使用的一个例子:
http://code.google.com/p/migen/source/browse/trunk/java/src/.../ServerBuilderTest.java?r=3789
测试描述在Eclipse中很好地格式化,这是我想要的,因为这使得失败的测试更容易找到!我可能会在接下来的几天/几周内进一步完善和记录课程.放下'?' 如果你想要最前沿的URL的一部分.:-)
要使用它,您所要做的就是复制该类(GPL v3),并将@RunWith(Parameterized.class)更改为@RunWith(LabelledParameterized.class),假设参数列表的第一个元素是一个合理的标签.
我不知道JUnit的任何后续版本是否解决了这个问题,但即使他们这样做了,我也无法更新JUnit,因为我的所有联合开发人员也必须更新,我们的优先级高于重新加工.因此,类中的工作可以由多个版本的JUnit进行编译.
注意:有一些反射jiggery-pokery,因此它运行在上面列出的不同JUnit版本.可以在此处找到专门针对JUnit 4.3.1的版本,对于JUnit 4.4和4.5,可以在此处找到.
随着Parameterized
作为一种模式,我写我自己的自定义测试跑步/套件-只花了约半小时.它与darrenp略有不同LabelledParameterized
,因为它允许您明确指定名称而不是依赖于第一个参数toString()
.
它也不使用数组,因为我讨厌数组.:)
public class PolySuite extends Suite { // ////////////////////////////// // Public helper interfaces /** * Annotation for a method which returns a {@link Configuration} * to be injected into the test class constructor */ @Retention(RetentionPolicy.RUNTIME) @Target(ElementType.METHOD) public static @interface Config { } public static interface Configuration { int size(); Object getTestValue(int index); String getTestName(int index); } // ////////////////////////////// // Fields private final Listrunners; // ////////////////////////////// // Constructor /** * Only called reflectively. Do not use programmatically. * @param c the test class * @throws Throwable if something bad happens */ public PolySuite(Class> c) throws Throwable { super(c, Collections. emptyList()); TestClass testClass = getTestClass(); Class> jTestClass = testClass.getJavaClass(); Configuration configuration = getConfiguration(testClass); List runners = new ArrayList (); for (int i = 0, size = configuration.size(); i < size; i++) { SingleRunner runner = new SingleRunner(jTestClass, configuration.getTestValue(i), configuration.getTestName(i)); runners.add(runner); } this.runners = runners; } // ////////////////////////////// // Overrides @Override protected List getChildren() { return runners; } // ////////////////////////////// // Private private Configuration getConfiguration(TestClass testClass) throws Throwable { return (Configuration) getConfigMethod(testClass).invokeExplosively(null); } private FrameworkMethod getConfigMethod(TestClass testClass) { List methods = testClass.getAnnotatedMethods(Config.class); if (methods.isEmpty()) { throw new IllegalStateException("@" + Config.class.getSimpleName() + " method not found"); } if (methods.size() > 1) { throw new IllegalStateException("Too many @" + Config.class.getSimpleName() + " methods"); } FrameworkMethod method = methods.get(0); int modifiers = method.getMethod().getModifiers(); if (!(Modifier.isStatic(modifiers) && Modifier.isPublic(modifiers))) { throw new IllegalStateException("@" + Config.class.getSimpleName() + " method \"" + method.getName() + "\" must be public static"); } return method; } // ////////////////////////////// // Helper classes private static class SingleRunner extends BlockJUnit4ClassRunner { private final Object testVal; private final String testName; SingleRunner(Class> testClass, Object testVal, String testName) throws InitializationError { super(testClass); this.testVal = testVal; this.testName = testName; } @Override protected Object createTest() throws Exception { return getTestClass().getOnlyConstructor().newInstance(testVal); } @Override protected String getName() { return testName; } @Override protected String testName(FrameworkMethod method) { return testName + ": " + method.getName(); } @Override protected void validateConstructor(List errors) { validateOnlyOneConstructor(errors); } @Override protected Statement classBlock(RunNotifier notifier) { return childrenInvoker(notifier); } } }
一个例子:
@RunWith(PolySuite.class) public class PolySuiteExample { // ////////////////////////////// // Fixture @Config public static Configuration getConfig() { return new Configuration() { @Override public int size() { return 10; } @Override public Integer getTestValue(int index) { return index * 2; } @Override public String getTestName(int index) { return "test" + index; } }; } // ////////////////////////////// // Fields private final int testVal; // ////////////////////////////// // Constructor public PolySuiteExample(int testVal) { this.testVal = testVal; } // ////////////////////////////// // Test @Ignore @Test public void odd() { assertFalse(testVal % 2 == 0); } @Test public void even() { assertTrue(testVal % 2 == 0); } }
从junit4.8.2开始,您只需复制Parameterized类即可创建自己的MyParameterized类.更改TestClassRunnerForParameters中的getName()和testName()方法.
您可能还想尝试JUnitParams:http://code.google.com/p/junitparams/