Start line:  
End line:  

Snippet Preview

Snippet HTML Code

Stack Overflow Questions
   /*
    * Copyright (c) OSGi Alliance (2000, 2012). 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: cd883e81fde210ce8f0cabaebea377378d672818 $
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;
 	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
 															throw new IllegalArgumentException("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 :
 						throw new IllegalArgumentException("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) {
 			IllegalArgumentException iae = new IllegalArgumentException("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.getProperties();
 		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 sthrows 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 sthrows IOExceptionClassNotFoundException {
 		// 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 outthrows IOException {
 		pfields.put("permissions"hashtable);
 		pfields.put("all_allowed");
 		out.writeFields();
 	}
 
 	private synchronized void readObject(java.io.ObjectInputStream inthrows IOExceptionClassNotFoundException {
		Hashtable<StringAdminPermissionhashtable = (Hashtable<StringAdminPermission>) gfields.get("permissions"null);
		 = gfields.get("all_allowed"false);
New to GrepCode? Check out our FAQ X