File	Doc	Category	Size	Date	Package
WebRoleRefPermission.java	API Doc	Glassfish v2 API	8542	Fri May 04 22:36:00 BST 2007	javax.security.jacc

WebRoleRefPermission

• java.lang.Object
  • java.security.Permission

Fields Summary
private final String	actions
private transient int	hashCodeValue
private static final long	serialVersionUID
private static final ObjectStreamField[]	serialPersistentFields The serialized fields of this permission are defined below. Whether or not the serialized fields correspond to actual (private) fields is an implementation decision.

Constructors Summary

public WebRoleRefPermission(String name, String actions) Creates a new WebRoleRefPermission with the specified name and actions. param name the servlet-name that identifies the application specific web resource in whose context the role references are to be evaluated. param 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. super(name); this.actions = actions;

Methods Summary
public boolean	equals(java.lang.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. param o the WebRoleRefPermission object being tested for equality with this WebRoleRefPermission. return true if the argument WebRoleRefPermission object is equivalent to this WebRoleRefPermission. if (o == null || ! (o instanceof WebRoleRefPermission)) return false; WebRoleRefPermission that = (WebRoleRefPermission) o; if (!this.getName().equals(that.getName())) return false; return this.actions.equals(that.actions);
public java.lang.String	getActions() Returns a canonical String representation of the actions of this WebRoleRefPermission. return a String containing the canonicalized actions of this WebRoleRefPermission. return this.actions;
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). return the integer hash code value for this object. if (this.hashCodeValue == 0) { String hashInput = new String(this.getName() + " " + this.actions); this.hashCodeValue = hashInput.hashCode(); } return this.hashCodeValue;
public boolean	implies(java.security.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. param permission "this" WebRoleRefPermission is checked to see if it implies the argument permission. return true if the specified permission is implied by this object, false if not. return this.equals(permission);
private synchronized void	readObject(java.io.ObjectInputStream s) readObject reads the serialized fields from the input stream and uses them to restore the permission. This method need not be implemented if establishing the values of the serialized fields (as is done by defaultReadObject) is sufficient to initialize the permission. s.defaultReadObject();
private synchronized void	writeObject(java.io.ObjectOutputStream s) writeObject is used to establish the values of the serialized fields before they are written to the output stream and need not be implemented if the values of the serialized fields are always available and up to date. The serialized fields are written to the output stream in the same form as they would be written by defaultWriteObject. s.defaultWriteObject();