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