WebRoleRefPermission (JBoss J2EE API) - JBoss 4.0.1 sp1 j2ee API Documentation 英文版文档

Overview

Package

Class

Use

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

javax.security.jacc
Class WebRoleRefPermission

java.lang.Object
  java.security.Permission
      javax.security.jacc.WebRoleRefPermission

All Implemented Interfaces:: Guard, Serializable

public final class WebRoleRefPermission
extends Permission
implements Serializable

Class for Servlet isUserInRole (String reference) permissions. A WebRoleRefPermission is a named permission and has actions. The name of an WebRoleRefPermission (also referred to as the target name) identifies a Web resource by the servlet name (in the deployment descriptor corresponding to the component from which the call to isUserInRole (String reference) is being made. The actions of an WebRoleRefPermission identifies the role reference to which the permission applies. A WebRoleRefPermission is checked to determine if the subject is a member of the role identified by the reference. Implementations of this class MAY implement newPermissionCollection or inherit its implementation from the super class.

Version:: $Revision: 1.3.4.1 $
Author:: Scott.Stark@jboss.org, Ron Monzillo, Gary Ellison (javadoc)
See Also:: Serialized Form

Constructor Summary

WebRoleRefPermission(String name, String actions)
          Creates a new WebRoleRefPermission with the specified name and actions.

Method Summary

boolean equals(Object p)
          Checks two WebRoleRefPermission objects for equality.

String getActions()
          Returns the security-role-ref target role name.

int hashCode()
          Returns the hash code value for this WebRoleRefPermission.

boolean implies(Permission p)
          Determines if the argument Permission is "implied by" this WebRoleRefPermission.

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

WebRoleRefPermission

public WebRoleRefPermission(String name,
                            String actions)

Creates a new WebRoleRefPermission with the specified name and actions.
Parameters:: name - - the servlet-name that identifies the application specific web resource in whose context the role references are to be evaluated.; actions - - identifies the role reference to which the permission pertains. The role reference is scoped to the Web resource 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 p)

Checks two WebRoleRefPermission objects for equality. WebRoleRefPermission objects are equivalent if they have case equivalent name and actions values.

Parameters:: p - the permission to check for equality
Returns:: true if this is equivalent to p, false otherwise.

getActions

public String getActions()

Returns the security-role-ref target role name.

Returns:: the security-role-ref target role name.

hashCode

public int hashCode()

Returns the hash code value for this WebRoleRefPermission. The properties of the returned hash code must be as follows: - During the lifetime of a Java application, the hashCode method must return the same integer value, every time it is called on a WebRoleRefPermission object. The value returned by hashCode for a particular WebRoleRefPermission need not remain consistent from one execution of an application to another. - If two WebRoleRefPermission objects are equal according to the equals method, then calling the hashCode method on each of the two Permission objects must produce the same integer result (within an application).

Returns:: the permission hash code.

implies

public boolean implies(Permission p)

Determines if the argument Permission is "implied by" this WebRoleRefPermission. For this to be the case: - The argument must be an instanceof WebRoleRefPermission - with name equivalent to this WebRoleRefPermission, and - with role reference equivalent to this WebRoleRefPermission (as defined in their actions)

Parameters:: p -
Returns:: true if the specified permission is implied by this object, false otherwise.