wirepermission.java

OSGI这是一个中间件,与UPNP齐名,是用于移植到嵌入式平台之上

/*
 * $Header: /home/wistrand/cvs/knopflerfish.org/osgi/bundles/wireadmin/src/org/osgi/service/wireadmin/WirePermission.java,v 1.1.1.1 2004/03/05 20:35:18 wistrand Exp $
 *
 * Copyright (c) The Open Services Gateway Initiative (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.service.wireadmin;

import java.io.IOException;
import java.util.Hashtable;
import java.util.Enumeration;
import java.security.Permission;
import java.security.BasicPermission;
import java.security.PermissionCollection;

/**
 * Permission for the scope of a <tt>Wire</tt> object. When a <tt>Envelope</tt> object is used for
 * communication with the <tt>poll</tt> or <tt>update</tt> method, and the
 * scope is set, then the <tt>Wire</tt> object must
 * verify that the Consumer service has <tt>WirePermission[name,CONSUME]</tt> and the
 * Producer service has <tt>WirePermission[name,PRODUCE]</tt> for all names in the scope.
 * <p>
 * The names are compared with the normal rules for permission names. This means
 * that they may end with a "*" to indicate wildcards. E.g. Door.* indicates all scope
 * names starting with the string "Door". The last period is required due to the
 * implementations of the <tt>BasicPermission</tt> class.
 *
 * @version $Revision: 1.1.1.1 $
 * @author Open Services Gateway Initiative
 */
final public class WirePermission extends BasicPermission
{

    /**
     * The action string for the <tt>PRODUCE</tt> action: value is "produce".
     */
    public static final String PRODUCE  = "produce";

    /**
     * The action string for the <tt>CONSUME</tt> action: value is "consume".
     */
    public static final String CONSUME  = "consume";


    private final static int ACTION_PRODUCE         = 0x00000001;
    private final static int ACTION_CONSUME         = 0x00000002;
    private final static int ACTION_ALL             = ACTION_PRODUCE | ACTION_CONSUME;
    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 WirePermission with the given name (may be wildcard) and actions.
     */
    public WirePermission( String name, String actions)
    {
        this(name, getMask(actions));
    }

    /**
     * Package private constructor used by WirePermissionCollection.
     *
     * @param name class name
     * @param action mask
     */
    WirePermission(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 >= 6 && (a[i-6] == 'p' || a[i-6] == 'P') &&
                (a[i-5] == 'r' || a[i-5] == 'R') &&
                (a[i-4] == 'o' || a[i-4] == 'O') &&
                (a[i-3] == 'd' || a[i-3] == 'D') &&
                (a[i-2] == 'u' || a[i-2] == 'U') &&
                (a[i-1] == 'c' || a[i-1] == 'C') &&
                (a[i]   == 'e' || a[i]   == 'E'))
            {
                matchlen = 7;
                mask |= ACTION_PRODUCE;
            }
            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] == 's' || a[i-3] == 'S') &&
                    (a[i-2] == 'u' || a[i-2] == 'U') &&
                    (a[i-1] == 'm' || a[i-1] == 'M') &&
                    (a[i]   == 'e' || a[i]   == 'E'))
            {
                matchlen = 7;
                mask |= ACTION_CONSUME;
            }
            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;
    }

    /**
     * Checks if this <tt>WirePermission</tt> object <tt>implies</tt> the
     * specified permission.
     * <P>
     * More specifically, this method returns <tt>true</tt> if:<p>
     * <ul>
     * <li> <i>p</i> is an instanceof the <tt>WirePermission</tt> class,
     * <li> <i>p</i>'s actions are a proper subset of this
     * object's actions, and
     * <li> <i>p</i>'s name is implied by this object's name. For example,
     * <tt>java.*</tt> implies <tt>java.home</tt>.
     * </ul>
     * @param p The permission to check against.
     *
     * @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 WirePermission)
        {
            WirePermission target = (WirePermission) 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>produce</tt>, <tt>consume</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_PRODUCE) == ACTION_PRODUCE)
            {
                sb.append(PRODUCE);
                comma = true;
            }

            if ((action_mask & ACTION_CONSUME) == ACTION_CONSUME)
            {
                if (comma) sb.append(',');
                sb.append(CONSUME);
            }

            actions = sb.toString();
        }

        return actions;