001/*
002 * Copyright (C) 2015 The Guava Authors
003 *
004 * Licensed under the Apache License, Version 2.0 (the "License");
005 * you may not use this file except in compliance with the License.
006 * You may obtain a copy of the License at
007 *
008 * http://www.apache.org/licenses/LICENSE-2.0
009 *
010 * Unless required by applicable law or agreed to in writing, software
011 * distributed under the License is distributed on an "AS IS" BASIS,
012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013 * See the License for the specific language governing permissions and
014 * limitations under the License.
015 */
016
017package com.google.common.collect.testing.testers;
018
019import static com.google.common.collect.testing.features.CollectionFeature.KNOWN_ORDER;
020import static java.util.Arrays.asList;
021
022import com.google.common.annotations.GwtCompatible;
023import com.google.common.collect.testing.AbstractCollectionTester;
024import com.google.common.collect.testing.Helpers;
025import com.google.common.collect.testing.features.CollectionFeature;
026import java.util.ArrayList;
027import java.util.List;
028import org.junit.Ignore;
029
030/**
031 * A generic JUnit test which tests {@code forEach} operations on a collection. Can't be invoked
032 * directly; please see {@link com.google.common.collect.testing.CollectionTestSuiteBuilder}.
033 *
034 * @author Louis Wasserman
035 */
036@GwtCompatible
037@Ignore("test runners must not instantiate and run this directly, only via suites we build")
038// @Ignore affects the Android test runner, which respects JUnit 4 annotations on JUnit 3 tests.
039@SuppressWarnings("JUnit4ClassUsedInJUnit3")
040@IgnoreJRERequirement // We opt into library desugaring for our tests.
041public class CollectionForEachTester<E> extends AbstractCollectionTester<E> {
042  @CollectionFeature.Require(absent = KNOWN_ORDER)
043  public void testForEachUnknownOrder() {
044    List<E> elements = new ArrayList<>();
045    collection.forEach(elements::add);
046    Helpers.assertEqualIgnoringOrder(asList(createSamplesArray()), elements);
047  }
048
049  @CollectionFeature.Require(KNOWN_ORDER)
050  public void testForEachKnownOrder() {
051    List<E> elements = new ArrayList<>();
052    collection.forEach(elements::add);
053    List<E> expected = Helpers.copyToList(getOrderedElements());
054    assertEquals("Different ordered iteration", expected, elements);
055  }
056}