Класс PropertyPermission

public final class PropertyPermission
extends BasicPermission

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

Имя — это имя свойства ("java.home", "os.name" и т. д.). Имена следуют соглашениям именования иерархических свойств. Также в конце имени после точки или самостоятельно может стоять звёздочка, обозначающая подстановочный символ. Например: "java.*" и "*" обозначают подстановочный символ, а "*java" и "a*b" — нет.

Действия, которые должны быть предоставлены, передаются в конструктор в строке, содержащей один или несколько ключевых слов, разделённых запятыми. Возможными ключевыми словами являются "read" и "write". Их значения определены следующим образом:

read

Разрешение на чтение. Разрешает вызов System.getProperty.

write

Разрешение на запись. Разрешает вызов System.setProperty.

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

Следует проявлять осторожность при предоставлении коду разрешения на доступ к определённым системным свойствам. Например, предоставление разрешения на доступ к системному свойству "java.home" предоставляет потенциально злонамеренному коду конфиденциальную информацию об окружении системы (директория установки Java). Кроме того, предоставление разрешения на доступ к системным свойствам "user.name" и "user.home" предоставляет потенциально злонамеренному коду конфиденциальную информацию об окружении пользователя (имя учётной записи пользователя и домашний каталог).

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

PropertyPermission

public PropertyPermission(String name,
                          String actions)

Создаёт новый объект PropertyPermission с указанным именем. Имя — это имя системного свойства, а actions содержит список разделённых запятыми желаемых действий, предоставляемых над свойством. Возможные действия — "read" и "write".

Параметры:

name — имя PropertyPermission.

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

Исключения:

NullPointerException — если name равно null.

IllegalArgumentException — если name пустая или actions недопустимая.

Методы

implies

public boolean implies(Permission p)

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

implies в классе BasicPermission

Параметры:

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

Возвращает:

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

equals

public boolean equals(Object obj)

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

equals в классе BasicPermission

Параметры:

obj — объект, с которым мы тестируем равенство этому объекту.

Возвращает:

true, если obj является объектом PropertyPermission и имеет такое же имя и такие же действия, как и этот объект PropertyPermission.

См. также:

Object.hashCode(), HashMap

hashCode

public int hashCode()

Возвращает значение хэш-кода для этого объекта. Использованный хэш-код — хэш-код имени этого разрешения, то есть getName().hashCode(), где getName из суперкласса Permission.

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

hashCode в классе BasicPermission

Возвращает:

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

См. также:

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

getActions

public String getActions()

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

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

getActions в классе BasicPermission

Возвращает:

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

newPermissionCollection

public PermissionCollection newPermissionCollection()

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

newPermissionCollection в классе BasicPermission

Возвращает:

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