Класс FilePermission

public FilePermission(String path, String actions)

Примечание по реализации:

В этой реализации системное свойство jdk.io.permissionsUseCanonicalPath определяет способ обработки и хранения аргумента path.

Если значение системного свойства установлено в true, path приводится к каноническому виду и сохраняется как объект String с именем cpath. Это означает, что относительный путь преобразуется в абсолютный, путь Windows в формате DOS 8.3 разворачивается в длинный путь, символическая ссылка разрешается в путь к ее целевому объекту и т. д.

Если значение системного свойства установлено в false, path преобразуется в объект Path с именем npath после вызова normalization. Канонизация не выполняется, то есть доступ к базовой файловой системе не осуществляется. Если при преобразовании выбрасывается InvalidPathException, этот FilePermission будет помечен как недопустимый.

В обоих случаях символ "*" или "-" в конце пути с подстановочным знаком path удаляется перед канонизацией или нормализацией. Он сохраняется в отдельном поле флага подстановочного знака.

В этой реализации значением системного свойства jdk.io.permissionsUseCanonicalPath по умолчанию является false.

Значение также можно задать с помощью свойства безопасности с тем же именем, но системное свойство имеет приоритет над значением свойства безопасности.

Параметры:

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

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

Выбрасывает:

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

public boolean implies(Permission p)

Определено в:

implies в классе Permission

Примечание по реализации:

Если jdk.io.permissionsUseCanonicalPath равно true, простой cpath находится внутри пути с подстановочным знаком cpath тогда и только тогда, когда после удаления базового имени (последнего имени в последовательности имен пути) из первого оставшаяся часть равна второму; простой cpath находится внутри пути с подстановочным знаком cpath, включая вложенные каталоги, тогда и только тогда, когда первый начинается со второго.

Если jdk.io.permissionsUseCanonicalPath равно false, простой npath находится внутри пути с подстановочным знаком npath тогда и только тогда, когда simple_npath.relativize(wildcard_npath) в точности равно ".."; простой npath находится внутри пути с подстановочным знаком npath, включая вложенные каталоги, тогда и только тогда, когда simple_npath.relativize(wildcard_npath) представляет собой последовательность из одного или нескольких элементов "..". Это означает, что "/-" подразумевает "/foo", но не "foo".

Недопустимый FilePermission не подразумевает ни один объект, кроме самого себя. Недопустимый FilePermission не подразумевается ни одним объектом, кроме самого себя или FilePermission для "<<ALL FILES>>", действия которого являются надмножеством действий этого недопустимого FilePermission. Даже если два FilePermission созданы с одним и тем же недопустимым путем, один не подразумевает другой.

Параметры:

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

Возвращает:

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

public boolean equals(Object obj)

Определено в:

equals в классе Permission

Примечание по реализации:

Точнее, два пути совпадают тогда и только тогда, когда у них одинаковый флаг подстановочного знака и их cpath (если jdk.io.permissionsUseCanonicalPath равно true) или npath (если jdk.io.permissionsUseCanonicalPath равно false) равны. Либо оба пути равны "<<ALL FILES>>".

Когда jdk.io.permissionsUseCanonicalPath равно false, недопустимый FilePermission не равен ни одному объекту, кроме самого себя, даже если они созданы с использованием одного и того же недопустимого пути.

Параметры:

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

Возвращает:

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

См. также:

• Object.hashCode()
• HashMap

public int hashCode()

Определено в:

hashCode в классе Permission

Возвращает:

хеш-код этого объекта.

См. также:

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

public String getActions()

Определено в:

getActions в классе Permission

Возвращает:

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

public PermissionCollection newPermissionCollection()

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

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

newPermissionCollection в классе Permission

Возвращает:

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