Package org.fest.util
Class Files
java.lang.Object
org.fest.util.Files
Utility methods related to files.
- Author:
- Yvonne Wang, Alex Ruiz
-
Method Summary
Modifier and TypeMethodDescriptionstatic String
Loads the text content of a file into a character string.static String
Loads the text content of a file into a character string.static File
Returns the current directory.static void
Deletes the given file or directory.fileNamesIn
(String dirName, boolean recurse) Returns the names of the files inside the specified directory.static void
Flushes and closes the given
.OutputStream
static void
flushAndClose
(Writer writer) Flushes and closes the given
.Writer
static File
Creates a new file using the given path.static File
Creates a new directory using the given path.static File
Creates a new file in the system's temporary directory.static File
Creates a new directory in the system's temporary directory.static File
Returns the system's temporary directory.static String
Returns the path of the system's temporary directory.
-
Method Details
-
fileNamesIn
Returns the names of the files inside the specified directory.- Parameters:
dirName
- the name of the directory to start the search from.recurse
- iftrue
, we will look in subdirectories.- Returns:
- the names of the files inside the specified directory.
- Throws:
IllegalArgumentException
- if the given directory name does not point to an existing directory.
-
temporaryFolder
Returns the system's temporary directory.- Returns:
- the system's temporary directory.
- Throws:
FilesException
- if this method cannot find or create the system's temporary directory.
-
temporaryFolderPath
Returns the path of the system's temporary directory. This method appends the system's file separator at the end of the path.- Returns:
- the path of the system's temporary directory.
-
newTemporaryFile
Creates a new file in the system's temporary directory. The name of the file will be the result of:concat(String.valueOf(System.currentTimeMillis()), ".txt");
- Returns:
- the created file.
-
newTemporaryFolder
Creates a new directory in the system's temporary directory. The name of the directory will be the result of:System.currentTimeMillis();
- Returns:
- the created file.
-
newFile
Creates a new file using the given path.- Parameters:
path
- the path of the new file.- Returns:
- the new created file.
- Throws:
FilesException
- if the path belongs to an existing non-empty directory.FilesException
- if the path belongs to an existing file.FilesException
- if any I/O error is thrown when creating the new file.
-
newFolder
Creates a new directory using the given path.- Parameters:
path
- the path of the new directory.- Returns:
- the new created directory.
- Throws:
FilesException
- if the path belongs to an existing non-empty directory.FilesException
- if the path belongs to an existing file.FilesException
- if any I/O error is thrown when creating the new directory.
-
flushAndClose
Flushes and closes the given
. Any I/O errors catched by this method are ignored and not rethrown.Writer
- Parameters:
writer
- the writer to flush and close.
-
flushAndClose
Flushes and closes the given
. Any I/O errors catched by this method are ignored and not rethrown.OutputStream
- Parameters:
out
- the output stream to flush and close.
-
currentFolder
Returns the current directory.- Returns:
- the current directory.
- Throws:
FilesException
- if the current directory cannot be obtained.
-
delete
Deletes the given file or directory.- Parameters:
file
- the file or directory to delete.
-
contentOf
Loads the text content of a file into a character string.- Parameters:
file
- the file.charsetName
- the name of the character set to use.- Returns:
- the content of the file.
- Throws:
IllegalArgumentException
- if the given character set is not supported on this platform.FilesException
- if an I/O exception occurs.
-
contentOf
Loads the text content of a file into a character string.- Parameters:
file
- the file.charset
- the character set to use.- Returns:
- the content of the file.
- Throws:
NullPointerException
- if the given charset isnull
.FilesException
- if an I/O exception occurs.
-