oracle.security.jazn.policy
Class AdminPermission

java.lang.Object
java.security.Permission
oracle.security.jazn.policy.AdminPermission

All Implemented Interfaces:

java.security.Guard, java.io.Serializable

public class AdminPermission

extends java.security.Permission

This class represents the right to administer a permission.

Given a Permission p, the grantee of AdminPermission(p) is granted the right to:

• grant/revoke permissions implied by p (say p')
• grant/revoke AdminPermission(p')

For examples:

p = java.io.FilePermission("/home/scott/-","read,write");

if grantee SCOTT is granted AdminPermission(p),
then SCOTT is granted the following rights:

• the right to further grant/revoke p' (i.e. read and write privileges for any file(s) in the file system under "/home/scott") to/from other grantees
• the right to further grant/revoke AdminPermission(p')

Notes:

• An AdminPermission embedding another AdminPermission is not supported. There is furthermore no need to do so since granting a grantee AdminPermission(p) implies that the grantee can further grant/revoke AdminPermission(p')
• Granting a grantee AdminPermission(p) does not imply granting the grantee p - that needs to be granted separately.

Version:

1.0

Author:

rkng

See Also:

Serialized Form

Constructor Summary

AdminPermission(java.security.Permission p)
Creates a new AdminPermission instance.

AdminPermission(java.lang.String name)
Create a new AdminPermission instance.

AdminPermission(java.lang.String name, java.lang.String actions)
Create a new AdminPermission instance.

Method Summary

boolean	equals(java.lang.Object o) Checks two AdminPermission objects for equality.
java.lang.String	getActions() Returns the canonical string representation of the actions, which currently is the empty string "", since there are no actions for an AdminPermission.
java.security.Permission	getEmbeddedPermission() Returns the permission whose administrative right is to be granted.
int	hashCode() Returns the hash code value for this object.
boolean	implies(java.security.Permission p) Checks if the specified permission is "implied" by this object.

Methods inherited from class java.security.Permission

checkGuard, getName, newPermissionCollection, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

AdminPermission

public AdminPermission(java.lang.String name)

Create a new AdminPermission instance.

Parameters:

name - the encoded permission string Note that the encoded permission cannot be an AdminPermission instance.

AdminPermission

public AdminPermission(java.lang.String name,
                       java.lang.String actions)

Create a new AdminPermission instance.

Parameters:

name - the encoded permission string Note that the encoded permission cannot be an AdminPermission instance.

actions - the actions associated with this permission instance. This parameter is currently ignored.

AdminPermission

public AdminPermission(java.security.Permission p)

Creates a new AdminPermission instance.

Method Detail

getActions

public java.lang.String getActions()

Returns the canonical string representation of the actions, which currently is the empty string "", since there are no actions for an AdminPermission.

Returns:

the empty string "".

hashCode

public int hashCode()

Returns the hash code value for this object. The hash code used is the hash code of the name, that is, getName().hashCode(), where getName is from the Permission superclass.

Returns:

a hash code value for this object.

equals

public boolean equals(java.lang.Object o)

Checks two AdminPermission objects for equality. Checks that obj's class is the same as this object's class and has the same embedded permission as this object.

Returns:

true if obj is an AdminPermission, and has the same embedded permission as this AdminPermission object, false otherwise.

getEmbeddedPermission

public java.security.Permission getEmbeddedPermission()

Returns the permission whose administrative right is to be granted.

Returns:

the permission whose administrative right is to be granted.

implies

public boolean implies(java.security.Permission p)

Checks if the specified permission is "implied" by this object.

More specifically, this method returns true if:

• p's class is the same as this object's class, and
• p's name equals or is implied by this object's name.

Parameters:

p - the permission to check against.

Returns:

true if the passed permission is equal to or implied by this permission, false otherwise.