Permissions (Java SE 9 & JDK 9 ) (original) (raw)
- java.security.PermissionCollection
- java.security.Permissions
All Implemented Interfaces:
[Serializable](../../java/io/Serializable.html "interface in java.io")
public final class Permissions
extends PermissionCollection
implements Serializable
This class represents a heterogeneous collection of Permissions. That is, it contains different types of Permission objects, organized into PermissionCollections. For example, if anyjava.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 thenewPermissionCollection 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 thenewPermissionCollection method is called on that class to create the PermissionCollection and add it to the Permissions object. IfnewPermissionCollection 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.
Since:
1.2
See Also:
Permission, PermissionCollection, AllPermission
Constructor Summary
Constructors
Constructor Description Permissions() Creates a new Permissions object containing no PermissionCollections. Method Summary
All Methods Instance Methods Concrete Methods
Modifier and Type Method Description void add(Permission permission) Adds a permission object to the PermissionCollection for the class the permission belongs to. Enumeration<Permission> elements() Returns an enumeration of all the Permission objects in all the PermissionCollections in this Permissions object. boolean implies(Permission permission) Checks to see if this object's PermissionCollection for permissions of the specified permission's class implies the permissions expressed in the permission object. * ### Methods inherited from class java.lang.[Object](../../java/lang/Object.html "class in java.lang") `[clone](../../java/lang/Object.html#clone--), [equals](../../java/lang/Object.html#equals-java.lang.Object-), [finalize](../../java/lang/Object.html#finalize--), [getClass](../../java/lang/Object.html#getClass--), [hashCode](../../java/lang/Object.html#hashCode--), [notify](../../java/lang/Object.html#notify--), [notifyAll](../../java/lang/Object.html#notifyAll--), [wait](../../java/lang/Object.html#wait--), [wait](../../java/lang/Object.html#wait-long-), [wait](../../java/lang/Object.html#wait-long-int-)` * ### Methods inherited from class java.security.[PermissionCollection](../../java/security/PermissionCollection.html "class in java.security") `[elementsAsStream](../../java/security/PermissionCollection.html#elementsAsStream--), [isReadOnly](../../java/security/PermissionCollection.html#isReadOnly--), [setReadOnly](../../java/security/PermissionCollection.html#setReadOnly--), [toString](../../java/security/PermissionCollection.html#toString--)`Constructor Detail
* #### Permissions public Permissions() Creates a new Permissions object containing no PermissionCollections.Method Detail
* #### add public void add([Permission](../../java/security/Permission.html "class in java.security") permission) 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](../../java/security/PermissionCollection.html#add-java.security.Permission-)` in class `[PermissionCollection](../../java/security/PermissionCollection.html "class in java.security")` Parameters: `permission` \- the Permission object to add. Throws: `[SecurityException](../../java/lang/SecurityException.html "class in java.lang")` \- if this Permissions object is marked as readonly. See Also: [PermissionCollection.isReadOnly()](../../java/security/PermissionCollection.html#isReadOnly--) * #### implies public boolean implies([Permission](../../java/security/Permission.html "class in java.security") permission) Checks to see if this object's 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. Specified by: `[implies](../../java/security/PermissionCollection.html#implies-java.security.Permission-)` in class `[PermissionCollection](../../java/security/PermissionCollection.html "class in java.security")` 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](../../java/util/Enumeration.html "interface in java.util")<[Permission](../../java/security/Permission.html "class in java.security")> elements() Returns an enumeration of all the Permission objects in all the PermissionCollections in this Permissions object. Specified by: `[elements](../../java/security/PermissionCollection.html#elements--)` in class `[PermissionCollection](../../java/security/PermissionCollection.html "class in java.security")` Returns: an enumeration of all the Permissions. See Also: [PermissionCollection.elementsAsStream()](../../java/security/PermissionCollection.html#elementsAsStream--)
Report a bug or suggest an enhancement
For further API reference and developer documentation see the Java SE Documentation, which contains more detailed, developer-targeted descriptions with conceptual overviews, definitions of terms, workarounds, and working code examples.
Java is a trademark or registered trademark of Oracle and/or its affiliates in the US and other countries.
Copyright © 1993, 2017, Oracle and/or its affiliates, 500 Oracle Parkway, Redwood Shores, CA 94065 USA.
All rights reserved. Use is subject to license terms and the documentation redistribution policy.