com.helger.commons.io.file

Class FileOperations

java.lang.Object

com.helger.commons.io.file.FileOperations

@ThreadSafe
public final class FileOperations
extends Object

Wraps file operations.

Author:

Philip Helger

Field Summary

Fields

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

Method Summary

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	isExceptionOnDeleteRoot()
static FileIOError	renameDir(File aSourceDir, File aTargetDir) Rename a directory.
static FileIOError	renameFile(File aSourceFile, File aTargetFile) Rename a file.
static void	setExceptionOnDeleteRoot(boolean bExceptionOnDeleteRoot)

Methods inherited from class java.lang.Object

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

Field Detail

DEFAULT_EXCEPTION_ON_DELETE_ROOT

public static final boolean DEFAULT_EXCEPTION_ON_DELETE_ROOT

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

See Also:

Constant Field Values

Method Detail

isExceptionOnDeleteRoot

public static boolean isExceptionOnDeleteRoot()

setExceptionOnDeleteRoot

public static void setExceptionOnDeleteRoot(boolean bExceptionOnDeleteRoot)

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.

See Also:

createDirRecursive(File)

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.

See Also:

deleteDir(File)

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.