Интерфейс SecureDirectoryStream<T>

public interface SecureDirectoryStream<T>
extends DirectoryStream<T>

A DirectoryStream, определяющий операции над файлами, расположенными относительно открытого каталога. A SecureDirectoryStream предназначен для использования в сложных или требующих повышенной безопасности приложениях, которые требуют обхода древовидной структуры файлов или других операций с каталогами без гонок. Гонки могут возникнуть, когда последовательность операций с файлами не может быть выполнена изолированно. Каждая из операций с файлами, определённых в этом интерфейсе, указывает относительный путь. Все доступ к файлам относительны к открытому каталогу независимо от того, был ли каталог перемещён или заменён злоумышленником во время его открытия. A SecureDirectoryStream также может использоваться как виртуальный рабочий каталог.

A SecureDirectoryStream требует соответствующей поддержки от underlying операционной системы. В тех случаях, когда реализация поддерживает эти функции, то DirectoryStream возвращаемый методом newDirectoryStream будет SecureDirectoryStream и должен быть приведён к этому типу для вызова методов, определённых в этом интерфейсе.

В случае использования по умолчанию provider, и если установлен менеджер безопасности, то проверки разрешений выполняются с использованием пути, полученного путём разрешения данного относительного пути по отношению к исходному пути каталога (независимо от того, был ли каталог перемещён после его открытия).

Методы

newDirectoryStream

SecureDirectoryStream<T> newDirectoryStream(T path,
                                            LinkOption... options)
                                     throws IOException

Параметры:

path - путь к открываемой директории

options - опции, определяющие, как обрабатываются символические ссылки

Возвращает:

новый и открытый объект SecureDirectoryStream

Исключения:

ClosedDirectoryStreamException - если поток директории закрыт

NotDirectoryException - если файл не может быть открыт по другим причинам, так как он не является директорией (опциональное специфическое исключение)

IOException - если произошла ошибка ввода-вывода

SecurityException - В случае с поставщиком по умолчанию и установленным менеджером безопасности, вызывается метод checkRead для проверки права доступа на чтение к директории.

newByteChannel

SeekableByteChannel newByteChannel(T path,
                                   Set<? extends OpenOption> options,
                                   FileAttribute<?>... attrs)
                            throws IOException

Параметры:

path - путь к открываемому или создаваемому файлу

options - опции, определяющие, как открывается файл

attrs - необязательный список атрибутов, которые нужно установить атомарно при создании файла

Возвращает:

поисковый байтовый канал

Исключения:

ClosedDirectoryStreamException - если поток директории закрыт

IllegalArgumentException - если набор содержит недопустимую комбинацию опций

UnsupportedOperationException - если указана неподдерживаемая опция открытия или массив содержит атрибуты, которые не могут быть установлены атомарно при создании файла

FileAlreadyExistsException - если файл с таким именем уже существует и указана опция CREATE_NEW (опциональное специфическое исключение)

IOException - если произошла ошибка ввода-вывода

SecurityException - В случае с поставщиком по умолчанию и установленным менеджером безопасности, вызывается метод checkRead для проверки права доступа на чтение к пути, если файл открыт для чтения. Метод checkWrite вызывается для проверки права доступа на запись к пути, если файл открыт для записи.

deleteFile

void deleteFile(T path)
         throws IOException

Параметры:

path - путь к удаляемому файлу

Исключения:

ClosedDirectoryStreamException - если поток директории закрыт

NoSuchFileException - если файл не существует (опциональное специфическое исключение)

IOException - если произошла ошибка ввода-вывода

SecurityException - В случае с поставщиком по умолчанию и установленным менеджером безопасности, вызывается метод checkDelete для проверки права доступа на удаление файла

deleteDirectory

void deleteDirectory(T path)
              throws IOException

Параметры:

path - путь к удаляемой директории

Исключения:

ClosedDirectoryStreamException - если поток директории закрыт

NoSuchFileException - если директория не существует (опциональное специфическое исключение)

DirectoryNotEmptyException - если директория не может быть удалена, потому что она не пустая (опциональное специфическое исключение)

IOException - если произошла ошибка ввода-вывода

SecurityException - В случае с поставщиком по умолчанию и установленным менеджером безопасности, вызывается метод checkDelete для проверки права доступа на удаление директории

move

void move(T srcpath,
          SecureDirectoryStream<T> targetdir,
          T targetpath)
   throws IOException

Параметры:

srcpath - имя перемещаемого файла

targetdir - целевая директория

targetpath - имя файла в целевой директории

Исключения:

ClosedDirectoryStreamException - если этот или целевой поток директории закрыт

FileAlreadyExistsException - если файл уже существует в целевой директории и не может быть заменен (опциональное специфическое исключение)

AtomicMoveNotSupportedException - если файл не может быть перемещен как атомная операция файловой системы

IOException - если произошла ошибка ввода-вывода

SecurityException - В случае с поставщиком по умолчанию и установленным менеджером безопасности, вызывается метод checkWrite для проверки права доступа на запись к исходному и целевому файлу.

getFileAttributeView

<V extends FileAttributeView> V getFileAttributeView(Class<V> type)

Тип параметров:

V - тип FileAttributeView

Параметры:

type - объект Class соответствующий просмотру атрибутов файла

Возвращает:

новый просмотр атрибутов файла указанного типа, связанный с этим потоком директории, или null если тип просмотра атрибутов недоступен

getFileAttributeView

<V extends FileAttributeView> V getFileAttributeView(T path,
                                                     Class<V> type,
                                                     LinkOption... options)

Параметры типа:

V - тип FileAttributeView

Параметры:

path - путь к файлу

type - объект Class, соответствующий представлению атрибутов файла

options - параметры, определяющие обработку символических ссылок

Возвращает:

новое представление атрибутов файла указанного типа, привязанное к потоку этого каталога, или null, если тип представления атрибутов недоступен