Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
   /*
    * Copyright (c) OSGi Alliance (2000, 2011). All Rights Reserved.
    * 
    * Licensed under the Apache License, Version 2.0 (the "License");
    * you may not use this file except in compliance with the License.
    * You may obtain a copy of the License at
    *
    *      http://www.apache.org/licenses/LICENSE-2.0
    *
   * Unless required by applicable law or agreed to in writing, software
   * distributed under the License is distributed on an "AS IS" BASIS,
   * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
   * See the License for the specific language governing permissions and
   * limitations under the License.
   */
  
  package org.osgi.framework;
  
  import java.util.HashMap;
  import java.util.List;
  import java.util.Map;

A bundle's authority to perform specific privileged administrative operations on or to get sensitive information about a bundle. The actions for this permission are:
  Action               Methods
  class                Bundle.loadClass
  execute              Bundle.start
                       Bundle.stop
                       BundleStartLevel.setStartLevel
  extensionLifecycle   BundleContext.installBundle for extension bundles
                       Bundle.update for extension bundles
                       Bundle.uninstall for extension bundles
  lifecycle            BundleContext.installBundle
                       Bundle.update
                       Bundle.uninstall
  listener             BundleContext.addBundleListener for SynchronousBundleListener
                       BundleContext.removeBundleListener for SynchronousBundleListener
  metadata             Bundle.getHeaders
                       Bundle.getLocation
  resolve              FrameworkWiring.refreshBundles
                       FrameworkWiring.resolveBundles
  resource             Bundle.getResource
                       Bundle.getResources
                       Bundle.getEntry
                       Bundle.getEntryPaths
                       Bundle.findEntries
                       Bundle resource/entry URL creation
  startlevel           FrameworkStartLevel.setStartLevel
                       FrameworkStartLevel.setInitialBundleStartLevel 
  context              Bundle.getBundleContext
  weave                WovenClass.setBytes
                       WovenClass.getDynamicImports for modification
 

The special action "*" will represent all actions. The resolve action is implied by the class, execute and resource actions.

The name of this permission is a filter expression. The filter gives access to the following attributes:

  • signer - A Distinguished Name chain used to sign a bundle. Wildcards in a DN are not matched according to the filter string rules, but according to the rules defined for a DN chain.
  • location - The location of a bundle.
  • id - The bundle ID of the designated bundle.
  • name - The symbolic name of a bundle.
Filter attribute names are processed in a case sensitive manner.

Version:
$Id: 43baf9a6d7ce5e6108507834e841e340fd91c513 $
ThreadSafe:
  
  
  public final class AdminPermission extends BasicPermission {
  	static final long						serialVersionUID			= 307051004521261705L;

The action string class. The class action implies the resolve action.

Since:
1.3
 
 	public final static String	CLASS"class";
The action string execute. The execute action implies the resolve action.

Since:
1.3
 
 	public final static String	EXECUTE"execute";
The action string extensionLifecycle.

Since:
1.3
 
 	public final static String	EXTENSIONLIFECYCLE"extensionLifecycle";
The action string lifecycle.

Since:
1.3
 
 	public final static String	LIFECYCLE"lifecycle";
The action string listener.

Since:
1.3
 
 	public final static String	LISTENER"listener";
The action string metadata.

Since:
1.3
 
 	public final static String	METADATA"metadata";
The action string resolve. The resolve action is implied by the class, execute and resource actions.

Since:
1.3
 
 	public final static String	RESOLVE"resolve";
The action string resource. The resource action implies the resolve action.

Since:
1.3
 
 	public final static String	RESOURCE"resource";
The action string startlevel.

Since:
1.3
 
 	public final static String	STARTLEVEL"startlevel";

The action string context.

Since:
1.4
 
 	public final static String	CONTEXT"context";

The action string weave.

Since:
1.6
 
 	public final static String						WEAVE"weave";
 
 	private final static int	ACTION_CLASS				= 0x00000001;
 	private final static int	ACTION_EXECUTE				= 0x00000002;
 	private final static int	ACTION_LIFECYCLE			= 0x00000004;
 	private final static int	ACTION_LISTENER				= 0x00000008;
 	private final static int	ACTION_METADATA				= 0x00000010;
 	private final static int	ACTION_RESOLVE				= 0x00000040;
 	private final static int	ACTION_RESOURCE				= 0x00000080;
 	private final static int	ACTION_STARTLEVEL			= 0x00000100;
 	private final static int	ACTION_EXTENSIONLIFECYCLE	= 0x00000200;
 	private final static int	ACTION_CONTEXT				= 0x00000400;
 	private final static int						ACTION_WEAVE				= 0x00000800;
 	private final static int	ACTION_ALL
 	final static int						ACTION_NONE					= 0;

The actions in canonical form.

Serial:
 
 	private volatile String		actionsnull;

The actions mask.
 
 	transient int							action_mask;

If this AdminPermission was constructed with a filter, this holds a Filter matching object used to evaluate the filter in implies.
 
 	transient Filter						filter;

The bundle governed by this AdminPermission - only used if filter == null
 
 	transient final Bundle					bundle;

This map holds the properties of the permission, used to match a filter in implies. This is not initialized until necessary, and then cached in this object.
 
 	private transient volatile Map<StringObject>	properties;

ThreadLocal used to determine if we have recursively called getProperties.
 
 	private static final ThreadLocal<Bundle>	recursenew ThreadLocal<Bundle>();

Creates a new AdminPermission object that matches all bundles and has all actions. Equivalent to AdminPermission("*","*");
 
 	public AdminPermission() {
 		this(null); 
 	}

Create a new AdminPermission. This constructor must only be used to create a permission that is going to be checked.

Examples:

 (signer=\*,o=ACME,c=US)   
 (&(signer=\*,o=ACME,c=US)(name=com.acme.*)(location=http://www.acme.com/bundles/*))
 (id>=1)
 

When a signer key is used within the filter expression the signer value must escape the special filter chars ('*', '(', ')').

Null arguments are equivalent to "*".

Parameters:
filter A filter expression that can use signer, location, id, and name keys. A value of "*" or null matches all bundle. Filter attribute names are processed in a case sensitive manner.
actions class, execute, extensionLifecycle , lifecycle, listener, metadata, resolve , resource, startlevel, context or weave. A value of "*" or null indicates all actions.
Throws:
java.lang.IllegalArgumentException If the filter has an invalid syntax.
 
 	public AdminPermission(String filterString actions) {
 		// arguments will be null if called from a PermissionInfo defined with
 		// no args
 		this(parseFilter(filter), parseActions(actions));
 	}

Creates a new requested AdminPermission object to be used by the code that must perform checkPermission. AdminPermission objects created with this constructor cannot be added to an AdminPermission permission collection.

Parameters:
bundle A bundle.
actions class, execute, extensionLifecycle , lifecycle, listener, metadata, resolve , resource, startlevel, context, weave. A value of "*" or null indicates all actions.
Since:
1.3
 
 	public AdminPermission(Bundle bundleString actions) {
 		super(createName(bundle));
 		setTransients(nullparseActions(actions));
 		this. = bundle;
 	}

Create a permission name from a Bundle

Parameters:
bundle Bundle to use to create permission name.
Returns:
permission name.
 
 	private static String createName(Bundle bundle) {
 		if (bundle == null) {
 			throw new IllegalArgumentException("bundle must not be null");
 		}
 		StringBuffer sb = new StringBuffer("(id=");
 		sb.append(bundle.getBundleId());
 		sb.append(")");
 		return sb.toString();
 	}

Package private constructor used by AdminPermissionCollection.

Parameters:
filter name filter or null for wildcard.
mask action mask
 
 	AdminPermission(Filter filterint mask) {
 		super((filter == null) ? "*" : filter.toString());
 		setTransients(filtermask);
 		this. = null;
 	}

Called by constructors and when deserialized.

Parameters:
filter Permission's filter or null for wildcard.
mask action mask
 
 	private void setTransients(Filter filterint mask) {
 		this. = filter;
 		if ((mask == ) || ((mask & ) != mask)) {
 			throw new IllegalArgumentException("invalid action string");
 		}
 		this. = mask;
 	}

Parse action string into action mask.

Parameters:
actions Action string.
Returns:
action mask.
 
 	private static int parseActions(String actions) {
 		if ((actions == null) || actions.equals("*")) {
 			return ;
 		}
 	
 		boolean seencomma = false;
 	
 		int mask = ;
 
 		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 >= 4 && (a[i - 4] == 'c' || a[i - 4] == 'C')
 					&& (a[i - 3] == 'l' || a[i - 3] == 'L')
 					&& (a[i - 2] == 'a' || a[i - 2] == 'A')
 					&& (a[i - 1] == 's' || a[i - 1] == 'S')
 					&& (a[i] == 's' || a[i] == 'S')) {
 				matchlen = 5;
 	
 			}
 			else
 				if (i >= 6 && (a[i - 6] == 'e' || a[i - 6] == 'E')
 						&& (a[i - 5] == 'x' || a[i - 5] == 'X')
 						&& (a[i - 4] == 'e' || a[i - 4] == 'E')
 						&& (a[i - 3] == 'c' || a[i - 3] == 'C')
 						&& (a[i - 2] == 'u' || a[i - 2] == 'U')
 						&& (a[i - 1] == 't' || a[i - 1] == 'T')
 						&& (a[i] == 'e' || a[i] == 'E')) {
 					matchlen = 7;
 	
 				}
 				else
 					if (i >= 17 && (a[i - 17] == 'e' || a[i - 17] == 'E')
 							&& (a[i - 16] == 'x' || a[i - 16] == 'X')
 							&& (a[i - 15] == 't' || a[i - 15] == 'T')
 							&& (a[i - 14] == 'e' || a[i - 14] == 'E')
 							&& (a[i - 13] == 'n' || a[i - 13] == 'N')
 							&& (a[i - 12] == 's' || a[i - 12] == 'S')
 							&& (a[i - 11] == 'i' || a[i - 11] == 'I')
 							&& (a[i - 10] == 'o' || a[i - 10] == 'O')
 							&& (a[i - 9] == 'n' || a[i - 9] == 'N')
 							&& (a[i - 8] == 'l' || a[i - 8] == 'L')
 							&& (a[i - 7] == 'i' || a[i - 7] == 'I')
 							&& (a[i - 6] == 'f' || a[i - 6] == 'F')
 							&& (a[i - 5] == 'e' || a[i - 5] == 'E')
 							&& (a[i - 4] == 'c' || a[i - 4] == 'C')
 							&& (a[i - 3] == 'y' || a[i - 3] == 'Y')
 							&& (a[i - 2] == 'c' || a[i - 2] == 'C')
 							&& (a[i - 1] == 'l' || a[i - 1] == 'L')
 							&& (a[i] == 'e' || a[i] == 'E')) {
 						matchlen = 18;
 	
 					}
 					else
 						if (i >= 8 && (a[i - 8] == 'l' || a[i - 8] == 'L')
 								&& (a[i - 7] == 'i' || a[i - 7] == 'I')
 								&& (a[i - 6] == 'f' || a[i - 6] == 'F')
 								&& (a[i - 5] == 'e' || a[i - 5] == 'E')
 								&& (a[i - 4] == 'c' || a[i - 4] == 'C')
 								&& (a[i - 3] == 'y' || a[i - 3] == 'Y')
 								&& (a[i - 2] == 'c' || a[i - 2] == 'C')
 								&& (a[i - 1] == 'l' || a[i - 1] == 'L')
 								&& (a[i] == 'e' || a[i] == 'E')) {
 							matchlen = 9;
 							mask |= ;
 	
 						}
 						else
 							if (i >= 7 && (a[i - 7] == 'l' || a[i - 7] == 'L')
 									&& (a[i - 6] == 'i' || a[i - 6] == 'I')
 									&& (a[i - 5] == 's' || a[i - 5] == 'S')
 									&& (a[i - 4] == 't' || a[i - 4] == 'T')
 									&& (a[i - 3] == 'e' || a[i - 3] == 'E')
 									&& (a[i - 2] == 'n' || a[i - 2] == 'N')
 									&& (a[i - 1] == 'e' || a[i - 1] == 'E')
 									&& (a[i] == 'r' || a[i] == 'R')) {
 								matchlen = 8;
 								mask |= ;
 	
 							}
 							else
 								if (i >= 7
 										&& (a[i - 7] == 'm' || a[i - 7] == 'M')
 										&& (a[i - 6] == 'e' || a[i - 6] == 'E')
 										&& (a[i - 5] == 't' || a[i - 5] == 'T')
 										&& (a[i - 4] == 'a' || a[i - 4] == 'A')
 										&& (a[i - 3] == 'd' || a[i - 3] == 'D')
 										&& (a[i - 2] == 'a' || a[i - 2] == 'A')
 										&& (a[i - 1] == 't' || a[i - 1] == 'T')
 										&& (a[i] == 'a' || a[i] == 'A')) {
 									matchlen = 8;
 									mask |= ;
 	
 								}
 								else
 									if (i >= 6
 											&& (a[i - 6] == 'r' || a[i - 6] == 'R')
 											&& (a[i - 5] == 'e' || a[i - 5] == 'E')
 											&& (a[i - 4] == 's' || a[i - 4] == 'S')
 											&& (a[i - 3] == 'o' || a[i - 3] == 'O')
 											&& (a[i - 2] == 'l' || a[i - 2] == 'L')
 											&& (a[i - 1] == 'v' || a[i - 1] == 'V')
 											&& (a[i] == 'e' || a[i] == 'E')) {
 										matchlen = 7;
 										mask |= ;
 	
 									}
 									else
 										if (i >= 7
 												&& (a[i - 7] == 'r' || a[i - 7] == 'R')
 												&& (a[i - 6] == 'e' || a[i - 6] == 'E')
 												&& (a[i - 5] == 's' || a[i - 5] == 'S')
 												&& (a[i - 4] == 'o' || a[i - 4] == 'O')
 												&& (a[i - 3] == 'u' || a[i - 3] == 'U')
 												&& (a[i - 2] == 'r' || a[i - 2] == 'R')
 												&& (a[i - 1] == 'c' || a[i - 1] == 'C')
 												&& (a[i] == 'e' || a[i] == 'E')) {
 											matchlen = 8;
 											mask |= 
 	
 										}
 										else
 											if (i >= 9
 													&& (a[i - 9] == 's' || a[i - 9] == 'S')
 													&& (a[i - 8] == 't' || a[i - 8] == 'T')
 													&& (a[i - 7] == 'a' || a[i - 7] == 'A')
 													&& (a[i - 6] == 'r' || a[i - 6] == 'R')
 													&& (a[i - 5] == 't' || a[i - 5] == 'T')
 													&& (a[i - 4] == 'l' || a[i - 4] == 'L')
 													&& (a[i - 3] == 'e' || a[i - 3] == 'E')
 													&& (a[i - 2] == 'v' || a[i - 2] == 'V')
 													&& (a[i - 1] == 'e' || a[i - 1] == 'E')
 													&& (a[i] == 'l' || a[i] == 'L')) {
 												matchlen = 10;
 												mask |= ;
 	
 											}
 											else
 												if (i >= 6
 														&& (a[i - 6] == 'c' || a[i - 6] == 'C')
 														&& (a[i - 5] == 'o' || a[i - 5] == 'O')
 														&& (a[i - 4] == 'n' || a[i - 4] == 'N')
 														&& (a[i - 3] == 't' || a[i - 3] == 'T')
 														&& (a[i - 2] == 'e' || a[i - 2] == 'E')
 														&& (a[i - 1] == 'x' || a[i - 1] == 'X')
 														&& (a[i] == 't' || a[i] == 'T')) {
 													matchlen = 7;
 													mask |= ;
 	
 												}
 												else
 													if (i >= 4
 															&& (a[i - 4] == 'w' || a[i - 4] == 'W')
 															&& (a[i - 3] == 'e' || a[i - 3] == 'E')
 															&& (a[i - 2] == 'a' || a[i - 2] == 'A')
 															&& (a[i - 1] == 'v' || a[i - 1] == 'V')
 															&& (a[i] == 'e' || a[i] == 'E')) {
 														matchlen = 5;
 														mask |= ;
 
 													}
 													else
 														if (i >= 0
 																&& (a[i] == '*')) {
 															matchlen = 1;
 															mask |= ;
 
 														}
 														else {
 															// parse error
 																	"invalid permission: "
 																			+ actions);
 														}
 	
 			// make sure we didn't just match the tail of a word
 			// like "ackbarfstartlevel". Also, skip to the comma.
 			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 :
 								"invalid permission: " + actions); 
 				}
 				i--;
 			}
 	
 			// point i at the location of the comma minus one (or -1).
 			i -= matchlen;
 		}
 	
 		if (seencomma) {
 			throw new IllegalArgumentException("invalid permission: " + 
 					actions);
 		}
 	
 		return mask;
 	}

Parse filter string into a Filter object.

Parameters:
filterString The filter string to parse.
Returns:
a Filter for this bundle. If the specified filterString is null or equals "*", then null is returned to indicate a wildcard.
Throws:
java.lang.IllegalArgumentException If the filter syntax is invalid.
 
 	private static Filter parseFilter(String filterString) {
 		if (filterString == null) {
 			return null;
 		}
 		filterString = filterString.trim();
 		if (filterString.equals("*")) {
 			return null;
 		}
 		
 		try {
 			return FrameworkUtil.createFilter(filterString);
 		}
 		catch (InvalidSyntaxException e) {
 					"invalid filter");
 			iae.initCause(e);
 			throw iae;
 		}
 	}

Determines if the specified permission is implied by this object. This method throws an exception if the specified permission was not constructed with a bundle.

This method returns true if the specified permission is an AdminPermission AND

  • this object's filter matches the specified permission's bundle ID, bundle symbolic name, bundle location and bundle signer distinguished name chain OR
  • this object's filter is "*"
AND this object's actions include all of the specified permission's actions.

Special case: if the specified permission was constructed with "*" filter, then this method returns true if this object's filter is "*" and this object's actions include all of the specified permission's actions

Parameters:
p The requested permission.
Returns:
true if the specified permission is implied by this object; false otherwise.
 
 	public boolean implies(Permission p) {
 		if (!(p instanceof AdminPermission)) {
 			return false;
 		}
 		AdminPermission requested = (AdminPermissionp;
 		if ( != null) {
 			return false;
 		}
 		// if requested permission has a filter, then it is an invalid argument
 		if (requested.filter != null) {
 			return false;
 		}
 		return implies0(requested);
 	}

Internal implies method. Used by the implies and the permission collection implies methods.

Parameters:
requested The requested AdminPermision which has already be validated as a proper argument. The requested AdminPermission must not have a filter expression.
effective The effective actions with which to start.
Returns:
true if the specified permission is implied by this object; false otherwise.
 
 	boolean implies0(AdminPermission requestedint effective) {
 		/* check actions first - much faster */
 		effective |= ;
 		final int desired = requested.action_mask;
 		if ((effective & desired) != desired) {
 			return false;
 		}
 	
 		/* Get our filter */
 		Filter f = ;
 		if (f == null) {
 			// it's "*"
 			return true;
 		}
 		/* is requested a wildcard filter? */
 		if (requested.bundle == null) {
 			return false;
 		}
 		Map<StringObjectrequestedProperties = requested
 		if (requestedProperties == null) {
 			/*
 			 * If the requested properties are null, then we have detected a
 			 * recursion getting the bundle location. So we return true to
 			 * permit the bundle location request in the AdminPermission check
 			 * up the stack to succeed.
 			 */
 			return true;
 		}
 		return f.matches(requestedProperties);
 	}

Returns the canonical string representation of the AdminPermission actions.

Always returns present AdminPermission actions in the following order: class, execute, extensionLifecycle, lifecycle, listener, metadata, resolve, resource, startlevel, context, weave.

Returns:
Canonical string representation of the AdminPermission actions.
 
 	public String getActions() {
 		String result = ;
 		if (result == null) {
 			StringBuffer sb = new StringBuffer();
 	
 			int mask = ;
 			if ((mask & ) == ) {
 				sb.append(',');
 			}
 	
 			if ((mask & ) == ) {
 				sb.append(',');
 			}
 	
 				sb.append(',');
 			}
 	
 			if ((mask & ) == ) {
 				sb.append(',');
 			}
 	
 			if ((mask & ) == ) {
 				sb.append(',');
 			}
 	
 			if ((mask & ) == ) {
 				sb.append(',');
 			}
 	
 			if ((mask & ) == ) {
 				sb.append(',');
 			}
 	
 			if ((mask & ) == ) {
 				sb.append(',');
 			}
 	
 			if ((mask & ) == ) {
 				sb.append(',');
 			}
 	
 			if ((mask & ) == ) {
 				sb.append(',');
 			}
 
 			if ((mask & ) == ) {
 				sb.append(',');
 			}
 	
 			// remove trailing comma
 			if (sb.length() > 0) {
 				sb.setLength(sb.length() - 1);
 			}
 	
 			 = result = sb.toString();
 		}
 		return result;
 	}

Returns a new PermissionCollection object suitable for storing AdminPermissions.

Returns:
A new PermissionCollection object.
 
 		return new AdminPermissionCollection();
 	}

Determines the equality of two AdminPermission objects.

Parameters:
obj The object being compared for equality with this object.
Returns:
true if obj is equivalent to this AdminPermission; false otherwise.
 
 	public boolean equals(Object obj) {
 		if (obj == this) {
 			return true;
 		}
 
 		if (!(obj instanceof AdminPermission)) {
 			return false;
 		}
 
 
 		return ( == ap.action_mask)
 				&& (( == ap.bundle) || (( != null) && 
 						.equals(ap.bundle)))
 				&& ( == null ? ap.filter == null : 
 						.equals(ap.filter));
 	}

Returns the hash code value for this object.

Returns:
Hash code value for this object.
 
 	public int hashCode() {
 		int h = 31 * 17 + getName().hashCode();
 		h = 31 * h + getActions().hashCode();
 		if ( != null) {
 			h = 31 * h + .hashCode();
 		}
 		return h;
 	}

WriteObject is called to save the state of this permission object to a stream. The actions are serialized, and the superclass takes care of the name.
 
 	private synchronized void writeObject(java.io.ObjectOutputStream s)
 			throws IOException {
 		if ( != null) {
 			throw new NotSerializableException("cannot serialize");
 		}
 		// Write out the actions. The superclass takes care of the name
 		// call getActions to make sure actions field is initialized
 		if ( == null)
 	}

readObject is called to restore the state of this permission from a stream.
 
 	private synchronized void readObject(java.io.ObjectInputStream s)
 		// Read in the data, then initialize the transients
 	}

Called by implies0 on an AdminPermission which was constructed with a Bundle. This method loads a map with the filter-matchable properties of this bundle. The map is cached so this lookup only happens once. This method should only be called on an AdminPermission which was constructed with a bundle

Returns:
a map of properties for this bundle
 
 	private Map<StringObjectgetProperties() {
 		Map<StringObjectresult = ;
 		if (result != null) {
 			return result;
 		}
 		/*
 		 * We may have recursed here due to the Bundle.getLocation call in the
 		 * doPrivileged below. If this is the case, return null to allow implies
 		 * to return true.
 		 */
 		final Object mark = .get();
 		if (mark == ) {
 			return null;
 		}
 		try {
 			final Map<StringObjectmap = new HashMap<StringObject>(
 					4);
 			AccessController.doPrivileged(new PrivilegedAction<Object>() {
 				public Object run() {
 					map.put("id"new Long(.getBundleId()));
 					map.put("location".getLocation());
 					if (name != null) {
 						map.put("name"name);
 					}
 					if (signer.isBundleSigned()) {
 						map.put("signer"signer);
 					}
 					return null;
 				}
 			});
 			return  = map;
 		}
 		finally {
 			.set(null);
 		}
 	}
 }

Stores a collection of AdminPermissions.
 
 	private static final long	serialVersionUID	= 3906372644575328048L;
Collection of permissions.

GuardedBy:
this
 
 	private transient Map<StringAdminPermission>	permissions;

Boolean saying if "*" is in the collection.

Serial:
GuardedBy:
this
 
 	private boolean				all_allowed;

Create an empty AdminPermissions object.
 
 	}

Adds a permission to this permission collection.

Parameters:
permission The AdminPermission object to add.
Throws:
java.lang.IllegalArgumentException If the specified permission is not an AdminPermission instance or was constructed with a Bundle object.
java.lang.SecurityException If this AdminPermissionCollection object has been marked read-only.
 
 	public void add(Permission permission) {
 		if (!(permission instanceof AdminPermission)) {
 			throw new IllegalArgumentException("invalid permission: "
 					+ permission);
 		}
 		if (isReadOnly()) {
 			throw new SecurityException("attempt to add a Permission to a "
 					+ "readonly PermissionCollection"); 
 		}
 		final AdminPermission ap = (AdminPermissionpermission;
 		if (ap.bundle != null) {
 			throw new IllegalArgumentException("cannot add to collection: "
 					+ ap);
 		}
 		final String name = ap.getName();
 		synchronized (this) {
 			AdminPermission existing = pc.get(name);
 			if (existing != null) {
 				int oldMask = existing.action_mask;
 				int newMask = ap.action_mask;
 
 				if (oldMask != newMask) {
 					pc.put(namenew AdminPermission(existing.filteroldMask
 							| newMask));
 				}
 			}
 			else {
 				pc.put(nameap);
 			}
 			if (!) {
 				if (name.equals("*")) {
 					 = true;
 				}
 			}
 		}
 	}

Determines if the specified permissions implies the permissions expressed in permission.

Parameters:
permission The Permission object to compare with the AdminPermission objects in this collection.
Returns:
true if permission is implied by an AdminPermission in this collection, false otherwise.
 
 	public boolean implies(Permission permission) {
 		if (!(permission instanceof AdminPermission)) {
 			return false;
 		}
 
 		AdminPermission requested = (AdminPermissionpermission;
 		// if requested permission has a filter, then it is an invalid argument
 		if (requested.filter != null) {
 			return false;
 		}
 		int effective = .;
 		synchronized (this) {
 			// short circuit if the "*" Permission was added
 			if () {
				AdminPermission ap = pc.get("*");
				if (ap != null) {
					effective |= ap.action_mask;
					final int desired = requested.action_mask;
					if ((effective & desired) == desired) {
						return true;
			perms = pc.values();
		// just iterate one by one
		for (AdminPermission perm : perms) {
			if (perm.implies0(requestedeffective)) {
				return true;
		return false;
	}

Returns an enumeration of all AdminPermission objects in the container.

Returns:
Enumeration of all AdminPermission objects.
	public synchronized Enumeration<Permissionelements() {
		return Collections.enumeration(all);
	/* serialization logic */
    private static final ObjectStreamField[]	serialPersistentFields	= {
			new ObjectStreamField("permissions"Hashtable.class),
			new ObjectStreamField("all_allowed".)			};
    
    private synchronized void writeObject(ObjectOutputStream out)
			throws IOException {
		pfields.put("permissions"hashtable);
		pfields.put("all_allowed");
    
	private synchronized void readObject(java.io.ObjectInputStream in)
			throws IOException,
				.get("permissions"null);
		 = gfields.get("all_allowed"false);
New to GrepCode? Check out our FAQ X