11d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert/* 21d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * Copyright (C) 2008 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.features; 181d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 197dd252788645e940eada959bdde927426e2531c9Paul Duffinimport com.google.common.annotations.GwtCompatible; 201d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport com.google.common.collect.testing.Helpers; 211d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 221d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport java.lang.annotation.Inherited; 231d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport java.lang.annotation.Retention; 241d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport java.lang.annotation.RetentionPolicy; 251d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport java.util.Collection; 261d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport java.util.Collections; 271d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertimport java.util.Set; 281d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 291d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert/** 301d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * When describing the features of the collection produced by a given generator 311d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * (i.e. in a call to {@link 321d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * com.google.common.collect.testing.FeatureSpecificTestSuiteBuilder#withFeatures(Feature...)}), 331d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * this annotation specifies each of the different sizes for which a test suite 341d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * should be built. (In a typical case, the features should include {@link 351d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * CollectionSize#ANY}.) These semantics are thus a little different 361d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * from those of other Collection-related features such as {@link 371d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * CollectionFeature} or {@link SetFeature}. 381d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * <p> 391d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * However, when {@link CollectionSize.Require} is used to annotate a test it 401d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * behaves normally (i.e. it requires the collection instance under test to be 411d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * a certain size for the test to run). Note that this means a test should not 421d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * require more than one CollectionSize, since a particular collection instance 431d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * can only be one size at once. 441d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * 451d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * @author George van den Driessche 461d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert */ 471d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert// Enum values use constructors with generic varargs. 481d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert@SuppressWarnings("unchecked") 497dd252788645e940eada959bdde927426e2531c9Paul Duffin@GwtCompatible 501d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringertpublic enum CollectionSize implements Feature<Collection>, 511d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert Comparable<CollectionSize> { 521d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert /** Test an empty collection. */ 531d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert ZERO(0), 541d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert /** Test a one-element collection. */ 551d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert ONE(1), 561d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert /** Test a three-element collection. */ 571d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert SEVERAL(3), 581d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert /* 591d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * TODO: add VERY_LARGE, noting that we currently assume that the fourth 601d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert * sample element is not in any collection 611d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert */ 621d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 631d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert ANY( 641d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert ZERO, 651d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert ONE, 661d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert SEVERAL 671d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert ); 681d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 691d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert private final Set<Feature<? super Collection>> implied; 701d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert private final Integer numElements; 711d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 721d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert CollectionSize(int numElements) { 731d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert this.implied = Collections.emptySet(); 741d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert this.numElements = numElements; 751d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 761d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 771d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert CollectionSize(Feature<? super Collection> ... implied) { 781d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert // Keep the order here, so that PerCollectionSizeTestSuiteBuilder 791d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert // gives a predictable order of test suites. 801d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert this.implied = Helpers.copyToSet(implied); 811d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert this.numElements = null; 821d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 831d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 841d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert @Override 851d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert public Set<Feature<? super Collection>> getImpliedFeatures() { 861d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert return implied; 871d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 881d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 891d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert public int getNumElements() { 901d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert if (numElements == null) { 911d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert throw new IllegalStateException( 921d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert "A compound CollectionSize doesn't specify a number of elements."); 931d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 941d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert return numElements; 951d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 961d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert 971d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert @Retention(RetentionPolicy.RUNTIME) 981d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert @Inherited 991d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert @TesterAnnotation 1001d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert public @interface Require { 1011d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert CollectionSize[] value() default {}; 1021d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert CollectionSize[] absent() default {}; 1031d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert } 1041d580d0f6ee4f21eb309ba7b509d2c6d671c4044Bjorn Bringert} 105