Интерфейс AclEntry
- Все суперинтерфейсы:
Cloneable
@Deprecated(since="9",
forRemoval=true)
public interface AclEntry
extends Cloneablejava.security.Policy и соответствующие классы начиная с версии 1.2.Этот интерфейс используется для представления одной записи в списке управления доступом (ACL).
ACL можно рассматривать как структуру данных с несколькими объектами записи ACL. Каждый объект записи ACL содержит набор разрешений, связанных с определённым субъектом. (Субъект представляет собой сущность, такую как отдельный пользователь или группа). Кроме того, каждая запись ACL указывается как положительная или отрицательная. Если положительная, разрешения предоставляются связанному субъекту. Если отрицательная, разрешения отказываются. Каждый субъект может иметь не более одной положительной записи ACL и одной отрицательной записи; то есть, несколько положительных или отрицательных записей ACL не допускаются для любого субъекта. Примечание: записи ACL по умолчанию положительные. Запись становится отрицательной только в том случае, если для неё вызывается метод setNegativePermissions.
- С версии:
- 1.1
- См. также:
Acl
Методы
| Модификатор и тип | Метод | Описание |
|---|---|---|
boolean | addPermission(Permission permission) | Устаревшее, подлежащее удалению: Этот элемент API может быть удален в будущей версии. Добавляет указанное разрешение в эту запись ACL. |
boolean | checkPermission(Permission permission) | Устаревшее, подлежащее удалению: Этот элемент API может быть удален в будущей версии. Проверяет, является ли указанное разрешение частью набора разрешений в этой записи. |
Object | clone() | Устаревшее, подлежащее удалению: Этот элемент API может быть удален в будущей версии. Создаёт клон этой записи ACL. |
Principal | getPrincipal() | Устаревшее, подлежащее удалению: Этот элемент API может быть удален в будущей версии. Возвращает субъекта, для которого разрешения предоставляются или отказываются этой записью ACL. |
boolean | isNegative() | Устаревшее, подлежащее удалению: Этот элемент API может быть удален в будущей версии. Возвращает true, если это отрицательная запись ACL (отказывающая связанному субъекту набора разрешений в записи), иначе false. |
Enumeration<Permission> | permissions() | Устаревшее, подлежащее удалению: Этот элемент API может быть удален в будущей версии. Возвращает перечисление разрешений в этой записи ACL. |
boolean | removePermission(Permission permission) | Устаревшее, подлежащее удалению: Этот элемент API может быть удален в будущей версии. Удаляет указанное разрешение из этой записи ACL. |
void | setNegativePermissions() | Устаревшее, подлежащее удалению: Этот элемент API может быть удален в будущей версии. Устанавливает эту запись ACL как отрицательную. |
boolean | setPrincipal(Principal user) | Устаревшее, подлежащее удалению: Этот элемент API может быть удален в будущей версии. Указывает субъекта, для которого разрешения предоставляются или отказываются этой записью ACL. |
String | toString() | Устаревшее, подлежащее удалению: Этот элемент API может быть удален в будущей версии. Возвращает строковое представление содержимого этой записи ACL. |
Методы
setPrincipal
boolean setPrincipal(Principal user)
Указывает субъекта, для которого разрешения предоставляются или отказываются этой записью ACL. Если субъект уже был установлен для этой записи ACL, возвращается false, иначе true.
- Параметры:
-
user- субъект, который нужно установить для этой записи. - Возвращает:
- true, если субъект установлен, false, если для этой записи уже был установлен субъект.
- См. также:
getPrincipal()
getPrincipal
Principal getPrincipal()
Возвращает субъекта, для которого разрешения предоставляются или отказываются этой записью ACL. Возвращает null, если для этой записи ещё не установлен субъект.
- Возвращает:
- субъект, связанный с этой записью.
- См. также:
setPrincipal(java.security.Principal)
setNegativePermissions
void setNegativePermissions()
Устанавливает эту запись ACL как отрицательную. То есть, связанному субъекту (например, пользователю или группе) будет отказано в наборе разрешений, указанных в записи. Примечание: записи ACL по умолчанию положительные. Запись становится отрицательной только в том случае, если для неё вызывается этот setNegativePermissions метод.
isNegative
boolean isNegative()
Возвращает true, если это отрицательная запись ACL (отказывающая связанному субъекту набора разрешений в записи), иначе false.
- Возвращает:
- true, если это отрицательная запись ACL, false в противном случае.
addPermission
boolean addPermission(Permission permission)
Добавляет указанное разрешение в эту запись ACL. Примечание: запись может иметь несколько разрешений.
- Параметры:
-
permission- разрешение, которое нужно связать с субъектом в этой записи. - Возвращает:
- true, если разрешение было добавлено, false, если разрешение уже было частью набора разрешений этой записи.
removePermission
boolean removePermission(Permission permission)
Удаляет указанное разрешение из этой записи ACL.
- Параметры:
-
permission- разрешение, которое нужно удалить из этой записи. - Возвращает:
- true, если разрешение удалено, false, если разрешение не было частью набора разрешений этой записи.
checkPermission
boolean checkPermission(Permission permission)
Проверяет, является ли указанное разрешение частью набора разрешений в этой записи.
- Параметры:
-
permission- разрешение, которое нужно проверить. - Возвращает:
- true, если разрешение является частью набора разрешений в этой записи, иначе false.
permissions
Enumeration<Permission> permissions()
Возвращает перечисление разрешений в этой записи ACL.
- Возвращает:
- перечисление разрешений в этой записи ACL.
toString
String toString()
Возвращает строковое представление содержимого этой записи ACL.
clone
Object clone()
Создаёт клон этой записи ACL.
- Возвращает:
- клон этой записи ACL.
© 1993, 2020, 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/11/docs/api/java.base/java/security/acl/AclEntry.html