Java

1
/*
2
 * Copyright (C) 2013 The Guava Authors
3
 *
4
 * Licensed under the Apache License, Version 2.0 (the "License");
5
 * you may not use this file except in compliance with the License.
6
 * You may obtain a copy of the License at
7
 *
8
 * http://www.apache.org/licenses/LICENSE-2.0
9
 *
10
 * Unless required by applicable law or agreed to in writing, software
11
 * distributed under the License is distributed on an "AS IS" BASIS,
12
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13
 * See the License for the specific language governing permissions and
14
 * limitations under the License.
15
 */
16

17
package com.google.common.collect.testing.testers;
18

19
import static com.google.common.collect.testing.features.CollectionFeature.ALLOWS_NULL_VALUES;
20
import static com.google.common.collect.testing.features.CollectionFeature.KNOWN_ORDER;
21
import static com.google.common.collect.testing.features.CollectionFeature.SUPPORTS_ADD;
22
import static com.google.common.collect.testing.features.CollectionFeature.SUPPORTS_REMOVE;
23
import static com.google.common.collect.testing.features.CollectionSize.ZERO;
24

25
import com.google.common.annotations.GwtCompatible;
26
import com.google.common.annotations.GwtIncompatible;
27
import com.google.common.annotations.J2ktIncompatible;
28
import com.google.common.collect.testing.AbstractCollectionTester;
29
import com.google.common.collect.testing.Helpers;
30
import com.google.common.collect.testing.SpliteratorTester;
31
import com.google.common.collect.testing.features.CollectionFeature;
32
import com.google.common.collect.testing.features.CollectionSize;
33
import java.lang.reflect.Method;
34
import java.util.Spliterator;
35
import org.junit.Ignore;
36

37
/**
38
 * A generic JUnit test which tests {@code spliterator} operations on a collection. Can't be invoked
39
 * directly; please see {@link com.google.common.collect.testing.CollectionTestSuiteBuilder}.
40
 *
41
 * @author Louis Wasserman
42
 */
43
@GwtCompatible(emulated = true)
44
@Ignore // Affects only Android test runner, which respects JUnit 4 annotations on JUnit 3 tests.
45
@SuppressWarnings("JUnit4ClassUsedInJUnit3")
46
public class CollectionSpliteratorTester<E> extends AbstractCollectionTester<E> {
47

48
  @CollectionFeature.Require(absent = KNOWN_ORDER)
49
  public void testSpliteratorUnknownOrder() {
50
    SpliteratorTester.of(collection::spliterator).expect(getSampleElements());
51
  }
52

53
  @CollectionFeature.Require(KNOWN_ORDER)
54
  public void testSpliteratorKnownOrder() {
55
    SpliteratorTester.of(collection::spliterator).expect(getOrderedElements()).inOrder();
56
  }
57

58
  @CollectionFeature.Require(ALLOWS_NULL_VALUES)
59
  @CollectionSize.Require(absent = ZERO)
60
  public void testSpliteratorNullable() {
61
    initCollectionWithNullElement();
62
    assertFalse(collection.spliterator().hasCharacteristics(Spliterator.NONNULL));
63
  }
64

65
  @CollectionFeature.Require(SUPPORTS_ADD)
66
  public void testSpliteratorNotImmutable_collectionAllowsAdd() {
67
    // If add is supported, verify that IMMUTABLE is not reported.
68
    assertFalse(collection.spliterator().hasCharacteristics(Spliterator.IMMUTABLE));
69
  }
70

71
  @CollectionFeature.Require(SUPPORTS_REMOVE)
72
  public void testSpliteratorNotImmutable_collectionAllowsRemove() {
73
    // If remove is supported, verify that IMMUTABLE is not reported.
74
    assertFalse(collection.spliterator().hasCharacteristics(Spliterator.IMMUTABLE));
75
  }
76

77
  @J2ktIncompatible
78
  @GwtIncompatible // reflection
79
  public static Method getSpliteratorNotImmutableCollectionAllowsAddMethod() {
80
    return Helpers.getMethod(
81
        CollectionSpliteratorTester.class, "testSpliteratorNotImmutable_collectionAllowsAdd");
82
  }
83

84
  @J2ktIncompatible
85
  @GwtIncompatible // reflection
86
  public static Method getSpliteratorNotImmutableCollectionAllowsRemoveMethod() {
87
    return Helpers.getMethod(
88
        CollectionSpliteratorTester.class, "testSpliteratorNotImmutable_collectionAllowsRemove");
89
  }
90
}
91