JavaTM 2 Platform
Standard Ed. 5.0

java.security.acl
接口 AclEntry

所有超级接口:
Cloneable

public interface AclEntry
extends Cloneable

这是用于表示访问控制列表 (ACL) 中某个项的接口。

可将一个 ACL 视为具有多个 ACL 项对象的数据结构。每个 ACL 项对象都包含一组与特定主体相关联的权限。(主体表示一种实体,如个体用户或一个用户组)。另外,可以将每个 ACL 项指定为 positive 或 negative 的。如果为 positive,则将权限授予相关联的主体。如果为 negative,则拒绝该权限。每个主体最多有一个 positive ACL 项和一个 negative ACL 项;也就是对于任何主体,不允许有多个 positive 或 negative ACL 项。 注:默认情况下,ACL 项是 positive 的。仅在某个项上调用 setNegativePermissions 方法后,该项才会变成 negative 项。

另请参见:
Acl

方法摘要
 boolean addPermission(Permission permission)
          向此 ACL 项添加指定的权限。
 boolean checkPermission(Permission permission)
          检查指定的权限是否为此项中权限集合的一部分。
 Object clone()
          复制此 ACL 项。
 Principal getPrincipal()
          返回此 ACL 项将为其授予或拒绝权限的主体。
 boolean isNegative()
          如果此项是一个 negative ACL 项(关联的主体拒绝该项中的权限集合),则返回 true;否则返回 false。
 Enumeration<Permission> permissions()
          返回此 ACL 项中各个权限的枚举。
 boolean removePermission(Permission permission)
          从此 ACL 项中移除指定的权限。
 void setNegativePermissions()
          将此 ACL 项设置为 negative 项。
 boolean setPrincipal(Principal user)
          指定此 ACL 项要为其授予或拒绝权限的主体。
 String toString()
          返回此 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 项设置为 negative 项。也就是说,关联的主体(例如用户或组)将拒绝该项中指定的权限。 注:默认情况下,ACL 项是 positive 的。只有在某个项上调用此 setNegativePermissions 方法后,该项才会变成 negative 项。


isNegative

boolean isNegative()
如果此项是一个 negative ACL 项(关联的主体拒绝该项中的权限集合),则返回 true;否则返回 false。

返回:
此项是一个 negative ACL 项,则返回 true;如果不是,则返回 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 项内容的字符串表示形式。

覆盖:
Object 中的 toString
返回:
该内容的字符串表示形式。

clone

Object clone()
复制此 ACL 项。

返回:
此 ACL 项的一个副本。

JavaTM 2 Platform
Standard Ed. 5.0

提交错误或意见
有关更多的 API 参考资料和开发人员文档,请参阅 Java 2 SDK SE 开发人员文档。该文档包含更详细的、面向开发人员的描述,以及总体概述、术语定义、使用技巧和工作代码示例。

版权所有 2004 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。另请参阅文档重新分发政策