1 /* 2 * Copyright (C) 2008 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 17 package com.google.common.collect.testing.testers; 18 19 import static com.google.common.collect.testing.features.CollectionFeature.ALLOWS_NULL_VALUES; 20 import static com.google.common.collect.testing.features.CollectionFeature.SUPPORTS_ADD; 21 22 import com.google.common.annotations.GwtCompatible; 23 import com.google.common.collect.testing.features.CollectionFeature; 24 25 /** 26 * A generic JUnit test which tests offer operations on a queue. Can't be 27 * invoked directly; please see 28 * {@link com.google.common.collect.testing.CollectionTestSuiteBuilder}. 29 * 30 * @author Jared Levy 31 */ 32 @SuppressWarnings("unchecked") // too many "unchecked generic array creations" 33 @GwtCompatible 34 public class QueueOfferTester<E> extends AbstractQueueTester<E> { 35 @CollectionFeature.Require(SUPPORTS_ADD) testOffer_supportedNotPresent()36 public void testOffer_supportedNotPresent() { 37 assertTrue("offer(notPresent) should return true", 38 getQueue().offer(samples.e3)); 39 expectAdded(samples.e3); 40 } 41 42 @CollectionFeature.Require({SUPPORTS_ADD, ALLOWS_NULL_VALUES}) testOffer_nullSupported()43 public void testOffer_nullSupported() { 44 assertTrue("offer(null) should return true", getQueue().offer(null)); 45 expectAdded((E) null); 46 } 47 48 @CollectionFeature.Require(value = SUPPORTS_ADD, absent = ALLOWS_NULL_VALUES) testOffer_nullUnsupported()49 public void testOffer_nullUnsupported() { 50 try { 51 getQueue().offer(null); 52 fail("offer(null) should throw"); 53 } catch (NullPointerException expected) { 54 } 55 expectUnchanged(); 56 expectNullMissingWhenNullUnsupported( 57 "Should not contain null after unsupported offer(null)"); 58 } 59 } 60