com.phloc.commons.io.file

Class FileOperations

java.lang.Object

com.phloc.commons.io.file.FileOperations

@Immutable
public final class FileOperations
extends Object

Wraps file operations.

Author:

Philip Helger

Field Summary

Fields

Modifier and Type	Field and Description
static boolean	DEFAULT_WARN_ON_DELETE_ROOT The default value for warning if we're about to delete the root directory.

Method Summary

Methods

Modifier and Type	Method and Description
static FileIOError	copyDirRecursive(File aSourceDir, File aTargetDir) Copy a directory including all child objects.
static FileIOError	copyFile(File aSourceFile, File aTargetFile) Copies the source file to the target file.
static FileIOError	createDir(File aDir) Create a new directory.
static FileIOError	createDirIfNotExisting(File aDir) Create a new directory if it does not exist.
static FileIOError	createDirRecursive(File aDir) Create a new directory.
static FileIOError	createDirRecursiveIfNotExisting(File aDir) Create a new directory if it does not exist.
static FileIOError	deleteDir(File aDir) Delete an existing directory.
static FileIOError	deleteDirIfExisting(File aDir) Delete an existing directory if it is existing.
static FileIOError	deleteDirRecursive(File aDir) Delete an existing directory including all child objects.
static FileIOError	deleteDirRecursiveIfExisting(File aDir) Delete an existing directory including all child objects if it is existing.
static FileIOError	deleteFile(File aFile) Delete an existing file.
static FileIOError	deleteFileIfExisting(File aFile) Delete a file if it is existing.
static boolean	isWarnOnDeleteRoot()
static FileIOError	renameDir(File aSourceDir, File aTargetDir) Rename a directory.
static FileIOError	renameFile(File aSourceFile, File aTargetFile) Rename a file.
static void	setWarnOnDeleteRoot(boolean bWarnOnDeleteRoot)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

DEFAULT_WARN_ON_DELETE_ROOT

public static final boolean DEFAULT_WARN_ON_DELETE_ROOT

The default value for warning if we're about to delete the root directory.

See Also:

Constant Field Values

Method Detail

isWarnOnDeleteRoot

public static boolean isWarnOnDeleteRoot()

setWarnOnDeleteRoot

public static void setWarnOnDeleteRoot(boolean bWarnOnDeleteRoot)

createDir

@Nonnull
public static FileIOError createDir(@Nonnull
                            File aDir)

Create a new directory. The direct parent directory already needs to exist.

Parameters:

aDir - The directory to be created. May not be null.

Returns:

A non-null error code.

createDirIfNotExisting

@Nonnull
public static FileIOError createDirIfNotExisting(@Nonnull
                                         File aDir)

Create a new directory if it does not exist. The direct parent directory already needs to exist.

Parameters:

aDir - The directory to be created if it does not exist. May not be null.

Returns:

A non-null error code.

createDirRecursive

@Nonnull
public static FileIOError createDirRecursive(@Nonnull
                                     File aDir)

Create a new directory. The parent directories are created if they are missing.

Parameters:

aDir - The directory to be created. May not be null.

Returns:

A non-null error code.

createDirRecursiveIfNotExisting

@Nonnull
public static FileIOError createDirRecursiveIfNotExisting(@Nonnull
                                                  File aDir)

Create a new directory if it does not exist. The direct parent directory already needs to exist.

Parameters:

aDir - The directory to be created if it does not exist. May not be null.

Returns:

A non-null error code.

deleteDir

@Nonnull
public static FileIOError deleteDir(@Nonnull
                            File aDir)

Delete an existing directory. The directory needs to be empty before it can be deleted.

Parameters:

aDir - The directory to be deleted. May not be null.

Returns:

A non-null error code.

deleteDirIfExisting

@Nonnull
public static FileIOError deleteDirIfExisting(@Nonnull
                                      File aDir)

Delete an existing directory if it is existing. The directory needs to be empty before it can be deleted.

Parameters:

aDir - The directory to be deleted. May not be null.

Returns:

A non-null error code.

deleteDirRecursive

@Nonnull
public static FileIOError deleteDirRecursive(@Nonnull
                                     File aDir)

Delete an existing directory including all child objects.

Parameters:

aDir - The directory to be deleted. May not be null.

Returns:

A non-null error code.

deleteDirRecursiveIfExisting

@Nonnull
public static FileIOError deleteDirRecursiveIfExisting(@Nonnull
                                               File aDir)

Delete an existing directory including all child objects if it is existing.

Parameters:

aDir - The directory to be deleted. May not be null.

Returns:

A non-null error code.

deleteFile

@Nonnull
public static FileIOError deleteFile(@Nonnull
                             File aFile)

Delete an existing file.

Parameters:

aFile - The file to be deleted. May not be null.

Returns:

A non-null error code.

deleteFileIfExisting

@Nonnull
public static FileIOError deleteFileIfExisting(@Nonnull
                                       File aFile)

Delete a file if it is existing.

Parameters:

aFile - The file to be deleted. May not be null.

Returns:

A non-null error code.

renameFile

@Nonnull
public static FileIOError renameFile(@Nonnull
                             File aSourceFile,
                             @Nonnull
                             File aTargetFile)

Rename a file.

Parameters:

aSourceFile - The original file name. May not be null.

aTargetFile - The destination file name. May not be null.

Returns:

A non-null error code.

renameDir

@Nonnull
public static FileIOError renameDir(@Nonnull
                            File aSourceDir,
                            @Nonnull
                            File aTargetDir)

Rename a directory.

Parameters:

aSourceDir - The original directory name. May not be null.

aTargetDir - The destination directory name. May not be null.

Returns:

A non-null error code.

copyFile

@Nonnull
public static FileIOError copyFile(@Nonnull
                           File aSourceFile,
                           @Nonnull
                           File aTargetFile)

Copies the source file to the target file.

Parameters:

aSourceFile - The source file to use. May not be null. Needs to be an existing file.

aTargetFile - The destination files. May not be null and may not be an existing file.

Returns:

A non-null error code.

copyDirRecursive

@Nonnull
public static FileIOError copyDirRecursive(@Nonnull
                                   File aSourceDir,
                                   @Nonnull
                                   File aTargetDir)

Copy a directory including all child objects.

Parameters:

aSourceDir - The source directory to be copied. May not be null.

aTargetDir - The destination directory where to be copied. This directory may not be existing. May not be null.

Returns:

A non-null error code.