View Javadoc
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.testers;
18  
19  import static com.google.common.collect.testing.features.CollectionFeature.ALLOWS_NULL_VALUES;
20  import static com.google.common.collect.testing.features.CollectionFeature.KNOWN_ORDER;
21  import static com.google.common.collect.testing.features.CollectionFeature.NON_STANDARD_TOSTRING;
22  import static com.google.common.collect.testing.features.CollectionSize.ONE;
23  import static com.google.common.collect.testing.features.CollectionSize.SEVERAL;
24  import static com.google.common.collect.testing.features.CollectionSize.ZERO;
25  
26  import com.google.common.annotations.GwtCompatible;
27  import com.google.common.collect.testing.AbstractCollectionTester;
28  import com.google.common.collect.testing.Helpers;
29  import com.google.common.collect.testing.features.CollectionFeature;
30  import com.google.common.collect.testing.features.CollectionSize;
31  
32  /**
33   * A generic JUnit test which tests {@code toString()} operations on a
34   * collection. Can't be invoked directly; please see
35   * {@link com.google.common.collect.testing.CollectionTestSuiteBuilder}.
36   *
37   * @author Kevin Bourrillion
38   */
39  @GwtCompatible
40  public class CollectionToStringTester<E> extends AbstractCollectionTester<E> {
41    public void testToString_minimal() {
42      assertNotNull("toString() should not return null", collection.toString());
43    }
44  
45    @CollectionSize.Require(ZERO)
46    @CollectionFeature.Require(absent = NON_STANDARD_TOSTRING)
47    public void testToString_size0() {
48      assertEquals("emptyCollection.toString should return []", "[]", collection.toString());
49    }
50  
51    @CollectionSize.Require(ONE)
52    @CollectionFeature.Require(absent = NON_STANDARD_TOSTRING)
53    public void testToString_size1() {
54      assertEquals(
55          "size1Collection.toString should return [{element}]",
56          "[" + e0() + "]",
57          collection.toString());
58    }
59  
60    @CollectionSize.Require(SEVERAL)
61    @CollectionFeature.Require(value = KNOWN_ORDER, absent = NON_STANDARD_TOSTRING)
62    public void testToString_sizeSeveral() {
63      String expected = Helpers.copyToList(getOrderedElements()).toString();
64      assertEquals("collection.toString() incorrect", expected, collection.toString());
65    }
66  
67    @CollectionSize.Require(absent = ZERO)
68    @CollectionFeature.Require(ALLOWS_NULL_VALUES)
69    public void testToString_null() {
70      initCollectionWithNullElement();
71      testToString_minimal();
72    }
73  }