Home | History | Annotate | Download | only in testers
      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",
     43         collection.toString());
     44   }
     45 
     46   @CollectionSize.Require(ZERO)
     47   @CollectionFeature.Require(absent = NON_STANDARD_TOSTRING)
     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)
     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)
     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)
     71   public void testToString_null() {
     72     initCollectionWithNullElement();
     73     testToString_minimal();
     74   }
     75 }
     76