Remove IOException from the method signatures that no longer

throw IOException.
        This maintains binary compatibility but not source
compatibility.
        - FilenameUtils
            directoryContains(String, String)
        - BoundedReader
            BoundedReader(java.io.Reader, int)
        - IOUtils
            lineIterator(java.io.InputStream, Charset)
            lineIterator(java.io.InputStream, String)
            toByteArray(String)
            toInputStream(CharSequence, String)
            toInputStream(String, String)
            toString(byte[])
            toString(byte[], String)

Author: Gary Gregory

src/changes/changes.xml

@@ -59,6 +59,25 @@ The <action> type attribute can be add,update,fix,remove.
       <action dev="ggregory" type="fix" due-to="Arturo Bernal">
         Replace construction of FileInputStream and FileOutputStream objects with Files NIO APIs. #221.
       </action>
+      <action dev="ggregory" type="fix" due-to="Gary Gregory">
+        Fix IndexOutOfBoundsException in IOExceptionList constructors.
+      </action>
+      <action dev="ggregory" type="fix" due-to="Gary Gregory">
+        Remove IOException from the method signatures that no longer throw IOException.
+        This maintains binary compatibility but not source compatibility.
+        - FilenameUtils
+            directoryContains(String, String)
+        - BoundedReader
+            BoundedReader(java.io.Reader, int)
+        - IOUtils
+            lineIterator(java.io.InputStream, Charset)
+            lineIterator(java.io.InputStream, String)
+            toByteArray(String)
+            toInputStream(CharSequence, String)
+            toInputStream(String, String)
+            toString(byte[])
+            toString(byte[], String)
+      </action>
       <!-- ADD -->
       <action dev="ggregory" type="update" due-to="Gary Gregory">
         Add SymbolicLinkFileFilter.

src/main/java/org/apache/commons/io/FilenameUtils.java

@@ -17,7 +17,6 @@
 package org.apache.commons.io;
 
 import java.io.File;
-import java.io.IOException;
 import java.util.ArrayDeque;
 import java.util.ArrayList;
 import java.util.Arrays;
@@ -533,12 +532,10 @@ public static String concat(final String basePath, final String fullFileNameToAd
      * @param canonicalChild
      *            the file to consider as the child.
      * @return true is the candidate leaf is under by the specified composite. False otherwise.
-     * @throws IOException Never thrown.
      * @since 2.2
      * @see FileUtils#directoryContains(File, File)
      */
-    public static boolean directoryContains(final String canonicalParent, final String canonicalChild)
-            throws IOException {
+    public static boolean directoryContains(final String canonicalParent, final String canonicalChild) {
         Objects.requireNonNull(canonicalParent, "canonicalParent");
 
         if (canonicalChild == null) {

src/main/java/org/apache/commons/io/IOUtils.java

@@ -1594,10 +1594,9 @@ public static int length(final Object[] array) {
      * @param charset the charset to use, null means platform default
      * @return an Iterator of the lines in the reader, never null
      * @throws IllegalArgumentException if the input is null
-     * @throws IOException Never thrown.
      * @since 2.3
      */
-    public static LineIterator lineIterator(final InputStream input, final Charset charset) throws IOException {
+    public static LineIterator lineIterator(final InputStream input, final Charset charset) {
         return new LineIterator(new InputStreamReader(input, Charsets.toCharset(charset)));
     }
 
@@ -1628,13 +1627,12 @@ public static LineIterator lineIterator(final InputStream input, final Charset c
      * @param charsetName the encoding to use, null means platform default
      * @return an Iterator of the lines in the reader, never null
      * @throws IllegalArgumentException                     if the input is null
-     * @throws IOException                                  if an I/O error occurs, such as if the encoding is invalid
      * @throws java.nio.charset.UnsupportedCharsetException thrown instead of {@link java.io
      *                                                      .UnsupportedEncodingException} in version 2.2 if the
      *                                                      encoding is not supported.
      * @since 1.2
      */
-    public static LineIterator lineIterator(final InputStream input, final String charsetName) throws IOException {
+    public static LineIterator lineIterator(final InputStream input, final String charsetName) {
         return lineIterator(input, Charsets.toCharset(charsetName));
     }
 
@@ -2543,11 +2541,10 @@ public static byte[] toByteArray(final Reader reader, final String charsetName)
      * @param input the {@code String} to convert
      * @return the requested byte array
      * @throws NullPointerException if the input is null
-     * @throws IOException Never thrown.
      * @deprecated 2.5 Use {@link String#getBytes()} instead
      */
     @Deprecated
-    public static byte[] toByteArray(final String input) throws IOException {
+    public static byte[] toByteArray(final String input) {
         // make explicit the use of the default charset
         return input.getBytes(Charset.defaultCharset());
     }
@@ -2717,13 +2714,12 @@ public static InputStream toInputStream(final CharSequence input, final Charset
      * @param input the CharSequence to convert
      * @param charsetName the name of the requested charset, null means platform default
      * @return an input stream
-     * @throws IOException Never thrown.
      * @throws java.nio.charset.UnsupportedCharsetException thrown instead of {@link java.io
      *                                                      .UnsupportedEncodingException} in version 2.2 if the
      *                                                      encoding is not supported.
      * @since 2.0
      */
-    public static InputStream toInputStream(final CharSequence input, final String charsetName) throws IOException {
+    public static InputStream toInputStream(final CharSequence input, final String charsetName) {
         return toInputStream(input, Charsets.toCharset(charsetName));
     }
 
@@ -2764,13 +2760,12 @@ public static InputStream toInputStream(final String input, final Charset charse
      * @param input the string to convert
      * @param charsetName the name of the requested charset, null means platform default
      * @return an input stream
-     * @throws IOException Never thrown.
      * @throws java.nio.charset.UnsupportedCharsetException thrown instead of {@link java.io
      *                                                      .UnsupportedEncodingException} in version 2.2 if the
      *                                                      encoding is not supported.
      * @since 1.1
      */
-    public static InputStream toInputStream(final String input, final String charsetName) throws IOException {
+    public static InputStream toInputStream(final String input, final String charsetName) {
         final byte[] bytes = input.getBytes(Charsets.toCharset(charsetName));
         return new ByteArrayInputStream(bytes);
     }
@@ -2782,11 +2777,10 @@ public static InputStream toInputStream(final String input, final String charset
      * @param input the byte array to read from
      * @return the requested String
      * @throws NullPointerException if the input is null
-     * @throws IOException Never thrown.
      * @deprecated 2.5 Use {@link String#String(byte[])} instead
      */
     @Deprecated
-    public static String toString(final byte[] input) throws IOException {
+    public static String toString(final byte[] input) {
         // make explicit the use of the default charset
         return new String(input, Charset.defaultCharset());
     }
@@ -2802,9 +2796,8 @@ public static String toString(final byte[] input) throws IOException {
      * @param charsetName the name of the requested charset, null means platform default
      * @return the requested String
      * @throws NullPointerException if the input is null
-     * @throws IOException Never thrown.
      */
-    public static String toString(final byte[] input, final String charsetName) throws IOException {
+    public static String toString(final byte[] input, final String charsetName) {
         return new String(input, Charsets.toCharset(charsetName));
     }
 

src/main/java/org/apache/commons/io/input/BoundedReader.java

@@ -53,9 +53,8 @@ public class BoundedReader extends Reader {
      *
      * @param target                   The target stream that will be used
      * @param maxCharsFromTargetReader The maximum number of characters that can be read from target
-     * @throws IOException Never thrown.
      */
-    public BoundedReader(final Reader target, final int maxCharsFromTargetReader) throws IOException {
+    public BoundedReader(final Reader target, final int maxCharsFromTargetReader) {
         this.target = target;
         this.maxCharsFromTargetReader = maxCharsFromTargetReader;
     }