Module com.aoapps.io.filesystems.posix

Package com.aoapps.io.filesystems.posix

Interface PosixFileSystem

All Superinterfaces:

FileSystem

All Known Implementing Classes:

DedupPosixFileSystem, DefaultPosixFileSystem, RandomFailPosixFileSystem, ReadOnlyPosixFileSystem, TempPosixFileSystem

public interface PosixFileSystem
extends FileSystem

The most basic layer of what Unix file systems have in common.

Note: The JVM must be in a single-byte locale, such as "C", "POSIX", or "en_US". PosixFile makes this assumption in its JNI implementation.

Author:

AO Industries, Inc.

See Also:

• PosixFile

Method Summary

Modifier and Type	Method	Description
default void	checkSubPath(Path parent, String name)	Checks a sub-path.
Path	createDirectory(Path path, int mode)	Atomically creates a directory (must not have already existed) with the given permissions.
Path	createFile(Path path, int mode)	Atomically creates an empty file (must not have already existed) with the given permissions.
Stat	stat(Path path)	Stats the given path.

Methods inherited from interface com.aoapps.io.filesystems.FileSystem

createDirectory, createFile, delete, join, list, lock, parsePath, size

Method Details

checkSubPath

default void checkSubPath(Path parent,
 String name)
                   throws InvalidPathException

Checks a sub-path. Unix filename restrictions are:

1. Must not be longer than MAX_PATH_NAME_LENGTH characters
2. Must not contain the NULL character
3. Must not contain the '/' character
4. Must not be "."
5. Must not be ".."

Specified by:

checkSubPath in interface FileSystem

Throws:

InvalidPathException

stat

Stat stat(Path path)
   throws IOException

Stats the given path.

Parameters:

path - Must be from this file system.

Throws:

IOException

createFile

Path createFile(Path path,
 int mode)
         throws IOException

Atomically creates an empty file (must not have already existed) with the given permissions.

Returns:

returns the path

Throws:

UnsupportedOperationException - if unable to create atomically

FileAlreadyExistsException - if file already exists

IOException - if an underlying I/O error occurs.

createDirectory

Path createDirectory(Path path,
 int mode)
              throws IOException

Atomically creates a directory (must not have already existed) with the given permissions.

Returns:

returns the path

Throws:

UnsupportedOperationException - if unable to create atomically

FileAlreadyExistsException - if file already exists

IOException - if an underlying I/O error occurs.