001/*
002 * Copyright (C) 2008 The Guava Authors
003 *
004 * Licensed under the Apache License, Version 2.0 (the "License");
005 * you may not use this file except in compliance with the License.
006 * You may obtain a copy of the License at
007 *
008 * http://www.apache.org/licenses/LICENSE-2.0
009 *
010 * Unless required by applicable law or agreed to in writing, software
011 * distributed under the License is distributed on an "AS IS" BASIS,
012 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
013 * See the License for the specific language governing permissions and
014 * limitations under the License.
015 */
016
017package com.google.common.collect.testing.testers;
018
019import static com.google.common.collect.testing.features.CollectionSize.ZERO;
020import static java.util.Arrays.asList;
021
022import com.google.common.annotations.GwtCompatible;
023import com.google.common.collect.testing.features.CollectionSize;
024import org.junit.Ignore;
025
026/**
027 * A generic JUnit test which tests {@code toArray()} operations on a list. Can't be invoked
028 * directly; please see {@link com.google.common.collect.testing.ListTestSuiteBuilder}.
029 *
030 * @author Chris Povirk
031 */
032@GwtCompatible
033@Ignore("test runners must not instantiate and run this directly, only via suites we build")
034// @Ignore affects the Android test runner, which respects JUnit 4 annotations on JUnit 3 tests.
035@SuppressWarnings("JUnit4ClassUsedInJUnit3")
036public class ListToArrayTester<E> extends AbstractListTester<E> {
037  // CollectionToArrayTester tests everything except ordering.
038
039  public void testToArray_noArg() {
040    Object[] actual = getList().toArray();
041    assertArrayEquals("toArray() order should match list", createOrderedArray(), actual);
042  }
043
044  @CollectionSize.Require(absent = ZERO)
045  public void testToArray_tooSmall() {
046    Object[] actual = getList().toArray(new Object[0]);
047    assertArrayEquals("toArray(tooSmall) order should match list", createOrderedArray(), actual);
048  }
049
050  public void testToArray_largeEnough() {
051    Object[] actual = getList().toArray(new Object[getNumElements()]);
052    assertArrayEquals("toArray(largeEnough) order should match list", createOrderedArray(), actual);
053  }
054
055  private static void assertArrayEquals(String message, Object[] expected, Object[] actual) {
056    assertEquals(message, asList(expected), asList(actual));
057  }
058}