Класс FilePermission

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

Путь — это путь к файлу или каталогу, которому предоставлены указанные действия. Путь, заканчивающийся на «/*/» (где «/» — разделитель пути, File.separatorChar) указывает на все файлы и каталоги, содержащиеся в этом каталоге. Путь, заканчивающийся на «/-», указывает (рекурсивно) все файлы и подкаталоги, содержащиеся в этом каталоге. Такой путь называется путём с подстановочными знаками. В противном случае это простой путь.

Путь, состоящий из специального обозначения «<<ВСЕ ФАЙЛЫ>>», соответствует любому файлу.

Примечание: Путь, состоящий из одного символа «*», указывает на все файлы в текущем каталоге, а путь, состоящий из одного символа «-», указывает на все файлы в текущем каталоге и (рекурсивно) на все файлы и подкаталоги, содержащиеся в текущем каталоге.

Действия, которые должны быть предоставлены, передаются в конструктор в строке, содержащей список одного или нескольких ключевых слов, разделенных запятыми. Возможные ключевые слова — «read», «write», «execute», «delete» и «readlink». Их значение определяется следующим образом:

read

право на чтение

write

право на запись

execute

право на выполнение. Разрешает вызов Runtime.exec. Соответствует SecurityManager.checkExec.

delete

право на удаление. Разрешает вызов File.delete. Соответствует SecurityManager.checkDelete.

readlink

право на чтение ссылки. Разрешает чтение целевого объекта символической ссылки, вызывая метод readSymbolicLink .

Строка действий преобразуется в нижний регистр перед обработкой.

Будьте осторожны при предоставлении прав FilePermission. Подумайте о последствиях предоставления прав на чтение и, особенно, на запись для различных файлов и каталогов. Права «<<ВСЕ ФАЙЛЫ>>» с действием «запись» особенно опасны. Это даёт право на запись во всю файловую систему. Это, в частности, позволяет заменить системные двоичные файлы, включая среду выполнения JVM.

Обратите внимание: код всегда может читать файл из того же каталога, где он находится (или из подкаталога этого каталога); ему не нужно явное разрешение для этого.

Конструкторы

FilePermission

public FilePermission(String path,
                      String actions)

Параметры:

path — путь к файлу/каталогу.

actions — строка действий.

Исключения:

IllegalArgumentException — Если actions пуста, содержит пустую строку или содержит действие, отличное от указанных возможных действий.

Методы

implies

public boolean implies(Permission p)

Указано в:

implies в классе Permission

Параметры:

p — разрешение для проверки.

Возвращает:

true если указанное разрешение не null и подразумевается этим объектом, false в противном случае.

equals

public boolean equals(Object obj)

Проверяет равенство двух объектов FilePermission. Проверяет, что obj является FilePermission и имеет тот же путь и те же действия, что и этот объект.

Указано в:

equals в классе Permission

Примечание для реализации:

Точнее, два пути одинаковы тогда и только тогда, когда у них одинаковый флаг подстановочных знаков и их npath равны. Или оба они «<<ВСЕ ФАЙЛЫ>>».

Параметры:

obj — объект, с которым мы проверяем равенство.

Возвращает:

true если obj является FilePermission и имеет тот же путь и те же действия, что и этот объект FilePermission, false в противном случае.

См. также:

Object.hashCode(), HashMap

hashCode

public int hashCode()

Возвращает хэш-код для этого объекта.

Указано в:

hashCode в классе Permission

Возвращает:

значение хэш-кода для этого объекта.

См. также:

Object.equals(java.lang.Object), System.identityHashCode(java.lang.Object)

getActions

public String getActions()

Возвращает «каноническое строковое представление» действий. То есть этот метод всегда возвращает присутствующие действия в следующем порядке: read, write, execute, delete, readlink. Например, если этот объект FilePermission разрешает действия write и read, вызов getActions вернёт строку «read,write».

Указано в:

getActions в классе Permission

Возвращает:

каноническое строковое представление действий.

newPermissionCollection

public PermissionCollection newPermissionCollection()

"/tmp/scratch/foo", "read,write",

Переопределяет:

newPermissionCollection в классе Permission

Возвращает:

новый объект PermissionCollection, подходящий для хранения FilePermission.