File	Doc	Category	Size	Date	Package
PropertyPermission.java	API Doc	Java SE 5 API	17354	Fri Aug 26 14:57:24 BST 2005	java.util

PropertyPermission

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

Fields Summary
private static final int	READ Read action.
private static final int	WRITE Write action.
private static final int	ALL All actions (read,write);
private static final int	NONE No actions.
private transient int	mask The actions mask.
private String	actions The actions string.
private static final long	serialVersionUID

Constructors Summary

public PropertyPermission(String name, String actions) Creates a new PropertyPermission object with the specified name. The name is the name of the system property, and actions contains a comma-separated list of the desired actions granted on the property. Possible actions are "read" and "write". param name the name of the PropertyPermission. param actions the actions string. super(name,actions); init(getMask(actions));

Methods Summary
public boolean	equals(java.lang.Object obj) Checks two PropertyPermission objects for equality. Checks that obj is a PropertyPermission, and has the same name and actions as this object. param obj the object we are testing for equality with this object. return true if obj is a PropertyPermission, and has the same name and actions as this PropertyPermission object. if (obj == this) return true; if (! (obj instanceof PropertyPermission)) return false; PropertyPermission that = (PropertyPermission) obj; return (this.mask == that.mask) && (this.getName().equals(that.getName()));
static java.lang.String	getActions(int mask) Return the canonical string representation of the actions. Always returns present actions in the following order: read, write. return the canonical string representation of the actions. StringBuilder sb = new StringBuilder(); boolean comma = false; if ((mask & READ) == READ) { comma = true; sb.append("read"); } if ((mask & WRITE) == WRITE) { if (comma) sb.append(',"); else comma = true; sb.append("write"); } return sb.toString();
public java.lang.String	getActions() Returns the "canonical string representation" of the actions. That is, this method always returns present actions in the following order: read, write. For example, if this PropertyPermission object allows both write and read actions, a call to getActions will return the string "read,write". return the canonical string representation of the actions. if (actions == null) actions = getActions(this.mask); return actions;
private static int	getMask(java.lang.String actions) Converts an actions String to an actions mask. param action the action string. return the actions mask. int mask = NONE; if (actions == null) { return mask; } // Check against use of constants (used heavily within the JDK) if (actions == SecurityConstants.PROPERTY_READ_ACTION) { return READ; } if (actions == SecurityConstants.PROPERTY_WRITE_ACTION) { return WRITE; } else if (actions == SecurityConstants.PROPERTY_RW_ACTION) { return READ|WRITE; } char[] a = actions.toCharArray(); int i = a.length - 1; if (i < 0) return mask; while (i != -1) { char c; // skip whitespace while ((i!=-1) && ((c = a[i]) == ' " || c == '\r" || c == '\n" || c == '\f" || c == '\t")) i--; // check for the known strings int matchlen; if (i >= 3 && (a[i-3] == 'r" || a[i-3] == 'R") && (a[i-2] == 'e" || a[i-2] == 'E") && (a[i-1] == 'a" || a[i-1] == 'A") && (a[i] == 'd" || a[i] == 'D")) { matchlen = 4; mask |= READ; } else if (i >= 4 && (a[i-4] == 'w" || a[i-4] == 'W") && (a[i-3] == 'r" || a[i-3] == 'R") && (a[i-2] == 'i" || a[i-2] == 'I") && (a[i-1] == 't" || a[i-1] == 'T") && (a[i] == 'e" || a[i] == 'E")) { matchlen = 5; mask |= WRITE; } else { // parse error throw new IllegalArgumentException( "invalid permission: " + actions); } // make sure we didn't just match the tail of a word // like "ackbarfaccept". Also, skip to the comma. boolean seencomma = false; while (i >= matchlen && !seencomma) { switch(a[i-matchlen]) { case ',": seencomma = true; /*FALLTHROUGH*/ case ' ": case '\r": case '\n": case '\f": case '\t": break; default: throw new IllegalArgumentException( "invalid permission: " + actions); } i--; } // point i at the location of the comma minus one (or -1). i -= matchlen; } return mask;
int	getMask() Return the current action mask. Used by the PropertyPermissionCollection return the actions mask. return mask;
public int	hashCode() Returns the hash code value for this object. The hash code used is the hash code of this permissions name, that is, getName().hashCode(), where getName is from the Permission superclass. return a hash code value for this object. return this.getName().hashCode();
public boolean	implies(java.security.Permission p) Checks if this PropertyPermission object "implies" the specified permission. More specifically, this method returns true if: p is an instanceof PropertyPermission, p's actions are a subset of this object's actions, and p's name is implied by this object's name. For example, "java.*" implies "java.home". param p the permission to check against. return true if the specified permission is implied by this object, false if not. if (!(p instanceof PropertyPermission)) return false; PropertyPermission that = (PropertyPermission) p; // we get the effective mask. i.e., the "and" of this and that. // They must be equal to that.mask for implies to return true. return ((this.mask & that.mask) == that.mask) && super.implies(that);
private void	init(int mask) initialize a PropertyPermission object. Common to all constructors. Also called during de-serialization. param mask the actions mask to use. // Left null as long as possible, then // created and re-used in the getAction function. if ((mask & ALL) != mask) throw new IllegalArgumentException("invalid actions mask"); if (mask == NONE) throw new IllegalArgumentException("invalid actions mask"); if (getName() == null) throw new NullPointerException("name can't be null"); this.mask = mask;
public java.security.PermissionCollection	newPermissionCollection() Returns a new PermissionCollection object for storing PropertyPermission objects. return a new PermissionCollection object suitable for storing PropertyPermissions. return new PropertyPermissionCollection();
private synchronized void	readObject(java.io.ObjectInputStream s) readObject is called to restore the state of the PropertyPermission from a stream. // Read in the action, then initialize the rest s.defaultReadObject(); init(getMask(actions));
private synchronized void	writeObject(java.io.ObjectOutputStream s) WriteObject is called to save the state of the PropertyPermission to a stream. The actions are serialized, and the superclass takes care of the name. // Write out the actions. The superclass takes care of the name // call getActions to make sure actions field is initialized if (actions == null) getActions(); s.defaultWriteObject();