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 項的一個副本。