A first cut on [IO-148] IOException with constructors which take a cause. Only one constructor implemented. Class name up for discussion. Copied from Apache Tika implementation by Jukka Zitting (see http://svn.apache.org/viewvc?view=rev&revision=606139)

git-svn-id: https://svn.apache.org/repos/asf/commons/proper/io/trunk@606340 13f79535-47bb-0310-9956-ffa450edef68

Author: garydgregory

src/java/org/apache/commons/io/CausedIOException.java

@@ -0,0 +1,52 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You 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.
+ */
+
+package org.apache.commons.io;
+
+import java.io.IOException;
+
+/**
+ * Subclasses IOException with the {@link Throwable} constructor was missing before Java 6.
+ * 
+ * @see <a href="mailto:commons-user@jakarta.apache.org">Apache Commons Users List</a>
+ * @author <a href="http://commons.apache.org/io/">Apache Commons IO</a>
+ * @version $Id: $
+ */
+public class CausedIOException extends IOException {
+
+    /**
+     * Default serial version UID.
+     */
+    private static final long serialVersionUID = 1L;
+
+    /**
+     * Creates an instance with the given message and cause.
+     * <p>
+     * This constructor was not added in the underlying {@link IOException} class until Java 6. This is a convenience
+     * method which uses the {@link #initCause(Throwable)} method to set the root cause.
+     * 
+     * @param message
+     *            exception message
+     * @param cause
+     *            root cause
+     */
+    public CausedIOException(String message, Throwable cause) {
+        super(message);
+        this.initCause(cause);
+    }
+
+}

src/test/org/apache/commons/io/CausedIOExceptionTestCase.java

@@ -0,0 +1,40 @@
+/*
+ * Licensed to the Apache Software Foundation (ASF) under one or more
+ * contributor license agreements.  See the NOTICE file distributed with
+ * this work for additional information regarding copyright ownership.
+ * The ASF licenses this file to You 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.
+ */
+
+package org.apache.commons.io;
+
+import junit.framework.TestCase;
+
+/**
+ * Tests CausedIOException
+ * 
+ * @author <a href="mailto:ggregory@seagullsw.com">Gary Gregory</a>
+ * @version $Id: $
+ */
+public class CausedIOExceptionTestCase extends TestCase {
+
+    /**
+     * Tests the {@link CausedIOException#CausedIOException(String,Throwable)} constructor.
+     */
+    public void testIOExceptionStringThrowable() {
+        Throwable cause = new IllegalArgumentException("cause");
+        CausedIOException exception = new CausedIOException("message", cause);
+        assertEquals("message", exception.getMessage());
+        assertEquals(cause, exception.getCause());
+        assertSame(cause, exception.getCause());
+    }
+}

src/test/org/apache/commons/io/PackageTestSuite.java

@@ -35,6 +35,7 @@ public static void main(String[] args) {
 
     public static Test suite() {
         TestSuite suite = new TestSuite("IO Utilities");
+        suite.addTest(new TestSuite(CausedIOExceptionTestCase.class));
         suite.addTest(new TestSuite(CopyUtilsTest.class));
         suite.addTest(new TestSuite(DemuxTestCase.class));
         suite.addTest(new TestSuite(DirectoryWalkerTestCase.class));