接口 java.security.acl.AclEntry
- public interface AclEntry
- extends Cloneable
这是一个用来表示 Access Control List (ACL) 中的项的接口。
一个 ACL 可以想象成一个具有多个 ACL 入口对象的数据结构。 每个 ACL
入口对象包含一个与特定的主体有关的许可权限集合。 (一个主体表示一个实体，例如个体用户或者一个组)。 此外，每个 ACL 项被指定为或为正或为负的数。 若为正，许可则授与了相关的主体。 若为负，则许可被否决。 每个主体最多具有一个正片 ACL 项和一个负片项；
也就是说，任何主体具有多个正数或负数 ACL 项都是不允许的。注意：ACL 项缺省为正。 一个项成为负项只有调用了 setNegativePermissions
方法才能实现。
- 参见：
- Acl
方法索引
- addPermission(Permission)
- 添加指定许可权限到该 ACL 项。
- checkPermission(Permission)
- 检查指定许可权限是否是该项许可权限集合的一部分。
- clone()
- 复制该 ACL 项。
- getPrincipal()
- 返回被授予或被否决该 ACL 项的主体。
- isNegative()
- 如果它是一个负 ACL 项(一个其中的许可权限集合被否决授予相关的主体的项)则返回 true ,否则返回 false 。
- permissions()
- 返回该 ACL 项中许可权限的枚举。
- removePermission(Permission)
- 从该 ACL 项中删掉指定的许可权限。
- setNegativePermissions()
- 设置该 ACL 项为一负值。
- setPrincipal(Principal)
- 指定该 ACL 项要被授与或要被否决的主体。
- toString()
- 返回该 ACL 项的内容的字符串表示。
方法
setPrincipal
public abstract boolean setPrincipal(Principal user)
- 指定该 ACL 项要被授与或要被否决的主体。如果该 ACL 项的主体已经设置，则返回 false，否则返回 true。
- 参数：
- user - 该项要设置的主体。
- 返回：
- 主体设置成功则为 true ，如果已经为该项设置了该主体则为 false。
getPrincipal
public abstract Principal getPrincipal()
- 返回该 ACL 项要被授与或要被否决的主体。 如果尚未为该项设置主体则返回 null。
- 返回：
- 与该项相联系的主体。
setNegativePermissions
public abstract void setNegativePermissions()
- 设置该 ACL 项为一负值。 也就是说，相关的主体(例如，用户或小组)
被否决了该项中指定的许可权限。注意：ACL 项缺省为正。一个项只有调用
setNegativePermissions 方法才能成为负值。
isNegative
public abstract boolean isNegative()
- 如果它是一个负 ACL 项(一个其中的许可权限集合被否决授予相关的主体的项)则返回 true ,否则返回 false 。
- 返回：
- 如果它为一负 ACL 项则为 true ,否则为 false。
addPermission
public abstract boolean addPermission(Permission permission)
- 添加指定许可权限到该 ACL 项。 注意：一个项可以具有多个许可权限。
- 参数：
- permission - 该项中与该主体有关的许可权限。
- 返回：
- 如果许可权限成功添加则为 true，如果许可权限已经是该项中许可权限集合的一部分则为 false。
removePermission
public abstract boolean removePermission(Permission permission)
- 从该 ACL 项中删掉指定的许可权限。
- 参数：
- permission - 要从该项中删除的许可权限。
- 返回：
- 如果许可权限成功删除则为 true，如果许可权限不是该项中许可权限集合的一部分则为 false。
checkPermission
public abstract boolean checkPermission(Permission permission)
- 检查指定许可权限是否是该项中许可权限集合的一部分。
- 参数：
-
permission - 待检查的许可权限。
- 返回：
- 如果许可权限是该项许可权限集合的一部分则为 true ,否则为
false 。
permissions
public abstract Enumeration permissions()
- 返回该 ACL 项许可权限的枚举。
- 返回：
- 该 ACL 项许可权限的枚举。
toString
public abstract String toString()
- 返回该 ACL 项内容的字符串表示。
- 返回：
- 内容的字符串表示。
- 覆盖：
- 类 Object 中的 toString
clone
public abstract Object clone()
- 复制该 ACL 项。
- 返回：
- 该 ACL 项的一个复制项。
- 覆盖：
- 类 Object 中的 clone