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.features; 018 019import static com.google.common.collect.testing.Helpers.copyToSet; 020 021import com.google.common.annotations.GwtCompatible; 022import java.lang.annotation.Inherited; 023import java.lang.annotation.Retention; 024import java.lang.annotation.RetentionPolicy; 025import java.util.List; 026import java.util.Set; 027 028/** 029 * Optional features of classes derived from {@code List}. 030 * 031 * @author George van den Driessche 032 */ 033@SuppressWarnings("rawtypes") // maybe avoidable if we rework the whole package? 034@GwtCompatible 035public enum ListFeature implements Feature<List> { 036 SUPPORTS_SET, 037 SUPPORTS_ADD_WITH_INDEX(CollectionFeature.SUPPORTS_ADD), 038 SUPPORTS_REMOVE_WITH_INDEX(CollectionFeature.SUPPORTS_REMOVE), 039 040 GENERAL_PURPOSE( 041 CollectionFeature.GENERAL_PURPOSE, 042 SUPPORTS_SET, 043 SUPPORTS_ADD_WITH_INDEX, 044 SUPPORTS_REMOVE_WITH_INDEX), 045 046 /** Features supported by lists where only removal is allowed. */ 047 REMOVE_OPERATIONS(CollectionFeature.REMOVE_OPERATIONS, SUPPORTS_REMOVE_WITH_INDEX); 048 049 private final Set<Feature<? super List>> implied; 050 051 ListFeature(Feature<? super List>... implied) { 052 this.implied = copyToSet(implied); 053 } 054 055 @Override 056 public Set<Feature<? super List>> getImpliedFeatures() { 057 return implied; 058 } 059 060 @Retention(RetentionPolicy.RUNTIME) 061 @Inherited 062 @TesterAnnotation 063 public @interface Require { 064 ListFeature[] value() default {}; 065 066 ListFeature[] absent() default {}; 067 } 068}