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 17package com.google.common.collect.testing.testers; 18 19import static com.google.common.collect.testing.features.CollectionFeature.ALLOWS_NULL_VALUES; 20import static com.google.common.collect.testing.features.CollectionFeature.SUPPORTS_ADD; 21import static com.google.common.collect.testing.features.CollectionSize.ZERO; 22 23import com.google.common.annotations.GwtCompatible; 24import com.google.common.collect.testing.Helpers; 25import com.google.common.collect.testing.features.CollectionFeature; 26import com.google.common.collect.testing.features.CollectionSize; 27 28import java.util.List; 29 30/** 31 * A generic JUnit test which tests {@code add(Object)} operations on a list. 32 * Can't be invoked directly; please see 33 * {@link com.google.common.collect.testing.ListTestSuiteBuilder}. 34 * 35 * @author Chris Povirk 36 */ 37@SuppressWarnings("unchecked") // too many "unchecked generic array creations" 38@GwtCompatible(emulated = true) 39public class ListAddTester<E> extends AbstractListTester<E> { 40 @CollectionFeature.Require(SUPPORTS_ADD) 41 @CollectionSize.Require(absent = ZERO) 42 public void testAdd_supportedPresent() { 43 assertTrue("add(present) should return true", getList().add(samples.e0)); 44 expectAdded(samples.e0); 45 } 46 47 @CollectionFeature.Require(absent = SUPPORTS_ADD) 48 @CollectionSize.Require(absent = ZERO) 49 /* 50 * absent = ZERO isn't required, since unmodList.add() must 51 * throw regardless, but it keeps the method name accurate. 52 */ 53 public void testAdd_unsupportedPresent() { 54 try { 55 getList().add(samples.e0); 56 fail("add(present) should throw"); 57 } catch (UnsupportedOperationException expected) { 58 } 59 } 60 61 @CollectionFeature.Require(value = {SUPPORTS_ADD, ALLOWS_NULL_VALUES}) 62 @CollectionSize.Require(absent = ZERO) 63 public void testAdd_supportedNullPresent() { 64 E[] array = createArrayWithNullElement(); 65 collection = getSubjectGenerator().create(array); 66 assertTrue("add(nullPresent) should return true", getList().add(null)); 67 68 List<E> expected = Helpers.copyToList(array); 69 expected.add(null); 70 expectContents(expected); 71 } 72} 73 74