compact1, compact2, compact3

java.security

Class PermissionCollection

java.lang.Object

java.security.PermissionCollection

All Implemented Interfaces:

Serializable

已知直接子类：

Permissions

public abstract class PermissionCollection
extends Object
implements Serializable

代表Permission对象集合的抽象类。

使用PermissionCollection，您可以：

• 使用add方法添加收集的add 。
• 使用implies方法检查收集中是否暗示了特定implies 。
• 枚举所有权限，使用elements方法。

当希望将许多相同类型的Permission对象组合在一起时，应首先调用该特定类型的Permission对象上的newPermissionCollection方法。 默认行为（从Permission类）只是返回null。 如果需要将权限存储在特定的PermissionCollection对象中，以便在调用PermissionCollection.implies方法时提供正确的语义，类Permission的子类将重写该方法。 如果返回非空值，则必须使用PermissionCollection。 如果返回null，那么newPermissionCollection的调用者可以自由地在他们选择的任何PermissionCollection中存储给定类型的权限（一个使用Hashtable，一个使用Vector等）。

Permission.newPermissionCollection方法返回的Permission.newPermissionCollection是一个同构的集合，它仅存储给定权限类型的权限对象。 PermissionCollection也可能是异构的。 例如，Permissions是PermissionCollection子类，它表示PermissionCollections的集合。 也就是说，它的成员都是均匀的PermissionCollection。 例如，Permissions对象可能具有所有FilePermission对象的FilePermissionCollection，所有SocketPermission对象的SocketPermissionCollection等等。 它的add方法添加了适当的集合的权限。

只要将一个权限添加到不同种类的PermissionCollection（如Permissions），并且PermissionCollection尚未包含指定权限的类型的PermissionCollection中，PermissionCollection都应该调用newPermissionCollection上允许的类方法，看它是否需要特殊的PermissionCollection。 如果newPermissionCollection返回null，PermissionCollection可以将权限存储在任何所需的PermissionCollection类型中（一个使用Hashtable，一个使用Vector等）。 例如，Permissions对象使用在Hashtable中存储权限对象的默认PermissionCollection实现。

PermissionCollection的子类实现应该假定它们可以从多个线程同时调用，因此应该被正确同步。 此外，通过elements方法返回的elements不是故障快速的 。 在枚举集合时不应执行对集合的修改。

另请参见：

Permission ， Permissions ， Serialized Form

构造方法摘要

构造方法

Constructor and Description
PermissionCollection()

方法摘要

Modifier and Type	Method and Description
abstract void	add(Permission permission) 将权限对象添加到当前权限对象集合。
abstract Enumeration<Permission>	elements() 返回集合中所有Permission对象的枚举。
abstract boolean	implies(Permission permission) 检查此PermissionCollection中持有的Permission对象的集合是否暗示了指定的权限。
boolean	isReadOnly() 如果此PermissionCollection对象被标记为只读方式，则返回true。
void	setReadOnly() 将此PermissionCollection对象标记为“只读”。
String	toString() 返回描述此PermissionCollection对象的字符串，提供有关其所包含的所有权限的信息。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

构造方法详细信息

PermissionCollection

public PermissionCollection()

方法详细信息

add

public abstract void add(Permission permission)

将权限对象添加到当前权限对象集合。

参数

permission - 要添加的权限对象。

异常

SecurityException - - 如果此PermissionCollection对象已被标记为只读

IllegalArgumentException - - 如果此PermissionCollection对象是均匀集合，并且该权限不是正确的类型。

implies

public abstract boolean implies(Permission permission)

检查此PermissionCollection中持有的Permission对象的集合是否暗示了指定的权限。

参数

permission - 要比较的权限对象。

结果

如果集合中的权限暗示“权限”，则为true，否则为false。

elements

public abstract Enumeration<Permission> elements()

返回集合中所有Permission对象的枚举。

结果

列举所有权限。

setReadOnly

public void setReadOnly()

将此PermissionCollection对象标记为“只读”。 在PermissionCollection对象被标记为只读方式之后，不能使用add添加新的Permission对象。

isReadOnly

public boolean isReadOnly()

如果此PermissionCollection对象被标记为只读方式，则返回true。 如果是只读方式，则不能使用add添加新的权限对象。

默认情况下，该对象不是只读的。 它可以通过调用setReadOnly设置为只读。

结果

如果此PermissionCollection对象被标记为只读，则为true，否则为false。

toString

public String toString()

返回描述此PermissionCollection对象的字符串，提供有关其所包含的所有权限的信息。 格式为：

  super.toString() (
   // enumerate all the Permission
   // objects and call toString() on them,
   // one per line..
 ) 

super.toString是对一个呼叫toString此对象的超类的方法，该方法是对象。 结果是这个PermissionCollection的类型名称后跟这个对象的哈希码，从而使客户端区分不同的PermissionCollections对象，即使它们包含相同的权限。

重写：

toString在 Object

结果

information about this PermissionCollection object, as described above.