com.atlassian.bamboo.utils

Class BambooPathUtils

java.lang.Object

com.atlassian.bamboo.utils.BambooPathUtils

public class BambooPathUtils
extends Object

Provides functionality equivalent to Apache FileUtils, but on Paths. Do not add methods that do not exist in Apache class to this class, use BambooFiles instead. Any change to this class should pass a full suite of Apache Commons IO unit tests. See https://hello.atlassian.net/wiki/spaces/BAMBOO/pages/141524177/Testing+BambooPathUtils+against+Apache+Commons+IO+unit+tests for details

Constructor Summary

Constructors

Constructor and Description
BambooPathUtils()

Method Summary

Modifier and Type	Method and Description
static void	cleanDirectory(@NotNull Path directoryToCleanOrSymlink)
static boolean	contentEquals(@NotNull Path file1, @NotNull Path file2)
static void	deleteDirectory(@NotNull Path path)
static boolean	deleteQuietly(@Nullable Path path)
static void	forceDelete(@NotNull Path path)
static OutputStream	openOutputStream(Path file)
static OutputStream	openOutputStream(Path file, boolean append)
static String	readFileToString(Path path, Charset encoding)
static @Nullable Path	toPath(@Nullable File file)
static Path	toRealPathIfNeeded(@NotNull Path maybeSymlink) Returns a fully dereferenced path (including hardlinks) if the supplied argument is a symlink.
static void	writeStringToFile(Path file, String data, Charset charset)

Methods inherited from class java.lang.Object

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

Constructor Detail

BambooPathUtils

public BambooPathUtils()

Method Detail

deleteQuietly

public static boolean deleteQuietly(@Nullable
                                    @Nullable Path path)

See Also:

FileUtils.deleteQuietly(File)

cleanDirectory

public static void cleanDirectory(@NotNull
                                  @NotNull Path directoryToCleanOrSymlink)
                           throws IOException

Throws:

IOException

See Also:

FileUtils.cleanDirectory(File)

deleteDirectory

public static void deleteDirectory(@NotNull
                                   @NotNull Path path)
                            throws IOException

Throws:

IOException

See Also:

FileUtils.deleteDirectory(File)

forceDelete

public static void forceDelete(@NotNull
                               @NotNull Path path)
                        throws IOException

Throws:

IOException

See Also:

FileUtils.forceDelete(File)

toRealPathIfNeeded

public static Path toRealPathIfNeeded(@NotNull
                                      @NotNull Path maybeSymlink)
                               throws IOException

Returns a fully dereferenced path (including hardlinks) if the supplied argument is a symlink.

Throws:

IOException

writeStringToFile

public static void writeStringToFile(Path file,
                                     String data,
                                     Charset charset)
                              throws IOException

Throws:

IOException

See Also:

FileUtils#writeStringToFile(File, String, Charset)}

toPath

@Nullable
public static @Nullable Path toPath(@Nullable
                                              @Nullable File file)

openOutputStream

public static OutputStream openOutputStream(Path file)
                                     throws IOException

Throws:

IOException

See Also:

FileUtils#openOutputStream(File)}

openOutputStream

public static OutputStream openOutputStream(Path file,
                                            boolean append)
                                     throws IOException

Throws:

IOException

See Also:

FileUtils#openOutputStream(File, boolean)}

contentEquals

public static boolean contentEquals(@NotNull
                                    @NotNull Path file1,
                                    @NotNull
                                    @NotNull Path file2)
                             throws IOException

Throws:

IOException

See Also:

FileUtils.contentEquals(File, File)

readFileToString

public static String readFileToString(Path path,
                                      Charset encoding)
                               throws IOException

Throws:

IOException

See Also:

FileUtils.readFileToString(File, Charset)