Класс 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.