Класс PropertyPermission

java.util.PropertyPermission

Все реализованные интерфейсы:: Serializable, Guard

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" предоставляет потенциально злонамеренному коду конфиденциальную информацию о среде пользователя (имя учётной записи пользователя и домашний каталог).

С тех пор как:

1.2

См. также:

Краткое описание конструкторов

Конструктор	Описание
`PropertyPermission(String name, String actions)`	Создаёт новый объект PropertyPermission с указанным именем.

Краткое описание методов

Модификатор и тип	Метод	Описание
`boolean`	`equals(Object obj)`	Проверяет равенство двух объектов PropertyPermission.
`String`	`getActions()`	Возвращает «каноническое строковое представление» действий.
`int`	`hashCode()`	Возвращает значение хэш-кода для этого объекта.
`boolean`	`implies(Permission p)`	Проверяет, "подразумевает" ли этот объект PropertyPermission указанное разрешение.
`PermissionCollection`	`newPermissionCollection()`	Возвращает новый объект PermissionCollection для хранения объектов PropertyPermission.

Методы, объявленные в классе java.security.Permission

checkGuard, getName, toString

Методы, объявленные в классе java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Подробное описание конструкторов

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)

Проверяет, "подходит ли" данный объект PropertyPermission для указанного разрешения.

Более конкретно, этот метод возвращает true, если:

p является экземпляром PropertyPermission,
действия p являются подмножеством действий этого объекта, и
имя p подразумевается именем этого объекта. Например, "java.*" подразумевает "java.home".

Переопределяет:: implies в классе BasicPermission
Параметры:: p - разрешение для проверки.
Возвращает:: true, если указанное разрешение подразумевается этим объектом, false — если нет.

equals

public boolean equals(Object obj)

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

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

equals в классе BasicPermission

Параметры:

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

Возвращает:

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

См. также:

hashCode

public int hashCode()

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

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

hashCode в классе BasicPermission

Возвращает:

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

См. также:

getActions

public String getActions()

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

Переопределяет:: getActions в классе BasicPermission
Возвращает:: каноническое строковое представление действий.

newPermissionCollection

public PermissionCollection newPermissionCollection()

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

Переопределяет:: newPermissionCollection в классе BasicPermission
Возвращает:: новый объект PermissionCollection, подходящий для хранения PropertyPermission.

© 1993, 2021, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/17/docs/api/java.base/java/util/PropertyPermission.html