content: /*
   * Created on Nov 26, 2010
   *
   * Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with
   * the License. You may obtain a copy of the License at
   *
   * http://www.apache.org/licenses/LICENSE-2.0
   *
   * Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on
   * an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the
   * specific language governing permissions and limitations under the License.
   *
   * Copyright @2010-2012 the original author or authors.
   */
  package org.fest.assertions.util;
  
  import java.lang.reflect.Array;
  import java.util.AbstractList;
  
  import org.fest.util.VisibleForTesting;
  
  /**
   * A list-like wrapper for arrays. This class does not provide type-safety in order to handle both arrays of objects
   * and arrays of primitives.
   *
   * @author Alex Ruiz
   * @author Yvonne Wang
   */
  public class ArrayWrapperList extends AbstractList<Object> {
  
    /**
     * Wraps a given array with a <code>{@link ArrayWrapperList}</code>
     *
     * @param array the array to wrap.
     * @return the wrapped array or {@code null} if the given array was already {@code null}.
     * @throws IllegalArgumentException if the {@code array} is not an array.
     */
    public static ArrayWrapperList wrap(Object array) {
      if (array == null) {
        return null;
      }
      if (!array.getClass().isArray()) {
        throw new IllegalArgumentException("The object to wrap should be an array");
      }
      return new ArrayWrapperList(array);
    }
  
    @VisibleForTesting
    final Object array;
  
    @VisibleForTesting
    ArrayWrapperList(Object array) {
      this.array = array;
    }
  
    /**
     * {@inheritDoc}
     */
    @Override
    public Object get(int index) {
      checkIsInRange(index);
      return Array.get(array, index);
    }
  
    private void checkIsInRange(int index) {
      int size = size();
      if (index >= 0 && index < size()) {
        return;
      }
      String message = String.format("Index should be between 0 and %d (inclusive,) but was %d", size - 1, index);
      throw new IndexOutOfBoundsException(message);
    }
  
    /**
     * {@inheritDoc}
     */
    @Override
    public int size() {
      return Array.getLength(array);
    }
  
    /**
     * Returns the component type of the wrapped array.
     *
     * @return the component type of the wrapped array.
     */
    public Class<?> getComponentType() {
      return array.getClass().getComponentType();
    }
  }
  