Class FileUtils
java.lang.Object
org.apache.tomcat.util.http.fileupload.FileUtils
General file manipulation utilities.
 
Facilities are provided in the following areas:
- writing to a file
- reading from a file
- make a directory including parent directories
- copying files and directories
- deleting files and directories
- converting to and from a URL
- listing files and directories by filter and extension
- comparing file content
- file last changed date
- calculating a checksum
Note that a specific charset should be specified whenever possible. Relying on the platform default means that the code is Locale-dependent. Only use the default if the files are known to always use the platform default.
Origin of code: Excalibur, Alexandria, Commons-Utils
- 
Constructor SummaryConstructors
- 
Method SummaryModifier and TypeMethodDescriptionstatic voidcleanDirectory(File directory) Cleans a directory without deleting it.static voiddeleteDirectory(File directory) Deletes a directory recursively.static voidforceDelete(File file) Deletes a file.static voidforceDeleteOnExit(File file) Schedules a file to be deleted when JVM exits.static voidforceMkdir(File directory) Makes a directory, including any necessary but nonexistent parent directories.static voidforceMkdirParent(File file) Makes any necessary but nonexistent parent directories for a given File.static booleanDetermines whether the specified file is a Symbolic Link rather than an actual file.
- 
Constructor Details- 
FileUtilspublic FileUtils()Instances should NOT be constructed in standard programming.
 
- 
- 
Method Details- 
deleteDirectoryDeletes a directory recursively.- Parameters:
- directory- directory to delete
- Throws:
- IOException- in case deletion is unsuccessful
- IllegalArgumentException- if- directorydoes not exist or is not a directory
 
- 
cleanDirectoryCleans a directory without deleting it.- Parameters:
- directory- directory to clean
- Throws:
- IOException- in case cleaning is unsuccessful
- IllegalArgumentException- if- directorydoes not exist or is not a directory
 
- 
forceDeleteDeletes 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:
- NullPointerException- if the directory is- null
- FileNotFoundException- if the file was not found
- IOException- in case deletion is unsuccessful
 
- 
forceDeleteOnExitSchedules 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:
- NullPointerException- if the file is- null
- IOException- in case deletion is unsuccessful
 
- 
forceMkdirMakes 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:
- NullPointerException- if the directory is- null
- IOException- if the directory cannot be created or the file already exists but is not a directory
 
- 
forceMkdirParentMakes 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:
- NullPointerException- if the file is- null
- IOException- if the parent directory cannot be created
- Since:
- 2.5
 
- 
isSymlinkDetermines 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 falseif the system is detected as Windows usingFile.separatorChar== '\\'- Parameters:
- file- the file to check
- Returns:
- true if the file is a Symbolic Link
- Throws:
- IOException- if an IO error occurs while checking the file
- Since:
- 2.0
 
 
-