Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
   * Copyright (C) 2008 The Guava Authors
   * Licensed under the Apache License, Version 2.0 (the "License");
   * you may not use this file except in compliance with the License.
   * You may obtain a copy of the License at
  * Unless required by applicable law or agreed to in writing, software
  * distributed under the License is distributed on an "AS IS" BASIS,
  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  * See the License for the specific language governing permissions and
  * limitations under the License.
 import java.util.Set;

When describing the features of the collection produced by a given generator (i.e. in a call to[])), this annotation specifies each of the different sizes for which a test suite should be built. (In a typical case, the features should include ANY.) These semantics are thus a little different from those of other Collection-related features such as CollectionFeature or SetFeature.

However, when CollectionSize.Require is used to annotate a test it behaves normally (i.e. it requires the collection instance under test to be a certain size for the test to run). Note that this means a test should not require more than one CollectionSize, since a particular collection instance can only be one size at once.

This class is GWT compatible.

George van den Driessche
 // Enum values use constructors with generic varargs.
 public enum CollectionSize implements Feature<Collection>,
     Comparable<CollectionSize> {
Test an empty collection.
Test a one-element collection.
Test a three-element collection.
    * TODO: add VERY_LARGE, noting that we currently assume that the fourth
    * sample element is not in any collection
   private final Set<Feature<? super Collection>> implied;
   private final Integer numElements;
   CollectionSize(int numElements) {
     this. = Collections.emptySet();
     this. = numElements;
   CollectionSize(Feature<? super Collection> ... implied) {
     // Keep the order here, so that PerCollectionSizeTestSuiteBuilder
     // gives a predictable order of test suites.
     this. = Helpers.copyToSet(implied);
     this. = null;
   public Set<Feature<? super Collection>> getImpliedFeatures() {
     return ;
   public int getNumElements() {
     if ( == null) {
       throw new IllegalStateException(
           "A compound CollectionSize doesn't specify a number of elements.");
     return ;
  public @interface Require {
    CollectionSize[] value() default {};
    CollectionSize[] absent() default {};
New to GrepCode? Check out our FAQ X