guava

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
public class SetAddTester<E> extends AbstractSetTester<E> {
41
  @CollectionFeature.Require(SUPPORTS_ADD)
42
  @CollectionSize.Require(absent = ZERO)
43
  public void testAdd_supportedPresent() {
44
    assertFalse("add(present) should return false", getSet().add(e0()));
45
    expectUnchanged();
46
  }
47

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

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