Serializable
public final class Permissions extends PermissionCollection implements Serializable
Permission
objects, organized into PermissionCollection
objects. 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 PermissionCollection
objects. 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.
Constructor | Description |
---|---|
Permissions() |
Creates a new Permissions object containing no PermissionCollection objects. |
Modifier and Type | Method | Description |
---|---|---|
void |
add |
Adds a Permission object to the PermissionCollection for the class the permission belongs to. |
Enumeration |
elements() |
Returns an enumeration of all the Permission objects in all the PermissionCollection objects in this Permissions object. |
boolean |
implies |
Checks to see if this object's PermissionCollection for permissions of the specified permission's class implies the permissions expressed in the permission object. |
elementsAsStream, isReadOnly, setReadOnly, toString
public Permissions()
Permissions
object containing no PermissionCollection
objects.public void add(Permission permission)
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.add
in class PermissionCollection
permission
- the Permission
object to add.SecurityException
- if this Permissions
object is marked as readonly.public boolean implies(Permission permission)
PermissionCollection
for permissions of the specified permission's class 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
.
implies
in class PermissionCollection
permission
- the Permission
object to check.true
if "permission" is implied by the permissions in the PermissionCollection
it belongs to, false
if not.public Enumeration<Permission> elements()
Permission
objects in all the PermissionCollection
objects in this Permissions
object.elements
in class PermissionCollection
Permission
objects.
© 1993, 2023, Oracle and/or its affiliates. All rights reserved.
Documentation extracted from Debian's OpenJDK Development Kit package.
Licensed under the GNU General Public License, version 2, with the Classpath Exception.
Various third party code in OpenJDK is licensed under different licenses (see Debian package).
Java and OpenJDK are trademarks or registered trademarks of Oracle and/or its affiliates.
https://docs.oracle.com/en/java/javase/21/docs/api/java.base/java/security/Permissions.html