1 /* 2 * Copyright (C) 2007 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; 18 19 import com.google.common.annotations.GwtCompatible; 20 import com.google.common.collect.testing.SampleElements.Strings; 21 22 import java.util.List; 23 import java.util.Set; 24 25 /** 26 * Create string sets for collection tests. 27 * 28 * @author Kevin Bourrillion 29 */ 30 @GwtCompatible 31 public abstract class TestStringSetGenerator implements TestSetGenerator<String> 32 { 33 @Override 34 public SampleElements<String> samples() { 35 return new Strings(); 36 } 37 38 @Override 39 public Set<String> create(Object... elements) { 40 String[] array = new String[elements.length]; 41 int i = 0; 42 for (Object e : elements) { 43 array[i++] = (String) e; 44 } 45 return create(array); 46 } 47 48 protected abstract Set<String> create(String[] elements); 49 50 @Override 51 public String[] createArray(int length) { 52 return new String[length]; 53 } 54 55 /** 56 * {@inheritDoc} 57 * 58 * <p>By default, returns the supplied elements in their given order; however, 59 * generators for containers with a known order other than insertion order 60 * must override this method. 61 * 62 * <p>Note: This default implementation is overkill (but valid) for an 63 * unordered container. An equally valid implementation for an unordered 64 * container is to throw an exception. The chosen implementation, however, has 65 * the advantage of working for insertion-ordered containers, as well. 66 */ 67 @Override 68 public List<String> order(List<String> insertionOrder) { 69 return insertionOrder; 70 } 71 } 72
