Espresso 自动化测试 (六) － onData()的使用

在上一篇文章我们已经知道了简单的onData的使用了，但是我们都知道，在真正的测试中，我们的ListView或者GridView不可能为这么简单的数据的，所以我们还是需要用一些复杂的数据来进行测试。

SimpleAdapter

对于Android有一定了解的应该都对它有一定的了解吧。

SimpleAdapter的构造函数是：

public SimpleAdapter (Context context, List<? extends Map<String, ?>> data, int resource, String[] from, int[] to)

我们就自己来简单实现一个SimleAdapter的Demo.

listView的具体布局如下：

<?xml version="1.0" encoding="utf-8"?><RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"    android:layout_width="match_parent"    android:layout_height="match_parent"    android:padding="10dip">    <TextView        android:id="@+id/rowContent1"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_alignParentLeft="true"        />    <TextView        android:id="@+id/rowContent2"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_below="@+id/rowContent1"        android:layout_marginTop="10dip"/>    <CheckBox        android:id="@+id/checkbox"        android:layout_width="wrap_content"        android:layout_height="wrap_content"        android:layout_alignParentRight="true"/></RelativeLayout>

SimpleAdapter的具体实现如下：

@VisibleForTesting    protected static Map<String, Object> makeItem(int forRow) {        Map<String, Object> dataRow = Maps.newHashMap();        dataRow.put(ROW_TEXT1, String.format(ITEM_TEXT_FORMAT, forRow));        dataRow.put(ROW_TEXT2, "YES");        dataRow.put(ROW_CHECKBOX,false);        return dataRow;    }    private void initData() {        for (int i = 0; i < NUMBER_OF_ITEMS; i++) {            data.add(makeItem(i));        }        String from[] = new String[]{ROW_TEXT1,ROW_TEXT2,ROW_CHECKBOX};        int to[] = new int[]{R.id.rowContent1,R.id.rowContent2,R.id.checkbox};        layoutInflater = getLayoutInflater();        MySimpleAdapter mySimpleAdapter = new MySimpleAdapter(this,data,R.layout.listview_item,from,to);        listView.setAdapter(mySimpleAdapter);    }

下来我们就要开始进行编写我们的测试代码了。

@RunWith(AndroidJUnit4.class)@LargeTestpublic class TestSimpleAdapter {    private static final String TEXT_ITEM_50 = "item: 95";    @Rule    public ActivityTestRule<MainActivity> mActivityRule = new ActivityTestRule<>(MainActivity.class);    //对内容为item: 95的那一项的checkbox进行点击操作。    @Test    public void testCheckBoxClick() {        onRow(TEXT_ITEM_50).onChildView(withId(R.id.checkbox)).perform(click());        onRow(TEXT_ITEM_50).onChildView(withId(R.id.checkbox)).check(matches(isChecked()));    }    public static DataInteraction onRow(String str) {        return  onData(hasEntry(is(MainActivity.ROW_TEXT1),is(str)));    }}

类对象

下面的例子我们参考 EspressoExamples 的例子
这个例子就是我们经常测试中都会碰到的了。

我们看上边的图片就能够发现，界面显示的内容都可以用一个类Book来描述，当然实际情况下，可能书的封面会根据不同的书显示，这些都可以在book这个类对象里面进行描述。

/** * @author vgrec, created on 3/18/15. */public class Book {    private int id;    private String title;    private String author;    public Book(int id, String title, String author) {        this.id = id;        this.title = title;        this.author = author;    }    public String getTitle() {        return title;    }    public String getAuthor() {        return author;    }    public int getId() {        return id;    }}

以上是Book类的定义, 它的成员变量以及方法，程序的其他代码这里就不贴出来了。大家可以自己去前面的链接去查看。

那下面问题来了，我需要点击书名为 “Effective Java“ 的书籍时，应该如何做呢。

首先我们可以指定一个单一条件

onData(is(instanceOf(Book.class)))

但是这个单一条件肯定是不能满足的，因为我现在要做的是点击对应的书名的item。所以我们需要更精确的去寻找一个AdapterView中指定的条目，于是我们需要用allof()来构造一个符合匹配的条件

onData(allOf(is(instanceOf(Book.class)), myCustomMatcher()))

上面的myCustomMatcher()方法构造了一个自定义的Matcher，我们可以采用自己的自定义Matcher来更加精准地进行数据的匹配。

自定义Matcher

下来就是我们自定义的Matcher:

public static Matcher<Object> withBookTitle(final String bookTitle) {    return new BoundedMatcher<Object, Book>(Book.class) {        @Override        protected boolean matchesSafely(Book book) {            return bookTitle.equals(book.getTitle());        }        @Override        public void describeTo(Description description) {            description.appendText("with id: " + bookTitle);        }    };}

我们对上面的内容分析一下吧。
1. @return Matcher

很显然，返回值必须是一个Matcher对象，代表一个针对于Object数据的匹配规则。这也是onData()方法入参的要求。

1. BoundedMatcher

以上方法实际上是构造了一个BoundedMatcher，我们先来看一下BoundedMatcher的定义：

/** * Some matcher sugar that lets you create a matcher for a given type * but only process items of a specific subtype of that matcher. * * @param <T> The desired type of the Matcher. * @param <S> the subtype of T that your matcher applies safely to. */public abstract class BoundedMatcher<T, S extends T> extends BaseMatcher<T> {    // ...    protected abstract boolean matchesSafely(S item);    // ...}

由以上定义我们可以看到，BoundedMatcher为我们指定了一个针对目标类型的子类型进行匹配的匹配规则。比如，我们现在需要一个Matcher对象，但实际上我们需要考察的目标类型是Book，而Book又是Object的子类，因此，我们可以通过BoundedMatcher来构造这个Matcher对象，只不过我们实际上进行检查的转变成了Book类型，只要采用如下写法：

 return new BoundedMatcher<Object, Book>(Book.class)  {...}

1. matchesSafely()

上述复写的matchesSafely()方法便是真正执行匹配的地方了！大家可以看到，我由BoundedMatcher指定了Book类型，因此matchesSafely()方法也接收了Book类型的入参，我们只要去考察入参提供的这个Book对象是否符合我们的匹配条件即可：

return bookTitle.equals(book.getTitle());

具体代码如下：

public void testOpenBookByTitleAndAuthor() {    // Match a book with a specific title and author name    onData(allOf(withBookTitle(BOOK_TITLE), withBookAuthor(BOOK_AUTHOR))).perform(click());    // Check the correct book title is displayed    onView(withId(R.id.book_title)).check(matches(withText(BOOK_TITLE)));    // Check the correct author is displayed    onView(withId(R.id.book_author)).check(matches(withText(BOOK_AUTHOR)));}

结束语

遇到一个问题，修改将其修改成Rule形式的时候，应该是导入了重复的jar包，导致一直报错：

Error:Execution failed for task ':app:dexDebugAndroidTest'. > com.android.ide.common.process.ProcessException: org.gradle.process.internal.ExecException: Process 'command 'C:\Program Files\Java\jdk1.8.0_11\bin\java.exe'' finished with non-zero exit value 2

目前还不清楚到底是什么包导入引起的，原来范例用了很多的jar包，到时候单独抽取出来看看问题是什么。