org.terracotta.utilities.test.io

Class CommonFiles

java.lang.Object

org.terracotta.utilities.test.io.CommonFiles

public final class CommonFiles
extends java.lang.Object

Tool for creating a system-wide, all-user-writable application file.

Constructor Summary

Constructors

Constructor and Description
CommonFiles()

Method Summary

Modifier and Type	Method and Description
static java.nio.file.Path	createCommonAppFile(java.nio.file.Path path) Creates a file, using the relative path provided, in the system-appropriate directory for persistent, cross-process, cross-user data.

Methods inherited from class java.lang.Object

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

Constructor Detail

CommonFiles

public CommonFiles()

Method Detail

createCommonAppFile

public static java.nio.file.Path createCommonAppFile(java.nio.file.Path path)
                                              throws java.io.IOException

Creates a file, using the relative path provided, in the system-appropriate directory for persistent, cross-process, cross-user data.

On Windows machines, the Windows directory assigned to the CommonApplicationData special folder is used. On *NIX machines, /var/tmp (not java.io.tmpdir) is used.

Parameters:

path - the relative path to the file to create within the common directory

Returns:

the path of the created file

Throws:

java.io.FileNotFoundException - if the system-appropriate directory does not exist

java.io.IOException - if an error is raised while attempting to create the file

java.lang.IllegalArgumentException - if path is not relative or is empty

See Also:

Environment.SpecialFolder Enum, Filesystem Hierarchy Standard