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