public final class Permissions extends PermissionCollection implements Serializable
java.io.FilePermissionobjects 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
newPermissionCollectionmethod in the FilePermission class. Similarly, any
java.lang.RuntimePermissionobjects are stored in the PermissionCollection returned by a call to the
newPermissionCollectionmethod in the RuntimePermission class. Thus, this class represents a collection of PermissionCollections.
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.
|Constructor and Description|
Creates a new Permissions object containing no PermissionCollections.
|Modifier and Type||Method and Description|
Adds a permission object to the PermissionCollection for the class the permission belongs to.
Returns an enumeration of all the Permission objects in all the PermissionCollections in this Permissions object.
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 void add(Permission permission)
public boolean implies(Permission 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
is called with a permission specifying both "read" and "write" access
to files in the "/tmp/scratch/foo" directory,
Additionally, if this PermissionCollection contains the AllPermission, this method will always return true.
For further API reference and developer documentation, see Java SE Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.
Copyright © 1993, 2013, Oracle and/or its affiliates. All rights reserved.