java.security
Class Permissions

java.lang.Object
  |
  +--java.security.PermissionCollection
        |
        +--java.security.Permissions
All Implemented Interfaces:
Serializable

public final class Permissions
extends PermissionCollection
implements Serializable

Untamed: 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.

Version:
1.50, 02/02/01
Author:
Marianne Mueller, Roland Schemers
See Also:
Permission, PermissionCollection, AllPermission

Field Summary
private  PermissionCollection allPermission
           
private  Hashtable perms
           
 
Fields inherited from class java.security.PermissionCollection
 
Constructor Summary
Permissions()
          Enabled: Creates a new Permissions object containing no PermissionCollections.
 
Method Summary
 void add(Permission permission)
          Enabled: Adds a permission object to the PermissionCollection for the class the permission belongs to.
 Enumeration elements()
          Enabled: Returns an enumeration of all the Permission objects in all the PermissionCollections in this Permissions object.
private  Enumeration elements(Permission p)
          Returns an enumeration of all the Permission objects with the same type as p.
private  PermissionCollection getPermissionCollection(Permission p)
          Gets the PermissionCollection in this Permissions object for permissions whose type is the same as that of p.
private  PermissionCollection getUnresolvedPermissions(Permission p)
          Resolves any unresolved permissions of type p.
 boolean implies(Permission permission)
          Enabled: Checks to see if this object's PermissionCollection for permissions of the specified permission's type implies the permissions expressed in the permission object.
 
Methods inherited from class java.security.PermissionCollection
isReadOnly, setReadOnly, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Field Detail

perms

private Hashtable perms

allPermission

private PermissionCollection allPermission
Constructor Detail

Permissions

public Permissions()
Enabled: Creates a new Permissions object containing no PermissionCollections.

Method Detail

add

public void add(Permission permission)
Enabled: Adds a permission object to the PermissionCollection for the class the permission belongs to. For example, if permission is a FilePermission, it is added to the FilePermissionCollection stored in this Permissions object. This method creates a new PermissionCollection object (and adds the permission to it) if an appropriate collection does not yet exist.

Specified by:
add in class PermissionCollection
Parameters:
permission - the Permission object to add.
See Also:
PermissionCollection.isReadOnly()

implies

public boolean implies(Permission permission)
Enabled: Checks to see if this object's PermissionCollection for permissions of the specified permission's type implies the permissions expressed in the permission object. Returns true if the combination of permissions in the appropriate PermissionCollection (e.g., a FilePermissionCollection for a FilePermission) together imply the specified permission.

For example, suppose there is a FilePermissionCollection in this Permissions object, and it contains one FilePermission that specifies "read" access for all files in all subdirectories of the "/tmp" directory, and another FilePermission that specifies "write" access for all files in the "/tmp/scratch/foo" directory. Then if the implies method is called with a permission specifying both "read" and "write" access to files in the "/tmp/scratch/foo" directory, true is returned.

Additionally, if this PermissionCollection contains the AllPermission, this method will always return true.

Specified by:
implies in class PermissionCollection
Parameters:
permission - the Permission object to check.
Returns:
true if "permission" is implied by the permissions in the PermissionCollection it belongs to, false if not.

elements

public Enumeration elements()
Enabled: Returns an enumeration of all the Permission objects in all the PermissionCollections in this Permissions object.

Specified by:
elements in class PermissionCollection
Returns:
an enumeration of all the Permissions.

elements

private Enumeration elements(Permission p)
Returns an enumeration of all the Permission objects with the same type as p.

Parameters:
p - the prototype Permission object.
Returns:
an enumeration of all the Permissions with the same type as p.

getPermissionCollection

private PermissionCollection getPermissionCollection(Permission p)
Gets the PermissionCollection in this Permissions object for permissions whose type is the same as that of p. For example, if p is a FilePermission, the FilePermissionCollection stored in this Permissions object will be returned. This method creates a new PermissionCollection object for the specified type of permission objects if one does not yet exist. To do so, it first calls the newPermissionCollection method on p. Subclasses of class Permission override that method if they need to store their permissions in a particular PermissionCollection object in order to provide the correct semantics when the PermissionCollection.implies method is called. If the call returns a PermissionCollection, that collection is stored in this Permissions object. If the call returns null, then this method instantiates and stores a default PermissionCollection that uses a hashtable to store its permission objects.


getUnresolvedPermissions

private PermissionCollection getUnresolvedPermissions(Permission p)
Resolves any unresolved permissions of type p.

Parameters:
p - the type of unresolved permission to resolve
Returns:
PermissionCollection containing the unresolved permissions, or null if there were no unresolved permissions of type p.


comments?