001/* 002 * Copyright (C) 2008 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.testers; 018 019import static com.google.common.collect.testing.features.CollectionFeature.ALLOWS_NULL_VALUES; 020import static com.google.common.collect.testing.features.CollectionFeature.SUPPORTS_ADD; 021import static com.google.common.collect.testing.testers.ReflectionFreeAssertThrows.assertThrows; 022 023import com.google.common.annotations.GwtCompatible; 024import com.google.common.collect.testing.features.CollectionFeature; 025import org.junit.Ignore; 026 027/** 028 * A generic JUnit test which tests offer operations on a queue. Can't be invoked directly; please 029 * see {@link com.google.common.collect.testing.CollectionTestSuiteBuilder}. 030 * 031 * @author Jared Levy 032 */ 033@GwtCompatible 034@Ignore("test runners must not instantiate and run this directly, only via suites we build") 035// @Ignore affects the Android test runner, which respects JUnit 4 annotations on JUnit 3 tests. 036@SuppressWarnings("JUnit4ClassUsedInJUnit3") 037public class QueueOfferTester<E> extends AbstractQueueTester<E> { 038 @CollectionFeature.Require(SUPPORTS_ADD) 039 public void testOffer_supportedNotPresent() { 040 assertTrue("offer(notPresent) should return true", getQueue().offer(e3())); 041 expectAdded(e3()); 042 } 043 044 @CollectionFeature.Require({SUPPORTS_ADD, ALLOWS_NULL_VALUES}) 045 public void testOffer_nullSupported() { 046 assertTrue("offer(null) should return true", getQueue().offer(null)); 047 expectAdded((E) null); 048 } 049 050 @CollectionFeature.Require(value = SUPPORTS_ADD, absent = ALLOWS_NULL_VALUES) 051 public void testOffer_nullUnsupported() { 052 assertThrows(NullPointerException.class, () -> getQueue().offer(null)); 053 expectUnchanged(); 054 expectNullMissingWhenNullUnsupported("Should not contain null after unsupported offer(null)"); 055 } 056}