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> {
testToString_minimal()41   public void testToString_minimal() {
42     assertNotNull("toString() should not return null",
43         collection.toString());
44   }
45 
46   @CollectionSize.Require(ZERO)
47   @CollectionFeature.Require(absent = NON_STANDARD_TOSTRING)
testToString_size0()48   public void testToString_size0() {
49     assertEquals("emptyCollection.toString should return []", "[]",
50         collection.toString());
51   }
52 
53   @CollectionSize.Require(ONE)
54   @CollectionFeature.Require(absent = NON_STANDARD_TOSTRING)
testToString_size1()55   public void testToString_size1() {
56     assertEquals("size1Collection.toString should return [{element}]",
57         "[" + samples.e0 + "]", collection.toString());
58   }
59 
60   @CollectionSize.Require(SEVERAL)
61   @CollectionFeature.Require(
62       value = KNOWN_ORDER, absent = NON_STANDARD_TOSTRING)
testToString_sizeSeveral()63   public void testToString_sizeSeveral() {
64     String expected = Helpers.copyToList(getOrderedElements()).toString();
65     assertEquals("collection.toString() incorrect",
66         expected, collection.toString());
67   }
68 
69   @CollectionSize.Require(absent = ZERO)
70   @CollectionFeature.Require(ALLOWS_NULL_VALUES)
testToString_null()71   public void testToString_null() {
72     initCollectionWithNullElement();
73     testToString_minimal();
74   }
75 }
76