constants.java

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

/*
 * 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;

/**
 * Defines standard names for the OSGi environment property, service property,
 * and Manifest header attribute keys.
 *
 * <p>The values associated with these keys are of type <tt>java.lang.String</tt>,
 * unless otherwise indicated.
 *
 * @version $Revision: 1.1.1.1 $
 * @author Open Services Gateway Initiative
 * @since 1.1
 * @see Bundle#getHeaders
 * @see BundleContext#getProperty
 * @see BundleContext#registerService
 */

public interface Constants
{
    /**
     * Location identifier of the OSGi <i>system bundle</i>, which is
     * defined to be &quot;System Bundle&quot;.
     */
    public static final String SYSTEM_BUNDLE_LOCATION = "System Bundle";

    /**
     * Manifest header (named &quot;Bundle-Category&quot;)
     * identifying the bundle's category.
     * <p>The attribute value may be retrieved from the
     * <tt>Dictionary</tt> object returned by the <tt>Bundle.getHeaders</tt> method.
     */
    public static final String BUNDLE_CATEGORY = "Bundle-Category";

    /**
     * Manifest header (named &quot;Bundle-ClassPath&quot;)
     * identifying a list of nested JAR files, which are bundle resources used
     * to extend the bundle's classpath.
     *
     * <p>The attribute value may be retrieved from the
     * <tt>Dictionary</tt> object returned by the <tt>Bundle.getHeaders</tt> method.
     */
    public static final String BUNDLE_CLASSPATH = "Bundle-ClassPath";

    /**
     * Manifest header (named &quot;Bundle-Copyright&quot;)
     * identifying the bundle's copyright information, which may be retrieved
     * from the <tt>Dictionary</tt> object returned by the <tt>Bundle.getHeaders</tt> method.
     */
    public static final String BUNDLE_COPYRIGHT = "Bundle-Copyright";

    /**
     * Manifest header (named &quot;Bundle-Description&quot;)
     * containing a brief description of the bundle's functionality.
     * <p>The attribute value may be retrieved from the
     * <tt>Dictionary</tt> object returned by the <tt>Bundle.getHeaders</tt> method.
     */
    public static final String BUNDLE_DESCRIPTION = "Bundle-Description";

    /**
     * Manifest header (named &quot;Bundle-Name&quot;)
     * identifying the bundle's name.
     * <p>The attribute value may be retrieved from the
     * <tt>Dictionary</tt> object returned by the <tt>Bundle.getHeaders</tt> method.
     */
    public static final String BUNDLE_NAME = "Bundle-Name";

    /**
     * Manifest header (named &quot;Bundle-NativeCode&quot;)
     * identifying a number of hardware environments and the native language code
     * libraries that the bundle is carrying for each of these environments.
     *
     * <p>The attribute value may be retrieved from the
     * <tt>Dictionary</tt> object returned by the <tt>Bundle.getHeaders</tt> method.
     */
    public static final String BUNDLE_NATIVECODE = "Bundle-NativeCode";

    /**
     * Manifest header (named &quot;Export-Package&quot;)
     * identifying the names (and optionally version numbers) of the packages
     * that the bundle offers to the Framework for export.
     *
     * <p>The attribute value may be retrieved from the
     * <tt>Dictionary</tt> object returned by the <tt>Bundle.getHeaders</tt> method.
     */
    public static final String EXPORT_PACKAGE = "Export-Package";

    /**
     * Manifest header (named &quot;Export-Service&quot;)
     * identifying the fully qualified class names of the services that the
     * bundle may register (used for informational purposes only).
     *
     * <p>The attribute value may be retrieved from the
     * <tt>Dictionary</tt> object returned by the <tt>Bundle.getHeaders</tt> method.
     */
    public static final String EXPORT_SERVICE = "Export-Service";

    /**
     * Manifest header (named &quot;Import-Package&quot;)
     * identifying the names (and optionally, version numbers) of the packages
     * that the bundle is dependent on.
     *
     * <p>The attribute value may be retrieved from the
     * <tt>Dictionary</tt> object returned by the <tt>Bundle.getHeaders</tt> method.
     */
    public static final String IMPORT_PACKAGE = "Import-Package";

    /**
     * Manifest header (named &quot;DynamicImport-Package&quot;)
     * identifying the names of the packages
     * that the bundle may dynamically import during execution.
     *
     * <p>The attribute value may be retrieved from the
     * <tt>Dictionary</tt> object returned by the <tt>Bundle.getHeaders</tt> method.
     * @since 1.2
     */
    public static final String DYNAMICIMPORT_PACKAGE = "DynamicImport-Package";

    /**
     * Manifest header (named &quot;Import-Service&quot;)
     * identifying the fully qualified class names of the services that the
     * bundle requires (used for informational purposes only).
     *
     * <p>The attribute value may be retrieved from the
     * <tt>Dictionary</tt> object returned by the <tt>Bundle.getHeaders</tt> method.
     */
    public static final String IMPORT_SERVICE = "Import-Service";

    /**
     * Manifest header (named &quot;Bundle-Vendor&quot;)
     * identifying the bundle's vendor.
     *
     * <p>The attribute value may be retrieved from the
     * <tt>Dictionary</tt> object returned by the <tt>Bundle.getHeaders</tt> method.
     */
    public static final String BUNDLE_VENDOR = "Bundle-Vendor";

    /**
     * Manifest header (named &quot;Bundle-Version&quot;)
     * identifying the bundle's version.
     *
     * <p>The attribute value may be retrieved from the
     * <tt>Dictionary</tt> object returned by the <tt>Bundle.getHeaders</tt> method.
     */
    public static final String BUNDLE_VERSION = "Bundle-Version";

    /**
     * Manifest header (named &quot;Bundle-DocURL&quot;)
     * identifying the bundle's documentation URL, from which further
     * information about the bundle may be obtained.
     *
     * <p>The attribute value may be retrieved from the
     * <tt>Dictionary</tt> object returned by the <tt>Bundle.getHeaders</tt> method.
     */
    public static final String BUNDLE_DOCURL = "Bundle-DocURL";

    /**
     * Manifest header (named &quot;Bundle-ContactAddress&quot;)
     * identifying the contact address where problems with the
     * bundle may be reported; for example, an email address.
     *
     * <p>The attribute value may be retrieved from the
     * <tt>Dictionary</tt> object returned by the <tt>Bundle.getHeaders</tt> method.
     */
    public static final String BUNDLE_CONTACTADDRESS = "Bundle-ContactAddress";

    /**
     * Manifest header attribute (named &quot;Bundle-Activator&quot;)
     * identifying the bundle's activator class.
     *
     * <p>If present, this header specifies the name of the bundle resource
     * class that implements the <tt>BundleActivator</tt> interface and whose
     * <tt>start</tt> and <tt>stop</tt> methods are called by the Framework
     * when the bundle is started and stopped, respectively.
     *
     * <p>The attribute value may be retrieved from the
     * <tt>Dictionary</tt> object returned by the <tt>Bundle.getHeaders</tt> method.
     */
    public static final String BUNDLE_ACTIVATOR = "Bundle-Activator";

    /**
     * Manifest header (named &quot;Bundle-UpdateLocation&quot;)
     * identifying the location from which a new bundle version is
     * obtained during a bundle update operation.
     *
     * <p>The attribute value may be retrieved from the
     * <tt>Dictionary</tt> object returned by the <tt>Bundle.getHeaders</tt> method.
     */
    public static final String BUNDLE_UPDATELOCATION = "Bundle-UpdateLocation";

    /**
     * Manifest header attribute (named &quot;specification-version&quot;)
     * identifying the version of a package specified in the
     * Export-Package or Import-Package Manifest header.
     *
     * <p>The attribute value is encoded in the Export-Package or