UncheckedIOIterable.java

  1. /*
  2.  * Licensed to the Apache Software Foundation (ASF) under one or more
  3.  * contributor license agreements.  See the NOTICE file distributed with
  4.  * this work for additional information regarding copyright ownership.
  5.  * The ASF licenses this file to You under the Apache License, Version 2.0
  6.  * (the "License"); you may not use this file except in compliance with
  7.  * the License.  You may obtain a copy of the License at
  8.  *
  9.  *      http://www.apache.org/licenses/LICENSE-2.0
  10.  *
  11.  * Unless required by applicable law or agreed to in writing, software
  12.  * distributed under the License is distributed on an "AS IS" BASIS,
  13.  * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14.  * See the License for the specific language governing permissions and
  15.  * limitations under the License.
  16.  */

  17. package org.apache.commons.io.function;

  18. import java.io.IOException;
  19. import java.io.UncheckedIOException;
  20. import java.util.Iterator;
  21. import java.util.Objects;

  22. /**
  23.  * An {@link Iterable} for an {@link IOIterable} that throws {@link UncheckedIOException} instead of {@link IOException}.
  24.  * <p>
  25.  * Keep package-private for now.
  26.  * </p>
  27.  *
  28.  * @param <E> the type of elements returned by this iterator.
  29.  */
  30. final class UncheckedIOIterable<E> implements Iterable<E> {

  31.     private final IOIterable<E> delegate;

  32.     /**
  33.      * Constructs a new instance.
  34.      *
  35.      * @param delegate The delegate
  36.      */
  37.     UncheckedIOIterable(final IOIterable<E> delegate) {
  38.         this.delegate = Objects.requireNonNull(delegate, "delegate");
  39.     }

  40.     @Override
  41.     public Iterator<E> iterator() {
  42.         return new UncheckedIOIterator<>(delegate.iterator());
  43.     }

  44. }