001/*
002 * Copyright (C) 2012 The Guava Authors
003 *
004 * Licensed under the Apache License, Version 2.0 (the "License");
005 * you may not use this file except in compliance with the License.
006 * You may obtain a copy of the License at
007 *
008 * http://www.apache.org/licenses/LICENSE-2.0
009 *
010 * Unless required by applicable law or agreed to in writing, software
011 * distributed under the License is distributed on an "AS IS" BASIS,
012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013 * See the License for the specific language governing permissions and
014 * limitations under the License.
015 */
016
017package com.google.common.collect.testing.google;
018
019import static com.google.common.collect.testing.features.CollectionSize.ZERO;
020import static com.google.common.collect.testing.features.MapFeature.ALLOWS_NULL_KEYS;
021import static com.google.common.collect.testing.features.MapFeature.ALLOWS_NULL_KEY_QUERIES;
022import static org.junit.Assert.assertThrows;
023
024import com.google.common.annotations.GwtCompatible;
025import com.google.common.collect.Multimap;
026import com.google.common.collect.testing.features.CollectionSize;
027import com.google.common.collect.testing.features.MapFeature;
028
029/**
030 * Tester for the {@code containsKey} methods of {@code Multimap} and its {@code asMap()} view.
031 *
032 * @author Louis Wasserman
033 */
034@GwtCompatible
035public class MultimapContainsKeyTester<K, V> extends AbstractMultimapTester<K, V, Multimap<K, V>> {
036  @CollectionSize.Require(absent = ZERO)
037  public void testContainsKeyYes() {
038    assertTrue(multimap().containsKey(k0()));
039  }
040
041  public void testContainsKeyNo() {
042    assertFalse(multimap().containsKey(k3()));
043  }
044
045  public void testContainsKeysFromKeySet() {
046    for (K k : multimap().keySet()) {
047      assertTrue(multimap().containsKey(k));
048    }
049  }
050
051  public void testContainsKeyAgreesWithGet() {
052    for (K k : sampleKeys()) {
053      assertEquals(!multimap().get(k).isEmpty(), multimap().containsKey(k));
054    }
055  }
056
057  public void testContainsKeyAgreesWithAsMap() {
058    for (K k : sampleKeys()) {
059      assertEquals(multimap().containsKey(k), multimap().asMap().containsKey(k));
060    }
061  }
062
063  public void testContainsKeyAgreesWithKeySet() {
064    for (K k : sampleKeys()) {
065      assertEquals(multimap().containsKey(k), multimap().keySet().contains(k));
066    }
067  }
068
069  @MapFeature.Require(ALLOWS_NULL_KEYS)
070  @CollectionSize.Require(absent = ZERO)
071  public void testContainsKeyNullPresent() {
072    initMultimapWithNullKey();
073    assertTrue(multimap().containsKey(null));
074  }
075
076  @MapFeature.Require(ALLOWS_NULL_KEY_QUERIES)
077  public void testContainsKeyNullAbsent() {
078    assertFalse(multimap().containsKey(null));
079  }
080
081  @MapFeature.Require(absent = ALLOWS_NULL_KEY_QUERIES)
082  public void testContainsKeyNullDisallowed() {
083    assertThrows(NullPointerException.class, () -> multimap().containsKey(null));
084  }
085}