Java

1
/*
2
 * Copyright (C) 2007 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.SUPPORTS_ADD;
21
import static com.google.common.collect.testing.features.CollectionSize.ZERO;
22

23
import com.google.common.annotations.GwtCompatible;
24
import com.google.common.annotations.GwtIncompatible;
25
import com.google.common.annotations.J2ktIncompatible;
26
import com.google.common.collect.testing.Helpers;
27
import com.google.common.collect.testing.features.CollectionFeature;
28
import com.google.common.collect.testing.features.CollectionSize;
29
import java.lang.reflect.Method;
30
import org.junit.Ignore;
31

32
/**
33
 * A generic JUnit test which tests add operations on a set. Can't be invoked directly; please see
34
 * {@link com.google.common.collect.testing.SetTestSuiteBuilder}.
35
 *
36
 * @author Kevin Bourrillion
37
 */
38
@GwtCompatible(emulated = true)
39
@Ignore // Affects only Android test runner, which respects JUnit 4 annotations on JUnit 3 tests.
40
@SuppressWarnings("JUnit4ClassUsedInJUnit3")
41
public class SetAddTester<E> extends AbstractSetTester<E> {
42
  @CollectionFeature.Require(SUPPORTS_ADD)
43
  @CollectionSize.Require(absent = ZERO)
44
  public void testAdd_supportedPresent() {
45
    assertFalse("add(present) should return false", getSet().add(e0()));
46
    expectUnchanged();
47
  }
48

49
  @CollectionFeature.Require(value = {SUPPORTS_ADD, ALLOWS_NULL_VALUES})
50
  @CollectionSize.Require(absent = ZERO)
51
  public void testAdd_supportedNullPresent() {
52
    E[] array = createArrayWithNullElement();
53
    collection = getSubjectGenerator().create(array);
54
    assertFalse("add(nullPresent) should return false", getSet().add(null));
55
    expectContents(array);
56
  }
57

58
  /**
59
   * Returns the {@link Method} instance for {@link #testAdd_supportedNullPresent()} so that tests
60
   * can suppress it. See {@link CollectionAddTester#getAddNullSupportedMethod()} for details.
61
   */
62
  @J2ktIncompatible
63
  @GwtIncompatible // reflection
64
  public static Method getAddSupportedNullPresentMethod() {
65
    return Helpers.getMethod(SetAddTester.class, "testAdd_supportedNullPresent");
66
  }
67
}
68