[IO-361] Add API FileUtils.forceMkdirsParent().

garydgregory · garydgregory · commit 587571dde227 · 2012-12-19T16:17:26.000Z
git-svn-id: https://svn.apache.org/repos/asf/commons/proper/io/trunk@1423916 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/src/changes/changes.xml b/src/changes/changes.xml
@@ -47,6 +47,9 @@ The <action> type attribute can be add,update,fix,remove.
   <body>
     <!-- The release date is the date RC is cut -->
     <release version="2.5" date="201?-??-??" description="New features and bug fixes.">    
+      <action issue="IO-361" dev="ggregory" type="add">
+        Add API FileUtils.forceMkdirsParent().
+      </action>            
       <action issue="IO-360" dev="ggregory" type="add">
         Add API Charsets.requiredCharsets().
       </action>            
diff --git a/src/main/java/org/apache/commons/io/FileUtils.java b/src/main/java/org/apache/commons/io/FileUtils.java
@@ -2421,6 +2421,26 @@ public static void forceMkdir(final File directory) throws IOException {
         }
     }
 
+    /**
+     * Makes any necessary but nonexistent parent directories for a given File. If the parent directory cannot be
+     * created then an IOException is thrown.
+     * 
+     * @param file
+     *            file with parent to create, must not be {@code null}
+     * @throws NullPointerException
+     *             if the file is {@code null}
+     * @throws IOException
+     *             if the parent directory cannot be created
+     * @since 2.5
+     */
+    public static void forceMkdirParent(final File file) throws IOException {
+        final File parent = file.getParentFile();
+        if (parent == null) {
+            return;
+        }
+        forceMkdir(parent);
+    }
+
     //-----------------------------------------------------------------------
     /**
      * Returns the size of the specified file or directory. If the provided 
diff --git a/src/test/java/org/apache/commons/io/FileUtilsTestCase.java b/src/test/java/org/apache/commons/io/FileUtilsTestCase.java
@@ -746,6 +746,29 @@ public void testForceMkdir() throws Exception {
         assertTrue("Directory was not created.", testFile.exists());
     }
 
+    public void testForceMkdirParent() throws Exception {
+        // Tests with existing directory
+        assertTrue(getTestDirectory().exists());
+        final File testParentDir = new File(getTestDirectory(), "testForceMkdirParent");
+        try {
+            testParentDir.delete();
+            assertFalse(testParentDir.exists());
+            final File testFile = new File(testParentDir, "test.txt");
+            assertFalse(testParentDir.exists());
+            assertFalse(testFile.exists());
+            // Create
+            FileUtils.forceMkdirParent(testFile);
+            assertTrue(testParentDir.exists());
+            assertFalse(testFile.exists());
+            // Again
+            FileUtils.forceMkdirParent(testFile);
+            assertTrue(testParentDir.exists());
+            assertFalse(testFile.exists());
+        } finally {
+            testParentDir.delete();
+        }
+    }
+
     // sizeOfDirectory
 
     public void testSizeOfDirectory() throws Exception {
