首页 > 代码库 > 【JUnit4.10源码分析】6.1 排序和过滤
【JUnit4.10源码分析】6.1 排序和过滤
abstract class ParentRunner<T> extends Runner implements Filterable,Sortable
本节介绍排序和过滤。
(尽管JUnit4.8.2源码分析-6.1 排序和过滤中演示了客户使用排序和过滤的方式,也有些不明确其设计意图。可是。先读懂源码为妙。说不定看着看着就明确了。
)
org.junit.runner.manipulation包
排序和过滤的相关类型。在org.junit.runner.manipulation包中。Sortable和Filterable是两个依赖注入接口。而Sorter和Filter的apply是注入方法。
1.比如Sortable是一个函数接口。yqj2065认为Sortable.sort(Sorter)不如叫Sortable.setSorter(Sorter)。
package org.junit.runner.manipulation; public interface Sortable { public void sort(Sorter sorter); }2.Filterable类似,定义了void filter(Filter filter) throws NoTestsRemainException;
3.NoTestsRemainException抱怨filter 将全部的測试都过滤掉了。
4.Sorter implements Comparator<Description>。我们知道。java.util.Comparator接口是一个策略类,定义了int compare(T o1, T o2)方法。而Sorter是一个简单的代理模式的Proxy角色。
通过构造器注入的方式Sorter(Comparator<Description>comparator)初始化realSubject角色。測试程序猿能够定义自己的排序器。并且。Sorter应用Null
Object模式,定义了NULL静态内部子类。
package org.junit.runner.manipulation; import java.util.Comparator; import org.junit.runner.Description; public class Sorter implements Comparator<Description> { /** * NULL is a <code>Sorter</code> that leaves elements in an undefined order */ public static Sorter NULL= new Sorter(new Comparator<Description>() { public int compare(Description o1, Description o2) { return 0; }});
public void apply(Object object) { if (object instanceof Sortable) { Sortable sortable = (Sortable) object; sortable.sort(this); } } }Sorter的方法apply(Object object),将this应用于Object 身上。
5.Filter是一个抽象类。当须要过滤某些測试时。測试程序猿要定义自己的过滤器。
Filter应用Null Object模式,定义了ALL静态内部子类。静态工厂生成public static Filter matchMethodDescription(final Description desiredDescription)。而public Filter intersect(final Filter second)同意多个Filter串接。
依照上述几个样例,我们能够写出自己的过滤器。
package sortFilter; import java.util.Arrays; import java.util.HashSet; import java.util.Set; import org.junit.runner.Description; import org.junit.runner.manipulation.Filter; /** *排除指定的方法。 * @author yqj2065 */ public class MethodNameFilter extends Filter { private final Set<String> excludedMethods = new HashSet<>(); public MethodNameFilter(String... excludedMethods) { this.excludedMethods.addAll(Arrays.asList(excludedMethods)); } @Override public boolean shouldRun(Description description) { String methodName = description.getMethodName(); return !excludedMethods.contains(methodName); } @Override public String describe() { return this.getClass().getSimpleName() + "-excluded methods: " + excludedMethods; } }Unit4有測试方法a() 、@Ignore b() 、c() 和d()等,
package demo; import static tool.Print.*; import org.junit.runner.manipulation.NoTestsRemainException; import org.junit.runner.notification.RunNotifier; import org.junit.runners.BlockJUnit4ClassRunner; import org.junit.runners.model.InitializationError; import sortFilter.MethodNameFilter; import units.Unit4; /** * * @author yqj2065 */ public class FilterDemo { public static void main(String... args) { try { BlockJUnit4ClassRunner runner = null; try { runner = new BlockJUnit4ClassRunner(Unit4.class); } catch (InitializationError e) { } runner.filter(new MethodNameFilter("a","b","c", "d"));//排除全部 runner.run(new RunNotifier()); } catch (NoTestsRemainException ex) { pln(ex); } } }输出:org.junit.runner.manipulation.NoTestsRemainException
保留@Ignore b(),尽管没有运行測试。可是不抛出异常。
ParentRunner<T>与排序和过滤
ParentRunner implements Filterable,Sortable
注意到:JUnit4.8.2中ParentRunner 有域Filter fFilter= null;而JUnit4.10不再有该域。而是以过滤后的private List<T> fFilteredChildren= null代替。
因为ParentRunner<T>的类型參数T,代表其某种孩子的类型。BlockJUnit4ClassRunner的T为FrameworkMethod。Suite的T为Runner。
在ParentRunner中统一地处理T显得比較复杂。并且JUnit4.10代码变化较大。
过滤相关的代码
getFilteredChildren()惰性初始化域fFilteredChildren,当中调用getChildren()由子类给出实现,返回List<T>。@Override filter(Filter filter),就须要差别对待FrameworkMethod和Runner。
1.JUnit没有使用instanceof。而是利用abstract Description describeChild(T child),无论T是FrameworkMethod还是Runner。总能够构造(FrameworkMethod)或获得(Runner)一个Description返回值;
2.而Filter定义的public abstract boolean shouldRun(Description description),能够统一处理两者。
3.因而。ParentRunner定义了boolean shouldRun(Filter filter, T each) ,调用前者。
可是,从实际參数看,filter.shouldRun(FrameworkMethod的Description )才进行比較和过滤;而filter.shouldRun(Runner.getDescription ),总是返回true、
于是,第5行代码if (shouldRun(filter, each))出现有意思的情况。
对于FrameworkMethod each。假设shouldRun,其代码应该为
try {
//
} catch (NoTestsRemainException e) {
iter.remove();
}
由于filter.apply(FrameworkMethod )肯定直接return;而shouldRun推断不通过,就意味着iter.remove();在fFilteredChildren中删除该方法;
对于Runner each。总是shouldRun,并且运行filter.apply(each);从而调用到each.filter(filter);能够看出。假设没有FrameworkMethod ,能够直接运行each.filter(filter);可是如今不得不打乒乓球。利用filter.apply(each)排除掉FrameworkMethod
。
private List<T> fFilteredChildren= null; public void filter(Filter filter) throws NoTestsRemainException { for (Iterator<T> iter = getFilteredChildren().iterator(); iter.hasNext(); ) { T each = iter.next(); if (shouldRun(filter, each)) try { filter.apply(each); } catch (NoTestsRemainException e) { iter.remove(); } else iter.remove(); } if (getFilteredChildren().isEmpty()) { throw new NoTestsRemainException(); } } private List<T> getFilteredChildren() { if (fFilteredChildren == null) fFilteredChildren = new ArrayList<T>(getChildren()); return fFilteredChildren; } private boolean shouldRun(Filter filter, T each) { return filter.shouldRun(describeChild(each)); }
作为比較,JUnit4.8.2的相关代码列在以下,有时间再看。
private Filter fFilter= null; public void filter(Filter filter) throws NoTestsRemainException { fFilter= filter; for (T each : getChildren()) if (shouldRun(each)) return; throw new NoTestsRemainException(); } private List<T> getFilteredChildren() { ArrayList<T> filtered= new ArrayList<T>(); for (T each : getChildren()) if (shouldRun(each)) try { filterChild(each); sortChild(each); filtered.add(each); } catch (NoTestsRemainException e) { // don‘t add it } Collections.sort(filtered, comparator()); return filtered; } private void filterChild(T child) throws NoTestsRemainException { if (fFilter != null) fFilter.apply(child); } private boolean shouldRun(T each) { return fFilter == null || fFilter.shouldRun(describeChild(each)); }
排序的非常easy。略。
【JUnit4.10源码分析】6.1 排序和过滤