Интерфейс AclEntry

public interface AclEntry
extends Cloneable

Этот интерфейс используется для представления одной записи в списке управления доступом (ACL).

ACL можно рассматривать как структуру данных с несколькими объектами записи ACL. Каждый объект записи ACL содержит набор разрешений, связанных с определённым принципалом. (Принципал представляет собой сущность, такую как отдельный пользователь или группа). Кроме того, каждая запись ACL указывается как положительная или отрицательная. Если положительная, разрешения предоставляются связанному принципалу. Если отрицательная, разрешения должны быть запрещены. Каждый принципал может иметь не более одной положительной записи ACL и одной отрицательной; то есть, несколько положительных или отрицательных записей ACL не допускаются для любого принципала. Примечание: записи ACL по умолчанию положительные. Запись становится отрицательной только если метод setNegativePermissions вызывается на ней.

Методы

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.

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

toString в классе Object

Возвращает:

строковое представление содержимого.

clone

Object clone()

Создаёт копию этой записи ACL.

Возвращает:

копию этой записи ACL.