/* * Copyright (C) 2014 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License. */ package android.support.v7.widget; import android.graphics.Rect; import android.os.Looper; import android.test.ActivityInstrumentationTestCase2; import android.util.Log; import android.view.View; import android.view.ViewGroup; import android.widget.FrameLayout; import android.widget.TextView; import java.util.ArrayList; import java.util.List; import java.util.concurrent.CountDownLatch; import java.util.concurrent.TimeUnit; import java.util.concurrent.atomic.AtomicInteger; abstract public class BaseRecyclerViewInstrumentationTest extends ActivityInstrumentationTestCase2 { private static final String TAG = "RecyclerViewTest"; private boolean mDebug; protected RecyclerView mRecyclerView; protected AdapterHelper mAdapterHelper; Throwable mainThreadException; public BaseRecyclerViewInstrumentationTest() { this(false); } public BaseRecyclerViewInstrumentationTest(boolean debug) { super("android.support.v7.recyclerview", TestActivity.class); mDebug = debug; } void checkForMainThreadException() throws Throwable { if (mainThreadException != null) { throw mainThreadException; } } void setAdapter(final RecyclerView.Adapter adapter) throws Throwable { runTestOnUiThread(new Runnable() { @Override public void run() { mRecyclerView.setAdapter(adapter); } }); } void swapAdapter(final RecyclerView.Adapter adapter, final boolean removeAndRecycleExistingViews) throws Throwable { runTestOnUiThread(new Runnable() { @Override public void run() { mRecyclerView.swapAdapter(adapter, removeAndRecycleExistingViews); } }); } void postExceptionToInstrumentation(Throwable t) { if (mDebug) { Log.e(TAG, "captured exception on main thread", t); } if (mainThreadException != null) { Log.e(TAG, "receiving another main thread exception. dropping.", t); } else { mainThreadException = t; } if (mRecyclerView != null && mRecyclerView .getLayoutManager() instanceof TestLayoutManager) { TestLayoutManager lm = (TestLayoutManager) mRecyclerView.getLayoutManager(); // finish all layouts so that we get the correct exception while (lm.layoutLatch.getCount() > 0) { lm.layoutLatch.countDown(); } } } @Override protected void tearDown() throws Exception { if (mRecyclerView != null) { try { removeRecyclerView(); } catch (Throwable throwable) { throwable.printStackTrace(); } } getInstrumentation().waitForIdleSync(); try { checkForMainThreadException(); } catch (Exception e) { throw e; } catch (Throwable throwable) { throwable.printStackTrace(); } super.tearDown(); } public Rect getDecoratedRecyclerViewBounds() { return new Rect( mRecyclerView.getPaddingLeft(), mRecyclerView.getPaddingTop(), mRecyclerView.getPaddingLeft() + mRecyclerView.getWidth(), mRecyclerView.getPaddingTop() + mRecyclerView.getHeight() ); } public void removeRecyclerView() throws Throwable { if (mRecyclerView == null) { return; } mRecyclerView = null; runTestOnUiThread(new Runnable() { @Override public void run() { getActivity().mContainer.removeAllViews(); } }); } void waitForAnimations(int seconds) throws InterruptedException { final CountDownLatch latch = new CountDownLatch(2); boolean running = mRecyclerView.mItemAnimator .isRunning(new RecyclerView.ItemAnimator.ItemAnimatorFinishedListener() { @Override public void onAnimationsFinished() { latch.countDown(); } }); if (running) { latch.await(seconds, TimeUnit.SECONDS); } } public void setRecyclerView(final RecyclerView recyclerView) throws Throwable { setRecyclerView(recyclerView, true); } public void setRecyclerView(final RecyclerView recyclerView, boolean assignDummyPool) throws Throwable { mRecyclerView = recyclerView; if (assignDummyPool) { RecyclerView.RecycledViewPool pool = new RecyclerView.RecycledViewPool() { @Override public RecyclerView.ViewHolder getRecycledView(int viewType) { RecyclerView.ViewHolder viewHolder = super.getRecycledView(viewType); if (viewHolder == null) { return null; } viewHolder.addFlags(RecyclerView.ViewHolder.FLAG_BOUND); viewHolder.mPosition = 200; viewHolder.mOldPosition = 300; viewHolder.mPreLayoutPosition = 500; return viewHolder; } @Override public void putRecycledView(RecyclerView.ViewHolder scrap) { super.putRecycledView(scrap); } }; mRecyclerView.setRecycledViewPool(pool); } mAdapterHelper = recyclerView.mAdapterHelper; runTestOnUiThread(new Runnable() { @Override public void run() { getActivity().mContainer.addView(recyclerView); } }); } protected FrameLayout getRecyclerViewContainer() { return getActivity().mContainer; } public void requestLayoutOnUIThread(final View view) throws Throwable { runTestOnUiThread(new Runnable() { @Override public void run() { view.requestLayout(); } }); } public void scrollBy(final int dt) throws Throwable { runTestOnUiThread(new Runnable() { @Override public void run() { if (mRecyclerView.getLayoutManager().canScrollHorizontally()) { mRecyclerView.scrollBy(dt, 0); } else { mRecyclerView.scrollBy(0, dt); } } }); } void scrollToPosition(final int position) throws Throwable { runTestOnUiThread(new Runnable() { @Override public void run() { mRecyclerView.getLayoutManager().scrollToPosition(position); } }); } void smoothScrollToPosition(final int position) throws Throwable { Log.d(TAG, "SMOOTH scrolling to " + position); runTestOnUiThread(new Runnable() { @Override public void run() { mRecyclerView.smoothScrollToPosition(position); } }); while (mRecyclerView.getLayoutManager().isSmoothScrolling() || mRecyclerView.getScrollState() != RecyclerView.SCROLL_STATE_IDLE) { if (mDebug) { Log.d(TAG, "SMOOTH scrolling step"); } Thread.sleep(200); } Log.d(TAG, "SMOOTH scrolling done"); getInstrumentation().waitForIdleSync(); } class TestViewHolder extends RecyclerView.ViewHolder { Item mBindedItem; public TestViewHolder(View itemView) { super(itemView); itemView.setFocusable(true); } @Override public String toString() { return super.toString() + " item:" + mBindedItem; } } class TestLayoutManager extends RecyclerView.LayoutManager { CountDownLatch layoutLatch; public void expectLayouts(int count) { layoutLatch = new CountDownLatch(count); } public void waitForLayout(long timeout, TimeUnit timeUnit) throws Throwable { layoutLatch.await(timeout * (mDebug ? 100 : 1), timeUnit); assertEquals("all expected layouts should be executed at the expected time", 0, layoutLatch.getCount()); getInstrumentation().waitForIdleSync(); } public void assertLayoutCount(int count, String msg, long timeout) throws Throwable { layoutLatch.await(timeout, TimeUnit.SECONDS); assertEquals(msg, count, layoutLatch.getCount()); } public void assertNoLayout(String msg, long timeout) throws Throwable { layoutLatch.await(timeout, TimeUnit.SECONDS); assertFalse(msg, layoutLatch.getCount() == 0); } public void waitForLayout(long timeout) throws Throwable { waitForLayout(timeout * (mDebug ? 10000 : 1), TimeUnit.SECONDS); } @Override public RecyclerView.LayoutParams generateDefaultLayoutParams() { return new RecyclerView.LayoutParams(ViewGroup.LayoutParams.WRAP_CONTENT, ViewGroup.LayoutParams.WRAP_CONTENT); } void assertVisibleItemPositions() { int i = getChildCount(); TestAdapter testAdapter = (TestAdapter) mRecyclerView.getAdapter(); while (i-- > 0) { View view = getChildAt(i); RecyclerView.LayoutParams lp = (RecyclerView.LayoutParams) view.getLayoutParams(); Item item = ((TestViewHolder) lp.mViewHolder).mBindedItem; if (mDebug) { Log.d(TAG, "testing item " + i); } if (!lp.isItemRemoved()) { RecyclerView.ViewHolder vh = mRecyclerView.getChildViewHolder(view); assertSame("item position in LP should match adapter value :" + vh, testAdapter.mItems.get(vh.mPosition), item); } } } RecyclerView.LayoutParams getLp(View v) { return (RecyclerView.LayoutParams) v.getLayoutParams(); } void layoutRange(RecyclerView.Recycler recycler, int start, int end) { assertScrap(recycler); if (mDebug) { Log.d(TAG, "will layout items from " + start + " to " + end); } int diff = end > start ? 1 : -1; int top = 0; for (int i = start; i != end; i+=diff) { if (mDebug) { Log.d(TAG, "laying out item " + i); } View view = recycler.getViewForPosition(i); assertNotNull("view should not be null for valid position. " + "got null view at position " + i, view); if (!mRecyclerView.mState.isPreLayout()) { RecyclerView.LayoutParams layoutParams = (RecyclerView.LayoutParams) view .getLayoutParams(); assertFalse("In post layout, getViewForPosition should never return a view " + "that is removed", layoutParams != null && layoutParams.isItemRemoved()); } assertEquals("getViewForPosition should return correct position", i, getPosition(view)); addView(view); measureChildWithMargins(view, 0, 0); layoutDecorated(view, 0, top, getDecoratedMeasuredWidth(view) , top + getDecoratedMeasuredHeight(view)); top += view.getMeasuredHeight(); } } private void assertScrap(RecyclerView.Recycler recycler) { if (mRecyclerView.getAdapter() != null && !mRecyclerView.getAdapter().hasStableIds()) { for (RecyclerView.ViewHolder viewHolder : recycler.getScrapList()) { assertFalse("Invalid scrap should be no kept", viewHolder.isInvalid()); } } } @Override public boolean canScrollHorizontally() { return true; } @Override public boolean canScrollVertically() { return true; } @Override public int scrollHorizontallyBy(int dx, RecyclerView.Recycler recycler, RecyclerView.State state) { return dx; } @Override public int scrollVerticallyBy(int dy, RecyclerView.Recycler recycler, RecyclerView.State state) { return dy; } } static class Item { final static AtomicInteger idCounter = new AtomicInteger(0); final public int mId = idCounter.incrementAndGet(); int mAdapterIndex; final String mText; Item(int adapterIndex, String text) { mAdapterIndex = adapterIndex; mText = text; } @Override public String toString() { return "Item{" + "mId=" + mId + ", originalIndex=" + mAdapterIndex + ", text='" + mText + '\'' + '}'; } } class TestAdapter extends RecyclerView.Adapter { List mItems; TestAdapter(int count) { mItems = new ArrayList(count); for (int i = 0; i < count; i++) { mItems.add(new Item(i, "Item " + i)); } } @Override public TestViewHolder onCreateViewHolder(ViewGroup parent, int viewType) { return new TestViewHolder(new TextView(parent.getContext())); } @Override public void onBindViewHolder(TestViewHolder holder, int position) { final Item item = mItems.get(position); ((TextView) (holder.itemView)).setText(item.mText + "(" + item.mAdapterIndex + ")"); holder.mBindedItem = item; } public void deleteAndNotify(final int start, final int count) throws Throwable { deleteAndNotify(new int[]{start, count}); } /** * Deletes items in the given ranges. *

* Note that each operation affects the one after so you should offset them properly. *

* For example, if adapter has 5 items (A,B,C,D,E), and then you call this method with * [1, 2],[2, 1], it will first delete items B,C and the new adapter will be * A D E. Then it will delete 2,1 which means it will delete E. */ public void deleteAndNotify(final int[]... startCountTuples) throws Throwable { for (int[] tuple : startCountTuples) { tuple[1] = -tuple[1]; } new AddRemoveRunnable(startCountTuples).runOnMainThread(); } @Override public long getItemId(int position) { return hasStableIds() ? mItems.get(position).mId : super.getItemId(position); } public void offsetOriginalIndices(int start, int offset) { for (int i = start; i < mItems.size(); i++) { mItems.get(i).mAdapterIndex += offset; } } /** * @param start inclusive * @param end exclusive * @param offset */ public void offsetOriginalIndicesBetween(int start, int end, int offset) { for (int i = start; i < end && i < mItems.size(); i++) { mItems.get(i).mAdapterIndex += offset; } } public void addAndNotify(final int start, final int count) throws Throwable { addAndNotify(new int[]{start, count}); } public void addAndNotify(final int[]... startCountTuples) throws Throwable { new AddRemoveRunnable(startCountTuples).runOnMainThread(); } public void dispatchDataSetChanged() throws Throwable { runTestOnUiThread(new Runnable() { @Override public void run() { notifyDataSetChanged(); } }); } public void changeAndNotify(final int start, final int count) throws Throwable { runTestOnUiThread(new Runnable() { @Override public void run() { notifyItemRangeChanged(start, count); } }); } public void changePositionsAndNotify(final int... positions) throws Throwable { runTestOnUiThread(new Runnable() { @Override public void run() { for (int i = 0; i < positions.length; i += 1) { TestAdapter.super.notifyItemRangeChanged(positions[i], 1); } } }); } /** * Similar to other methods but negative count means delete and position count means add. *

* For instance, calling this method with [1,1], [2,-1] it will first add an * item to index 1, then remove an item from index 2 (updated index 2) */ public void addDeleteAndNotify(final int[]... startCountTuples) throws Throwable { new AddRemoveRunnable(startCountTuples).runOnMainThread(); } @Override public int getItemCount() { return mItems.size(); } public void moveItems(boolean notifyChange, int[]... fromToTuples) throws Throwable { for (int i = 0; i < fromToTuples.length; i += 1) { int[] tuple = fromToTuples[i]; moveItem(tuple[0], tuple[1], false); } if (notifyChange) { dispatchDataSetChanged(); } } public void moveItem(final int from, final int to, final boolean notifyChange) throws Throwable { runTestOnUiThread(new Runnable() { @Override public void run() { Item item = mItems.remove(from); mItems.add(to, item); offsetOriginalIndices(from, to - 1); item.mAdapterIndex = to; if (notifyChange) { notifyDataSetChanged(); } } }); } private class AddRemoveRunnable implements Runnable { final int[][] mStartCountTuples; public AddRemoveRunnable(int[][] startCountTuples) { mStartCountTuples = startCountTuples; } public void runOnMainThread() throws Throwable { if (Looper.myLooper() == Looper.getMainLooper()) { run(); } else { runTestOnUiThread(this); } } @Override public void run() { for (int[] tuple : mStartCountTuples) { if (tuple[1] < 0) { delete(tuple); } else { add(tuple); } } } private void add(int[] tuple) { // offset others offsetOriginalIndices(tuple[0], tuple[1]); for (int i = 0; i < tuple[1]; i++) { mItems.add(tuple[0], new Item(i, "new item " + i)); } notifyItemRangeInserted(tuple[0], tuple[1]); } private void delete(int[] tuple) { final int count = -tuple[1]; offsetOriginalIndices(tuple[0] + count, tuple[1]); for (int i = 0; i < count; i++) { mItems.remove(tuple[0]); } notifyItemRangeRemoved(tuple[0], count); } } } @Override public void runTestOnUiThread(Runnable r) throws Throwable { if (Looper.myLooper() == Looper.getMainLooper()) { r.run(); } else { super.runTestOnUiThread(r); } } static class TargetTuple { final int mPosition; final int mLayoutDirection; TargetTuple(int position, int layoutDirection) { this.mPosition = position; this.mLayoutDirection = layoutDirection; } @Override public String toString() { return "TargetTuple{" + "mPosition=" + mPosition + ", mLayoutDirection=" + mLayoutDirection + '}'; } } }