Constructor Detail

• FileUtils

  public FileUtils()

  Instances should NOT be constructed in standard programming.

Method Detail

• deleteDirectory

  public static void deleteDirectory(java.io.File directory)
                              throws java.io.IOException

  Deletes a directory recursively.

  Parameters:

  directory - directory to delete

  Throws:

  java.io.IOException - in case deletion is unsuccessful

  java.lang.IllegalArgumentException - if directory does not exist or is not a directory

• cleanDirectory

  public static void cleanDirectory(java.io.File directory)
                             throws java.io.IOException

  Cleans a directory without deleting it.

  Parameters:

  directory - directory to clean

  Throws:

  java.io.IOException - in case cleaning is unsuccessful

  java.lang.IllegalArgumentException - if directory does not exist or is not a directory

• forceDelete

  public static void forceDelete(java.io.File file)
                          throws java.io.IOException

  Deletes a file. If file is a directory, delete it and all sub-directories.

  The difference between File.delete() and this method are:

  • A directory to be deleted does not have to be empty.
  • You get exceptions when a file or directory cannot be deleted. (java.io.File methods returns a boolean)

  Parameters:

  file - file or directory to delete, must not be null

  Throws:

  java.lang.NullPointerException - if the directory is null

  java.io.FileNotFoundException - if the file was not found

  java.io.IOException - in case deletion is unsuccessful

• forceDeleteOnExit

  public static void forceDeleteOnExit(java.io.File file)
                                throws java.io.IOException

  Schedules a file to be deleted when JVM exits. If file is directory delete it and all sub-directories.

  Parameters:

  file - file or directory to delete, must not be null

  Throws:

  java.lang.NullPointerException - if the file is null

  java.io.IOException - in case deletion is unsuccessful

• forceMkdir

  public static void forceMkdir(java.io.File directory)
                         throws java.io.IOException

  Makes a directory, including any necessary but nonexistent parent directories. If a file already exists with specified name but it is not a directory then an IOException is thrown. If the directory cannot be created (or does not already exist) then an IOException is thrown.

  Parameters:

  directory - directory to create, must not be null

  Throws:

  java.lang.NullPointerException - if the directory is null

  java.io.IOException - if the directory cannot be created or the file already exists but is not a directory

• forceMkdirParent

  public static void forceMkdirParent(java.io.File file)
                               throws java.io.IOException

  Makes any necessary but nonexistent parent directories for a given File. If the parent directory cannot be created then an IOException is thrown.

  Parameters:

  file - file with parent to create, must not be null

  Throws:

  java.lang.NullPointerException - if the file is null

  java.io.IOException - if the parent directory cannot be created

  Since:

  2.5

• isSymlink

  public static boolean isSymlink(java.io.File file)
                           throws java.io.IOException

  Determines whether the specified file is a Symbolic Link rather than an actual file.

  Will not return true if there is a Symbolic Link anywhere in the path, only if the specific file is.

  Note: the current implementation always returns false if the system is detected as Windows using File.separatorChar == '\\'

  Parameters:

  file - the file to check

  Returns:

  true if the file is a Symbolic Link

  Throws:

  java.io.IOException - if an IO error occurs while checking the file

  Since:

  2.0