001/*
002 * Copyright (C) 2012 The Guava Authors
003 *
004 * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except
005 * in compliance with the License. You may obtain a copy of the License at
006 *
007 * http://www.apache.org/licenses/LICENSE-2.0
008 *
009 * Unless required by applicable law or agreed to in writing, software distributed under the License
010 * is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express
011 * or implied. See the License for the specific language governing permissions and limitations under
012 * the License.
013 */
014
015package com.google.common.collect.testing.google;
016
017import static com.google.common.collect.testing.Helpers.assertEqualInOrder;
018import static java.util.Arrays.asList;
019
020import com.google.common.annotations.GwtCompatible;
021import com.google.common.collect.ListMultimap;
022import java.util.Collection;
023import org.jspecify.annotations.NullMarked;
024import org.jspecify.annotations.Nullable;
025import org.junit.Ignore;
026
027/**
028 * Superclass for all {@code ListMultimap} testers.
029 *
030 * @author Louis Wasserman
031 */
032@GwtCompatible
033@Ignore("test runners must not instantiate and run this directly, only via suites we build")
034// @Ignore affects the Android test runner, which respects JUnit 4 annotations on JUnit 3 tests.
035@SuppressWarnings("JUnit4ClassUsedInJUnit3")
036@NullMarked
037public class AbstractListMultimapTester<K extends @Nullable Object, V extends @Nullable Object>
038    extends AbstractMultimapTester<K, V, ListMultimap<K, V>> {
039
040  @Override
041  protected void assertGet(K key, V... values) {
042    assertGet(key, asList(values));
043  }
044
045  @Override
046  protected void assertGet(K key, Collection<? extends V> values) {
047    assertEqualInOrder(values, multimap().get(key));
048
049    if (!values.isEmpty()) {
050      assertEqualInOrder(values, multimap().asMap().get(key));
051      assertFalse(multimap().isEmpty());
052    } else {
053      assertNull(multimap().asMap().get(key));
054    }
055
056    assertEquals(values.size(), multimap().get(key).size());
057    assertEquals(values.size() > 0, multimap().containsKey(key));
058    assertEquals(values.size() > 0, multimap().keySet().contains(key));
059    assertEquals(values.size() > 0, multimap().keys().contains(key));
060  }
061}