CursorAdapterViewProtocol.java

import java.util.List;

import android.database.Cursor;
import android.os.Build;
import android.support.v4.widget.CursorAdapter;
import android.view.View;
import android.widget.AbsListView;
import android.widget.Adapter;
import android.widget.AdapterView;
import android.widget.AdapterViewAnimator;
import android.widget.AdapterViewFlipper;

import com.google.android.apps.common.testing.ui.espresso.action.AdapterViewProtocol;
import com.google.android.apps.common.testing.ui.espresso.action.AdapterViewProtocol.AdaptedData;
import com.google.common.base.Optional;
import com.google.common.collect.Lists;
import com.google.common.collect.Range;

import static com.google.android.apps.common.testing.ui.espresso.matcher.ViewMatchers.isDisplayingAtLeast;
import static com.google.common.base.Preconditions.checkArgument;

public class CursorAdapterViewProtocol implements AdapterViewProtocol {
	private static final int FULLY_RENDERED_PERCENTAGE_CUTOFF = 90;

	public Object getDataFromCursor(CursorAdapter cursorAdapter, Cursor cursor) {
		return cursorAdapter.convertToString(cursor);
	}

	@Override
	public Iterable<AdaptedData> getDataInAdapterView(AdapterView<? extends Adapter> adapterView) {
		CursorAdapter adapter = (CursorAdapter) adapterView.getAdapter();

		List<AdaptedData> datas = Lists.newArrayList();
		for (int i = 0; i < adapterView.getCount(); i++) {
			Cursor cursor = (Cursor) adapterView.getItemAtPosition(i);
			datas.add(new AdaptedData.Builder()
					.withData(getDataFromCursor(adapter, cursor))
					.withOpaqueToken(i)
					.build());
		}
		return datas;
	}

	@Override
	public Optional<AdaptedData> getDataRenderedByView(AdapterView<? extends Adapter> adapterView, View descendantView) {
		if (adapterView == descendantView.getParent()) {
			int position = adapterView.getPositionForView(descendantView);
			if (position != AdapterView.INVALID_POSITION) {
				CursorAdapter adapter = (CursorAdapter) adapterView.getAdapter();
				Cursor cursor = (Cursor) adapterView.getItemAtPosition(position);
				return Optional.of(new AdaptedData.Builder()
						.withData(getDataFromCursor(adapter, cursor))
						.withOpaqueToken(Integer.valueOf(position))
						.build());
			}
		}
		return Optional.absent();
	}

	@Override
	public void makeDataRenderedWithinAdapterView(AdapterView<? extends Adapter> adapterView, AdaptedData data) {
		checkArgument(data.opaqueToken instanceof Integer, "Not my data: %s", data);
		int position = ((Integer) data.opaqueToken).intValue();

		boolean moved = false;
		// set selection should always work, we can give a little better experience if per subtype
		// though.
		if (Build.VERSION.SDK_INT > 7) {
			if (adapterView instanceof AbsListView) {
				if (Build.VERSION.SDK_INT > 10) {
					((AbsListView) adapterView).smoothScrollToPositionFromTop(position,
						adapterView.getPaddingTop(), 0);
				} else {
					((AbsListView) adapterView).smoothScrollToPosition(position);
				}
				moved = true;
			}
			if (Build.VERSION.SDK_INT > 10) {
				if (adapterView instanceof AdapterViewAnimator) {
					if (adapterView instanceof AdapterViewFlipper) {
						((AdapterViewFlipper) adapterView).stopFlipping();
					}
					((AdapterViewAnimator) adapterView).setDisplayedChild(position);
					moved = true;
				}
			}
		}
		if (!moved) {
			adapterView.setSelection(position);
		}
	}

	@SuppressWarnings("deprecation")
	@Override
	public boolean isDataRenderedWithinAdapterView(AdapterView<? extends Adapter> adapterView, AdaptedData adaptedData) {
		checkArgument(adaptedData.opaqueToken instanceof Integer, "Not my data: %s", adaptedData);
		int dataPosition = ((Integer) adaptedData.opaqueToken).intValue();

		if (Range.closed(adapterView.getFirstVisiblePosition(), adapterView.getLastVisiblePosition()).contains(dataPosition)) {
			if (adapterView.getFirstVisiblePosition() == adapterView.getLastVisiblePosition()) {
				// thats a huge element.
				return true;
			} else {
				return isElementFullyRendered(adapterView, dataPosition - adapterView.getFirstVisiblePosition());
			}
		} else {
			return false;
		}
	}

	private boolean isElementFullyRendered(AdapterView<? extends Adapter> adapterView, int childAt) {
		View element = adapterView.getChildAt(childAt);
		// Occassionally we'll have to fight with smooth scrolling logic on our definition of when
		// there is extra scrolling to be done. In particular if the element is the first or last
		// element of the list, the smooth scroller may decide that no work needs to be done to scroll
		// to the element if a certain percentage of it is on screen. Ugh. Sigh. Yuck.

		return isDisplayingAtLeast(FULLY_RENDERED_PERCENTAGE_CUTOFF).matches(element);
	}
}

SuggestionAdapterViewProtocol.java

import android.database.Cursor;
import android.support.v4.widget.CursorAdapter;
import android.text.Html;
import com.foo.SuggestionProvider;

public class SuggestionAdapterViewProtocol extends CursorAdapterViewProtocol {
	private static final SuggestionAdapterViewProtocol INSTANCE = new SuggestionAdapterViewProtocol();

	public static SuggestionAdapterViewProtocol getInstance() {
		return INSTANCE;
	}

	public Object getDataFromCursor(CursorAdapter cursorAdapter, Cursor cursor) {
		return Html.fromHtml(cursor.getString(SuggestionProvider.COL_DISPLAY_NAME)).toString();
	}
}

This is great. I believe this will resolve my question I posted on https://groups.google.com/forum/#!topic/android-test-kit-discuss/oR2Us9XD3fY.

As a suggestion, for the StandardAdapterViewProtocol methods that need not be overridden, rather than copy/pasting the code into your implementation methods, you can wrap the standard protocol obtained by AdapterViewProtocols.standardProtocol(), and invoke the methods directly. This way you only have to worry about implementing getDataInAdapterView() and getDataRenderedByView().

Thanks for sharing this. Cheers!

Ah wrapping them would be much better. Thank you. I was angry I couldn't just extend it at first because they marked the class final.

Decorator Design Pattern FTW :)