IO-234 Add Methods For Retrieving System Directories/Paths to FileUtils - thanks to Michael Wooten for the patch

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

Author: Niall Pemberton

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

@@ -112,6 +112,51 @@ public FileUtils() {
      */
     public static final File[] EMPTY_FILE_ARRAY = new File[0];
 
+    //-----------------------------------------------------------------------
+    /**
+     * Returns the path to the system temporary directory.
+     * 
+     * @return the path to the system temporary directory.
+     * 
+     * @since Commons IO 2.0
+     */
+    public static String getTempDirectoryPath() {
+        return System.getProperty("java.io.tmpdir");
+    }
+    
+    /**
+     * Returns a {@link File} representing the system temporary directory.
+     * 
+     * @return the system temporary directory. 
+     * 
+     * @since Commons IO 2.0
+     */
+    public static File getTempDirectory() {
+        return new File(getTempDirectoryPath());
+    }
+    
+    /**
+     * Returns the path to the user's home directory.
+     * 
+     * @return the path to the user's home directory.
+     * 
+     * @since Commons IO 2.0
+     */
+    public static String getUserDirectoryPath() {
+        return System.getProperty("user.home");
+    }
+    
+    /**
+     * Returns a {@link File} representing the user's home directory.
+     * 
+     * @return the user's home directory.
+     * 
+     * @since Commons IO 2.0
+     */
+    public static File getUserDirectory() {
+        return new File(getUserDirectoryPath());
+    }
+    
     //-----------------------------------------------------------------------
     /**
      * Opens a {@link FileInputStream} for the specified file, providing better

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

@@ -100,6 +100,39 @@ protected void tearDown() throws Exception {
         FileUtils.deleteDirectory(getTestDirectory());
     }
 
+    //-----------------------------------------------------------------------
+    /**
+     * Tests the {@link FileUtils#getTempDirectoryPath()} method.
+     */
+    public void testGetTempDirectoryPath() {
+        assertEquals(System.getProperty("java.io.tmpdir"), 
+            FileUtils.getTempDirectoryPath());
+    }
+    
+    /**
+     * Tests the {@link FileUtils#getTempDirectory()} method.
+     */
+    public void testGetTempDirectory() {
+        File tempDirectory = new File(System.getProperty("java.io.tmpdir"));
+        assertEquals(tempDirectory, FileUtils.getTempDirectory());
+    }
+    
+    /**
+     * Tests the {@link FileUtils#getUserDirectoryPath()} method.
+     */
+    public void testGetUserDirectoryPath() {
+        assertEquals(System.getProperty("user.home"), 
+            FileUtils.getUserDirectoryPath());
+    }
+    
+    /**
+     * Tests the {@link FileUtils#getUserDirectory()} method.
+     */
+    public void testGetUserDirectory() {
+        File userDirectory = new File(System.getProperty("user.home"));
+        assertEquals(userDirectory, FileUtils.getUserDirectory());
+    }
+    
     //-----------------------------------------------------------------------
     public void test_openInputStream_exists() throws Exception {
         File file = new File(getTestDirectory(), "test.txt");