/* * $Header: /cvshome/repository/org/osgi/framework/ServicePermission.java,v 1.8 2002/09/23 15:41:22 hargrave Exp $ * * Copyright (c) The Open Services Gateway Initiative (2000, 2002). * All Rights Reserved. * * Implementation of certain elements of the Open Services Gateway Initiative * (OSGI) Specification may be subject to third party intellectual property * rights, including without limitation, patent rights (such a third party may * or may not be a member of OSGi). OSGi is not responsible and shall not be * held responsible in any manner for identifying or failing to identify any or * all such third party intellectual property rights. * * This document and the information contained herein are provided on an "AS * IS" basis and OSGI DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING * BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL * NOT INFRINGE ANY RIGHTS AND ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR * FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT WILL OSGI BE LIABLE FOR ANY * LOSS OF PROFITS, LOSS OF BUSINESS, LOSS OF USE OF DATA, INTERRUPTION OF * BUSINESS, OR FOR DIRECT, INDIRECT, SPECIAL OR EXEMPLARY, INCIDENTIAL, * PUNITIVE OR CONSEQUENTIAL DAMAGES OF ANY KIND IN CONNECTION WITH THIS * DOCUMENT OR THE INFORMATION CONTAINED HEREIN, EVEN IF ADVISED OF THE * POSSIBILITY OF SUCH LOSS OR DAMAGE. * * All Company, brand and product names may be trademarks that are the sole * property of their respective owners. All rights reserved. */package org.osgi.framework;import java.io.IOException;import java.security.BasicPermission;import java.security.Permission;import java.security.PermissionCollection;import java.util.Enumeration;import java.util.Hashtable;/** * Indicates a bundle's authority to register or get a service. * <ul> * <li>The <tt>ServicePermission.REGISTER</tt> action allows a bundle * to register a service on the specified names. * <li>The <tt>ServicePermission.GET</tt> action allows a bundle to detect a service and * get it. * </ul> * Permission to get a service is required in order to detect events regarding the service. * Untrusted bundles should not be able to detect the presence of certain services unless they have * the appropriate <tt>ServicePermission</tt> to get the specific service. * * @version $Revision: 1.8 $ * @author Open Services Gateway Initiative */final public class ServicePermission extends BasicPermission{    /**     * The action string <tt>get</tt> (Value is "get").     */    public final static String GET  = "get";    /**     * The action string <tt>register</tt> (Value is "register").     */    public final static String REGISTER = "register";    private final static int ACTION_GET             = 0x00000001;    private final static int ACTION_REGISTER        = 0x00000002;    private final static int ACTION_ALL             = ACTION_GET | ACTION_REGISTER;    private final static int ACTION_NONE            = 0;    private final static int ACTION_ERROR           = 0x80000000;    /**     * The actions mask.     */    private transient int action_mask = ACTION_NONE;    /**     * The actions in canonical form.     *     * @serial     */    private String actions = null;    /**     * Create a new ServicePermission.     *     * <p>The name of the service is specified as a fully qualified class name.     * <pre>     * ClassName ::= &lt;class name&gt; | &lt;class name ending in ".*"&gt;     * </pre>     * Examples:     * <pre>     *    org.osgi.service.http.HttpService     *    org.osgi.service.http.*     *    org.osgi.service.snmp.*     * </pre>     *     * <p>There are two possible actions: <tt>get</tt> and <tt>register</tt>.     * The <tt>get</tt> permission allows the owner of this permission     * to obtain a service with this name. The <tt>register</tt> permission     * allows the bundle to register a service under that name.     *     * @param name class name     * @param actions <tt>get</tt>, <tt>register</tt> (canonical order)     */    public ServicePermission(String name, String actions)    {        this(name, getMask(actions));    }    /**     * Package private constructor used by ServicePermissionCollection.     *     * @param name class name     * @param action mask     */    ServicePermission(String name, int mask)    {        super(name);        init(mask);    }    /**     * Called by constructors and when deserialized.     *     * @param action mask     */    private void init(int mask)    {        if ((mask == ACTION_NONE) ||            ((mask & ACTION_ALL) != mask))        {            throw new IllegalArgumentException("invalid action string");        }        action_mask = mask;    }    /**     * Parse action string into action mask.     *     * @param actions Action string.     * @return action mask.     */    private static int getMask(String actions)    {    boolean seencomma = false;    int mask = ACTION_NONE;    if (actions == null) {        return 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 >= 2 && (a[i-2] == 'g' || a[i-2] == 'G') &&              (a[i-1] == 'e' || a[i-1] == 'E') &&              (a[i] == 't' || a[i] == 'T'))        {        matchlen = 3;        mask |= ACTION_GET;        } else if (i >= 7 && (a[i-7] == 'r' || a[i-7] == 'R') &&                       (a[i-6] == 'e' || a[i-6] == 'E') &&                       (a[i-5] == 'g' || a[i-5] == 'G') &&                 (a[i-4] == 'i' || a[i-4] == 'I') &&                 (a[i-3] == 's' || a[i-3] == 'S') &&                 (a[i-2] == 't' || a[i-2] == 'T') &&                 (a[i-1] == 'e' || a[i-1] == 'E') &&                 (a[i] == 'r' || a[i] == 'R'))        {        matchlen = 8;        mask |= ACTION_REGISTER;        } else {        // parse error        throw new IllegalArgumentException(            "invalid permission: " + actions);        }        // make sure we didn't just match the tail of a word        // like "ackbarfregister".  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;    }    /**     * Determines if a <tt>ServicePermission</tt> object "implies" the     * specified permission.     *     * @param p The target permission to check.     * @return <tt>true</tt> if the specified permission is implied by     * this object; <tt>false</tt> otherwise.     */    public boolean implies(Permission p)    {        if (p instanceof ServicePermission)        {            ServicePermission target = (ServicePermission) p;            return(((action_mask & target.action_mask)==target.action_mask) &&           super.implies(p));        }        return(false);    }    /**     * Returns the canonical string representation of the actions.     * Always returns present actions in the following order:     * <tt>get</tt>, <tt>register</tt>.     * @return The canonical string representation of the actions.     */    public String getActions()    {        if (actions == null)        {            StringBuffer sb = new StringBuffer();            boolean comma = false;            if ((action_mask & ACTION_GET) == ACTION_GET)            {                sb.append(GET);                comma = true;            }            if ((action_mask & ACTION_REGISTER) == ACTION_REGISTER)            {                if (comma) sb.append(',');