public final class

AdapterDataLoaderAction

extends java.lang.Object

implements ViewAction

 java.lang.Object

↳androidx.test.espresso.action.AdapterDataLoaderAction

Gradle dependencies

compile group: 'androidx.test.espresso', name: 'espresso-core', version: '3.6.1'

  • groupId: androidx.test.espresso
  • artifactId: espresso-core
  • version: 3.6.1

Artifact androidx.test.espresso:espresso-core:3.6.1 it located at Google repository (https://maven.google.com/)

Androidx artifact mapping:

androidx.test.espresso:espresso-core com.android.support.test.espresso:espresso-core

Androidx class mapping:

androidx.test.espresso.action.AdapterDataLoaderAction android.support.test.espresso.action.AdapterDataLoaderAction

Overview

Forces an AdapterView to ensure that the data matching a provided data matcher is loaded into the current view hierarchy.

Summary

Constructors
publicAdapterDataLoaderAction(<any> dataToLoadMatcher, EspressoOptional<java.lang.Integer> atPosition, AdapterViewProtocol adapterViewProtocol)

publicAdapterDataLoaderAction(<any> dataToLoadMatcher, java.lang.Integer atPosition, AdapterViewProtocol adapterViewProtocol)

Methods
public AdapterViewProtocol.AdaptedDatagetAdaptedData()

public <any>getConstraints()

public java.lang.StringgetDescription()

public voidperform(UiController uiController, View view)

from java.lang.Objectclone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructors

public AdapterDataLoaderAction(<any> dataToLoadMatcher, EspressoOptional<java.lang.Integer> atPosition, AdapterViewProtocol adapterViewProtocol)

Deprecated: use AdapterDataLoaderAction instead.

public AdapterDataLoaderAction(<any> dataToLoadMatcher, java.lang.Integer atPosition, AdapterViewProtocol adapterViewProtocol)

Methods

public AdapterViewProtocol.AdaptedData getAdaptedData()

public <any> getConstraints()

public void perform(UiController uiController, View view)

public java.lang.String getDescription()

Source

/*
 * 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 androidx.test.espresso.action;

import static androidx.test.espresso.matcher.ViewMatchers.isAssignableFrom;
import static androidx.test.espresso.matcher.ViewMatchers.isDisplayed;
import static androidx.test.internal.util.Checks.checkNotNull;
import static androidx.test.internal.util.Checks.checkState;
import static org.hamcrest.Matchers.allOf;

import android.view.View;
import android.widget.Adapter;
import android.widget.AdapterView;
import androidx.annotation.Nullable;
import androidx.test.espresso.PerformException;
import androidx.test.espresso.UiController;
import androidx.test.espresso.ViewAction;
import androidx.test.espresso.util.EspressoOptional;
import androidx.test.espresso.util.HumanReadables;
import java.util.ArrayList;
import java.util.List;
import java.util.Locale;
import org.hamcrest.Matcher;
import org.hamcrest.StringDescription;

/**
 * Forces an AdapterView to ensure that the data matching a provided data matcher is loaded into the
 * current view hierarchy.
 */
public final class AdapterDataLoaderAction implements ViewAction {
  final Matcher<? extends Object> dataToLoadMatcher;
  @Nullable final Integer atPosition;
  final AdapterViewProtocol adapterViewProtocol;
  private AdapterViewProtocol.AdaptedData adaptedData;
  private boolean performed = false;
  private final Object dataLock = new Object();

  /**
   * @deprecated use {@link AdapterDataLoaderAction(Matcher<? extends Object>, Integer,
   *     AdapterViewProtocol)} instead.
   */
  @Deprecated
  public AdapterDataLoaderAction(
      Matcher<? extends Object> dataToLoadMatcher,
      EspressoOptional<Integer> atPosition,
      AdapterViewProtocol adapterViewProtocol) {
    this(dataToLoadMatcher, atPosition.get(), adapterViewProtocol);
  }

  public AdapterDataLoaderAction(
      Matcher<? extends Object> dataToLoadMatcher,
      @Nullable Integer atPosition,
      AdapterViewProtocol adapterViewProtocol) {
    this.dataToLoadMatcher = checkNotNull(dataToLoadMatcher);
    this.atPosition = atPosition;
    this.adapterViewProtocol = checkNotNull(adapterViewProtocol);
  }

  public AdapterViewProtocol.AdaptedData getAdaptedData() {
    synchronized (dataLock) {
      checkState(performed, "perform hasn't been called yet!");
      return adaptedData;
    }
  }

  @Override
  public Matcher<View> getConstraints() {
    return allOf(isAssignableFrom(AdapterView.class), isDisplayed());
  }

  @Override
  public void perform(UiController uiController, View view) {
    AdapterView<? extends Adapter> adapterView = (AdapterView<? extends Adapter>) view;
    List<AdapterViewProtocol.AdaptedData> matchedDataItems = new ArrayList<>();

    for (AdapterViewProtocol.AdaptedData data :
        adapterViewProtocol.getDataInAdapterView(adapterView)) {

      if (dataToLoadMatcher.matches(data.getData())) {
        matchedDataItems.add(data);
      }
    }

    if (matchedDataItems.size() == 0) {
      StringDescription dataMatcherDescription = new StringDescription();
      dataToLoadMatcher.describeTo(dataMatcherDescription);

      if (matchedDataItems.isEmpty()) {
        dataMatcherDescription.appendText(" contained values: ");
        dataMatcherDescription.appendValue(adapterViewProtocol.getDataInAdapterView(adapterView));
        throw new PerformException.Builder()
            .withActionDescription(this.getDescription())
            .withViewDescription(HumanReadables.describe(view))
            .withCause(new RuntimeException("No data found matching: " + dataMatcherDescription))
            .build();
      }
    }

    synchronized (dataLock) {
      checkState(!performed, "perform called 2x!");
      performed = true;
      if (atPosition != null) {
        int matchedDataItemsSize = matchedDataItems.size() - 1;
        if (atPosition > matchedDataItemsSize) {
          throw new PerformException.Builder()
              .withActionDescription(this.getDescription())
              .withViewDescription(HumanReadables.describe(view))
              .withCause(
                  new RuntimeException(
                      String.format(
                          Locale.ROOT,
                          "There are only %d elements that matched but requested %d element.",
                          matchedDataItemsSize,
                          atPosition)))
              .build();
        } else {
          adaptedData = matchedDataItems.get(atPosition);
        }
      } else {
        if (matchedDataItems.size() != 1) {
          StringDescription dataMatcherDescription = new StringDescription();
          dataToLoadMatcher.describeTo(dataMatcherDescription);
          throw new PerformException.Builder()
              .withActionDescription(this.getDescription())
              .withViewDescription(HumanReadables.describe(view))
              .withCause(
                  new RuntimeException(
                      "Multiple data elements "
                          + "matched: "
                          + dataMatcherDescription
                          + ". Elements: "
                          + matchedDataItems))
              .build();
        } else {
          adaptedData = matchedDataItems.get(0);
        }
      }
    }

    int requestCount = 0;
    while (!adapterViewProtocol.isDataRenderedWithinAdapterView(adapterView, adaptedData)) {
      if (requestCount > 1) {
        if ((requestCount % 50) == 0) {
          // sometimes an adapter view will receive an event that will block its attempts to scroll.
          adapterView.invalidate();
          adapterViewProtocol.makeDataRenderedWithinAdapterView(adapterView, adaptedData);
        }
      } else {
        adapterViewProtocol.makeDataRenderedWithinAdapterView(adapterView, adaptedData);
      }
      uiController.loopMainThreadForAtLeast(100);
      requestCount++;
    }
  }

  @Override
  public String getDescription() {
    return "load adapter data";
  }
}