11d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert/* 21d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * Copyright (C) 2007 The Guava Authors 31d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * 41d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * Licensed under the Apache License, Version 2.0 (the "License"); 51d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * you may not use this file except in compliance with the License. 61d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * You may obtain a copy of the License at 71d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * 81d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * http://www.apache.org/licenses/LICENSE-2.0 91d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * 101d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * Unless required by applicable law or agreed to in writing, software 111d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * distributed under the License is distributed on an "AS IS" BASIS, 121d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 131d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * See the License for the specific language governing permissions and 141d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * limitations under the License. 151d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert */ 161d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 171d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertpackage com.google.common.collect.testing.testers; 181d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 191d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport static com.google.common.collect.testing.features.CollectionFeature.ALLOWS_NULL_QUERIES; 201d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport static com.google.common.collect.testing.features.CollectionFeature.ALLOWS_NULL_VALUES; 211d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport static com.google.common.collect.testing.features.CollectionSize.ZERO; 221d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 231d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport com.google.common.collect.testing.AbstractCollectionTester; 241d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport com.google.common.collect.testing.WrongType; 251d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport com.google.common.collect.testing.features.CollectionFeature; 261d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport com.google.common.collect.testing.features.CollectionSize; 271d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 281d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert/** 291d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * A generic JUnit test which tests {@code contains()} operations on a 301d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * collection. Can't be invoked directly; please see 311d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * {@link com.google.common.collect.testing.CollectionTestSuiteBuilder}. 321d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * 331d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * <p>This class is GWT compatible. 341d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * 351d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * @author Kevin Bourrillion 361d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * @author Chris Povirk 371d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert */ 381d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertpublic class CollectionContainsTester<E> extends AbstractCollectionTester<E> { 391d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert @CollectionSize.Require(absent = ZERO) 401d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert public void testContains_yes() { 411d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert assertTrue("contains(present) should return true", 421d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert collection.contains(samples.e0)); 431d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 441d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 451d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert public void testContains_no() { 461d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert assertFalse("contains(notPresent) should return false", 471d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert collection.contains(samples.e3)); 481d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 491d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 501d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert @CollectionFeature.Require(ALLOWS_NULL_QUERIES) 511d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert public void testContains_nullNotContainedButQueriesSupported() { 521d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert assertFalse("contains(null) should return false", 531d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert collection.contains(null)); 541d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 551d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 561d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert @CollectionFeature.Require(absent = ALLOWS_NULL_QUERIES) 571d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert public void testContains_nullNotContainedAndUnsupported() { 581d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert expectNullMissingWhenNullUnsupported( 591d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert "contains(null) should return false or throw"); 601d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 611d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 621d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert @CollectionFeature.Require(ALLOWS_NULL_VALUES) 631d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert @CollectionSize.Require(absent = ZERO) 641d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert public void testContains_nonNullWhenNullContained() { 651d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert initCollectionWithNullElement(); 661d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert assertFalse("contains(notPresent) should return false", 671d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert collection.contains(samples.e3)); 681d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 691d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 701d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert @CollectionFeature.Require(ALLOWS_NULL_VALUES) 711d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert @CollectionSize.Require(absent = ZERO) 721d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert public void testContains_nullContained() { 731d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert initCollectionWithNullElement(); 741d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert assertTrue("contains(null) should return true", collection.contains(null)); 751d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 761d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 771d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert public void testContains_wrongType() { 781d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert try { 791d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert assertFalse("contains(wrongType) should return false or throw", 801d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert collection.contains(WrongType.VALUE)); 811d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } catch (ClassCastException tolerated) { 821d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 831d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 841d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert} 85