com.sun.identity.policy.jaas

Class ISPermissionCollection

java.lang.Object

java.security.PermissionCollection

com.sun.identity.policy.jaas.ISPermissionCollection

All Implemented Interfaces:

Serializable

public class ISPermissionCollection
extends PermissionCollection

This class represents a collection of ISPermission objects. It extends from PermissionCollection providing implementation of abstract methods like add, implies elements. The rest of the required methods are used from the parent class.

With any PermissionCollection, you can:

• add a permission to the collection using the add method.
• check to see if a particular permission is implied in the collection, using the implies method.
• enumerate all the permissions, using the elements method.

When it is desirable to group together a number of Permission objects of the same type, the newPermissionCollection method on that particular type of Permission object should first be called. The default behavior of the ISPermission class is to simply return a new instance of ISPermissionCollection(). The caller of newPermissionCollection would need to store permissions of the ISPermission in ISPermissionCollection returned.

The ISPermissionCollection returned by the Permission.newPermissionCollection method is a homogeneous collection, which stores only ISPermission objects.

See Also:

Permission, PermissionCollection,

, Serialized Form

Constructor Summary

Constructors

Constructor and Description
ISPermissionCollection()

Method Summary

Modifier and Type	Method and Description
void	add(Permission perm) Adds a permission object to the current collection of ISPermission objects.
Enumeration	elements() This method returns an Enumeration of permissions in this collection, which is ISPermission in our case.
boolean	implies(Permission perm) Checks to see if the specified permission is implied by the collection of ISPermission objects held in this ISPermissionCollection.

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

Constructor Detail

ISPermissionCollection

public ISPermissionCollection()

Method Detail

add

public void add(Permission perm)

Adds a permission object to the current collection of ISPermission objects.

Specified by:

add in class PermissionCollection

Parameters:

perm - the ISPermission object to add.

Throws:

SecurityException - if this PermissionCollection object has been marked readonly exception IllegalArgumentException if the passed permission is not of ISPermission instance.

elements

public Enumeration elements()

This method returns an Enumeration of permissions in this collection, which is ISPermission in our case. This method gets called internally by java security code, to get all the permissions stored in this permission collection.

Specified by:

elements in class PermissionCollection

Returns:

Enumeration of all the ISPermissions held in this collection.

implies

public boolean implies(Permission perm)

Checks to see if the specified permission is implied by the collection of ISPermission objects held in this ISPermissionCollection. This method takes in a permission and loops through all the permissions in its store and call their implies> to evaluate the result.

Specified by:

implies in class PermissionCollection

Parameters:

perm - the Permission object to compare.

Returns:

true if "permission" is implied by the permissions in the collection, false if not.