WebRoleRefPermission (Java EE 5 SDK)

Java

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


javax.security.jacc Class WebRoleRefPermission

java.lang.Object
  extended by java.security.Permission
      extended by javax.security.jacc.WebRoleRefPermission
所有已实现的接口:
Serializable, Guard

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.

作者:
Ron Monzillo, Gary Ellison
另请参见:
Permission, Serialized Form

构造器摘要
WebRoleRefPermission(String name, String actions)
          Creates a new WebRoleRefPermission with the specified name and actions.
 
方法摘要
 boolean equals(Object o)
          Checks two WebRoleRefPermission objects for equality.
 String getActions()
          Returns a canonical String representation of the actions of this WebRoleRefPermission.
 int hashCode()
          Returns the hash code value for this WebRoleRefPermission.
 boolean implies(Permission permission)
          Determines if the argument Permission is "implied by" this WebRoleRefPermission.
 
类方法继承 java.security.Permission
checkGuard, getName, newPermissionCollection, toString
 
类方法继承 java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
 

构造器详细信息

WebRoleRefPermission

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

参数:
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.

方法详细信息

equals

public boolean equals(Object o)
Checks two WebRoleRefPermission objects for equality. WebRoleRefPermission 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).

The name and actions comparisons described above are case sensitive.

规范说明:
equals in class Permission
参数:
o - the WebRoleRefPermission object being tested for equality with this WebRoleRefPermission.
返回:
true if the argument WebRoleRefPermission object is equivalent to this WebRoleRefPermission.

getActions

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

规范说明:
getActions in class Permission
返回:
a String containing the canonicalized actions of this WebRoleRefPermission.

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).

规范说明:
hashCode in class Permission
返回:
the integer hash code value for this object.

implies

public boolean implies(Permission permission)
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).

The comparisons described above are case sensitive.

规范说明:
implies in class Permission
参数:
permission - "this" WebRoleRefPermission is checked to see if it implies the argument permission.

返回:
true if the specified permission is implied by this object, false if not.

Java EE 5 SDK

深圳电信培训中心.徐海蛟老师.


提交错误或意见

版权所有 2007 Sun Microsystems, Inc. 保留所有权利。 请遵守许可证条款。深圳电信培训中心.徐海蛟老师教学参考.