Permissions JDK 1.6)

Description

publicfinal class Permissions

This class represents a heterogeneous collection of Permissions.

This class represents a heterogeneous collection of Permissions. That is, it contains different types of Permission objects, organized into PermissionCollections. For example, if any java.io.FilePermission objects are added to an instance of this class, they are all stored in a single PermissionCollection. It is the PermissionCollection returned by a call to the newPermissionCollection method in the FilePermission class. Similarly, any java.lang.RuntimePermission objects are stored in the PermissionCollection returned by a call to the newPermissionCollection method in the RuntimePermission class. Thus, this class represents a collection of PermissionCollections.

When the add method is called to add a Permission, the Permission is stored in the appropriate PermissionCollection. If no such collection exists yet, the Permission object's class is determined and the newPermissionCollection method is called on that class to create the PermissionCollection and add it to the Permissions object. If newPermissionCollection returns null, then a default PermissionCollection that uses a hashtable will be created and used. Each hashtable entry stores a Permission object as both the key and the value.

Enumerations returned via the elements method are not fail-fast. Modifications to a collection should not be performed while enumerating over that collection.

See also: Permission PermissionCollection AllPermission

Methods

Hide/Show inherited methods

public void add (Permission permission) [Specified in PermissionCollection]

Adds a permission object to the PermissionCollection for the class the permission belongs to.

public Enumeration<Permission> elements () [Specified in PermissionCollection]

Returns an enumeration of all the Permission objects in all the PermissionCollections in this Permissions object.

public boolean implies (Permission permission) [Specified in PermissionCollection]

Checks to see if this object's PermissionCollection for permissions of the specified permission's class implies the permissions expressed in the permission object.

public boolean isReadOnly () [Inherited From PermissionCollection]

Returns true if this PermissionCollection object is marked as readonly.

Returns true if this PermissionCollection object is marked as readonly. If it is readonly, no new Permission objects can be added to it using add.

By default, the object is not readonly. It can be set to readonly by a call to setReadOnly.
Returns: true if this PermissionCollection object is marked as readonly, false otherwise.

public void setReadOnly () [Inherited From PermissionCollection]

Marks this PermissionCollection object as "readonly".

Marks this PermissionCollection object as "readonly". After
a PermissionCollection object
is marked as readonly, no new Permission objects can be added to it
using add.

public String toString () [Inherited From PermissionCollection]

Returns a string describing this PermissionCollection object, providing information about all the permissions it contains.

Returns a string describing this PermissionCollection object,
providing information about all the permissions it contains.
The format is:


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

super.toString is a call to the toString
method of this
object's superclass, which is Object. The result is
this PermissionCollection's type name followed by this object's
hashcode, thus enabling clients to differentiate different
PermissionCollections object, even if they contain the same permissions.
Returns: information about this PermissionCollection object, as described above.