javax.security.jacc

Class EJBRoleRefPermission

public final class EJBRoleRefPermission extends Permission implements Serializable

Class for EJB isCallerInRole(String reference) permissions. An EJBRoleRefPermission is a named permission and has actions.

The name of an EJBRoleRefPermission contains the value of the ejb-name element in the application's deployment descriptor that identifies the EJB in whose context the permission is being evalutated.

The actions of an EJBRoleRefPermission identifies the role reference to which the permission applies. An EJBRoleRefPermission is checked to determine if the subject is a member of the role identified by the reference.

Constructor Summary
EJBRoleRefPermission(String name, String role)
Creates a new EJBRoleRefPermission with the specified name and actions.
Method Summary
booleanequals(Object o)
Checks two EJBRoleRefPermission objects for equality.
StringgetActions()
Returns a canonical String representation of the actions of this EJBRoleRefPermission.
inthashCode()
Returns the hash code value for this EJBRoleRefPermission.
booleanimplies(Permission permission)
Determines if the argument Permission is "implied by" this EJBRoleRefPermission.

Constructor Detail

EJBRoleRefPermission

public EJBRoleRefPermission(String name, String role)
Creates a new EJBRoleRefPermission with the specified name and actions.

Parameters: name the ejb-name that identifies the EJB in whose context the role references are to be evaluated. role identifies the role reference to which the permission pertains. The role reference is scoped to the EJB identified in the name parameter. The value of the role reference must not be null or the empty string.

Method Detail

equals

public boolean equals(Object o)
Checks two EJBRoleRefPermission objects for equality. EJBRoleRefPermission objects are equivalent if they have case equivalent name and actions values.

Two Permission objects, P1 and P2, are equivalent if and only if P1.implies(P2) && P2.implies(P1).

Parameters: o the EJBRoleRefPermission object being tested for equality with this EJBRoleRefPermission.

Returns: true if the argument EJBRoleRefPermission object is equivalent to this EJBRoleRefPermission.

getActions

public String getActions()
Returns a canonical String representation of the actions of this EJBRoleRefPermission.

Returns: a String containing the canonicalized actions of this EJBRoleRefPermission.

hashCode

public int hashCode()
Returns the hash code value for this EJBRoleRefPermission. The properties of the returned hash code must be as follows:

Returns: the integer hash code value for this object.

implies

public boolean implies(Permission permission)
Determines if the argument Permission is "implied by" this EJBRoleRefPermission. For this to be the case,