bundles/org.eclipse.osgi/osgi/src/org/osgi/framework/wiring/BundleWiring.java - equinox/rt.equinox.framework - Git at Google

 /*
  * Copyright (c) OSGi Alliance (2010). 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.wiring;

 import java.net.URL;
 import java.util.Collection;
 import java.util.List;

 import org.osgi.framework.Bundle;
 import org.osgi.framework.BundleReference;

 /**
  * A wiring for a bundle. Each time a bundle is resolved, a new bundle wiring
  * for the bundle is created. A bundle wiring consists of a bundle and it
  * attached fragments and represents the dependencies with other bundle wirings.
  *
  * <p>
  * The bundle wiring for a bundle is the {@link #isCurrent() current} bundle
  * wiring if the bundle is resolved and the bundle wiring is the most recent
  * bundle wiring. All bundles with non-current, in use bundle wirings are
  * considered removal pending. A bundle wiring is {@link #isInUse() in use} if
  * it is the current wiring or if some other in use bundle wiring is dependent
  * upon it. For example, wired to a package exported by the bundle wiring or
  * requires the bundle wiring. An in use bundle wiring has a class loader. Once
  * a bundle wiring is no longer in use, it is considered stale and is discarded
  * by the framework.
  *
  * <p>
  * A list of all in use bundle wirings for a bundle can be obtained by calling
  * {@link Bundle#adapt(Class) bundle.adapt}({@link BundleWirings}.class).
  * {@link BundleWirings#getWirings() getWirings()}. For non-fragment bundles,
  * the first item in the returned list is the current bundle wiring.
  *
  * <p>
  * The current bundle wiring for a non-fragment bundle can be obtained by
  * calling {@link Bundle#adapt(Class) bundle.adapt}(BundleWiring.class). A
  * fragment bundle does not itself have bundle wirings. So calling
  * {@link Bundle#adapt(Class) bundle.adapt}(BundleWiring.class) on a fragment
  * must return {@code null}.
  *
  * @ThreadSafe
  * @noimplement
  * @version $Id: 77da60ad2f9fdeea7bd9465b633b35f8a06c6cdf $
  */
 public interface BundleWiring extends BundleReference {
 	/**
 	 * Returns {@code true} if this bundle wiring is the current bundle wiring.
 	 * The bundle wiring for a bundle is the current bundle wiring if the bundle
 	 * is resolved and the bundle wiring is the most recent bundle wiring. All
 	 * bundles with non-current, in use bundle wirings are considered
 	 * {@link FrameworkWiring#getRemovalPendingBundles() removal pending}.
 	 *
 	 * @return {@code true} if this bundle wiring is the current bundle wiring;
 	 *         {@code false} otherwise.
 	 */
 	boolean isCurrent();

 	/**
 	 * Returns {@code true} if this bundle wiring is in use. A bundle wiring is
 	 * in use if it is the {@link #isCurrent() current} wiring or if some other
 	 * in use bundle wiring is dependent upon it. Once a bundle wiring is no
 	 * longer in use, it is considered stale and is discarded by the framework.
 	 *
 	 * @return {@code true} if this bundle wiring is in use; {@code false}
 	 *         otherwise.
 	 */
 	boolean isInUse();

 	/**
 	 * Returns the capabilities provided by this bundle wiring.
 	 *
 	 * @param capabilityNamespace The name space of the provided capabilities to
 	 *        return or {@code null} to return the provided capabilities from
 	 *        all name spaces.
 	 * @return A list containing a snapshot of the {@link WiredCapability}s, or
 	 *         an empty list if this bundle wiring provides no capabilities in
 	 *         the specified name space. If this bundle wiring is not
 	 *         {@link #isInUse() in use}, {@code null} will be returned. The
 	 *         list contains the provided capabilities in the order they are
 	 *         specified in the manifest.
 	 */
 	List<WiredCapability> getProvidedCapabilities(String capabilityNamespace);

 	/**
 	 * Returns the required capabilities used by this bundle wiring.
 	 *
 	 * <p>
 	 * The result of this method can change if this bundle wiring requires
 	 * additional capabilities.
 	 *
 	 * @param capabilityNamespace The name space of the required capabilities to
 	 *        return or {@code null} to return the required capabilities from
 	 *        all name spaces.
 	 * @return A list containing a snapshot of the {@link WiredCapability}s used
 	 *         by this bundle wiring, or an empty list if this bundle wiring
 	 *         requires no capabilities in the specified name space. If this
 	 *         bundle wiring is not {@link #isInUse() in use}, {@code null} will
 	 *         be returned. The list contains the required capabilities in the
 	 *         order they are specified in the manifest.
 	 */
 	List<WiredCapability> getRequiredCapabilities(String capabilityNamespace);

 	/**
 	 * Returns the bundle revision for the bundle in this bundle wiring. Since a
 	 * bundle update can change the entries in a bundle, different bundle
 	 * wirings for the same bundle can have different bundle revisions.
 	 *
 	 * <p>
 	 * The bundle object {@link BundleReference#getBundle() referenced} by the
 	 * returned {@code BundleRevision} may return different information than the
 	 * returned {@code BundleRevision} since the returned {@code BundleRevision}
 	 * may refer to an older revision of the bundle.
 	 *
 	 * @return The bundle revision for this bundle wiring.
 	 */
 	BundleRevision getBundleRevision();

 	/**
 	 * Returns the bundle revisions for all attached fragments of this bundle
 	 * wiring. Since a bundle update can change the entries in a fragment,
 	 * different bundle wirings for the same bundle can have different bundle
 	 * revisions.
 	 *
 	 * <p>
 	 * The bundle revisions in the list are ordered in fragment attachment order
 	 * such that the first revision in the list is the first attached fragment
 	 * and the last revision in the list is the last attached fragment.
 	 *
 	 * @return A list containing a snapshot of the {@link BundleRevision}s for
 	 *         all attached fragments attached of this bundle wiring, or an
 	 *         empty list if this bundle wiring does not have any attached
 	 *         fragments. If this bundle wiring is not {@link #isInUse() in use}
 	 *         , {@code null} will be returned.
 	 */
 	List<BundleRevision> getFragmentRevisions();

 	/**
 	 * Returns the class loader for this bundle wiring. Since a bundle refresh
 	 * creates a new bundle wiring for a bundle, different bundle wirings for
 	 * the same bundle will have different class loaders.
 	 *
 	 * @return The class loader for this bundle wiring. If this bundle wiring is
 	 *         not {@link #isInUse() in use}, {@code null} will be returned.
 	 * @throws SecurityException If the caller does not have the appropriate
 	 *         {@code RuntimePermission("getClassLoader")}, and the Java Runtime
 	 *         Environment supports permissions.
 	 */
 	ClassLoader getClassLoader();

 	/**
 	 * Returns entries in this bundle wiring's {@link #getBundleRevision()
 	 * bundle revision} and its attached {@link #getFragmentRevisions() fragment
 	 * revisions}. This bundle wiring's class loader is not used to search for
 	 * entries. Only the contents of this bundle wiring's bundle revision and
 	 * its attached fragment revisions are searched for the specified entries.
 	 *
 	 * <p>
 	 * This method takes into account that the &quot;contents&quot; of this
 	 * bundle wiring can have attached fragments. This &quot;bundle space&quot;
 	 * is not a namespace with unique members; the same entry name can be
 	 * present multiple times. This method therefore returns a list of URL
 	 * objects. These URLs can come from different JARs but have the same path
 	 * name. This method can either return only entries in the specified path or
 	 * recurse into subdirectories returning entries in the directory tree
 	 * beginning at the specified path.
 	 *
 	 * <p>
 	 * Note: Jar and zip files are not required to include directory entries.
 	 * URLs to directory entries will not be returned if the bundle contents do
 	 * not contain directory entries.
 	 *
 	 * @param path The path name in which to look. The path is always relative
 	 *        to the root of this bundle wiring and may begin with
 	 *        &quot;/&quot;. A path value of &quot;/&quot; indicates the root of
 	 *        this bundle wiring.
 	 * @param filePattern The file name pattern for selecting entries in the
 	 *        specified path. The pattern is only matched against the last
 	 *        element of the entry path. If the entry is a directory then the
 	 *        trailing &quot;/&quot; is not used for pattern matching. Substring
 	 *        matching is supported, as specified in the Filter specification,
 	 *        using the wildcard character (&quot;*&quot;). If {@code null} is
 	 *        specified, this is equivalent to &quot;*&quot; and matches all
 	 *        files.
 	 * @param options The options for listing resource names. See
 	 *        {@link #FINDENTRIES_RECURSE}. The method must ignore unrecognized
 	 *        options.
 	 * @return An unmodifiable list of URL objects for each matching entry, or
 	 *         an empty list if no matching entry could not be found or if the
 	 *         caller does not have the appropriate
 	 *         {@code AdminPermission[bundle,RESOURCE]} and the Java Runtime
 	 *         Environment supports permissions. The list is ordered such that
 	 *         entries from the {@link #getBundleRevision() bundle revision} are
 	 *         returned first followed by the entries from
 	 *         {@link #getFragmentRevisions() attached fragment revisions} in
 	 *         attachment order. If this bundle wiring is not {@link #isInUse()
 	 *         in use}, {@code null} must be returned.
 	 * @see Bundle#findEntries(String, String, boolean)
 	 */
 	List<URL> findEntries(String path, String filePattern, int options);

 	/**
 	 * The find entries operation must recurse into subdirectories.
 	 *
 	 * <p>
 	 * This bit may be set when calling
 	 * {@link #findEntries(String, String, int)} to specify the result must
 	 * include the matching entries from the specified path and its
 	 * subdirectories. If this bit is not set, then the result must only include
 	 * matching entries from the specified path.
 	 *
 	 * @see #findEntries(String, String, int)
 	 */
 	int	FINDENTRIES_RECURSE	= 0x00000001;

 	/**
 	 * Returns the names of resources visible to this bundle wiring's
 	 * {@link #getClassLoader() class loader}. The returned names can be used to
 	 * access the resources via this bundle wiring's class loader.
 	 *
 	 * <ul>
 	 * <li>Only the resource names for resources in bundle wirings will be
 	 * returned. The names of resources visible to a bundle wiring's parent
 	 * class loader, such as the bootstrap class loader, must not be included in
 	 * the result.
 	 * <li>Only established wires will be examined for resources. This method
 	 * must not cause new wires for dynamic imports to be established.
 	 * </ul>
 	 *
 	 * @param path The path name in which to look. The path is always relative
 	 *        to the root of this bundle wiring's class loader and may begin
 	 *        with &quot;/&quot;. A path value of &quot;/&quot; indicates the
 	 *        root of this bundle wiring's class loader.
 	 * @param filePattern The file name pattern for selecting resource names in
 	 *        the specified path. The pattern is only matched against the last
 	 *        element of the resource path. If the resource is a directory then
 	 *        the trailing &quot;/&quot; is not used for pattern matching.
 	 *        Substring matching is supported, as specified in the Filter
 	 *        specification, using the wildcard character (&quot;*&quot;). If
 	 *        {@code null} is specified, this is equivalent to &quot;*&quot; and
 	 *        matches all files.
 	 * @param options The options for listing resource names. See
 	 *        {@link #LISTRESOURCES_LOCAL} and {@link #LISTRESOURCES_RECURSE}.
 	 *        This method must ignore unrecognized options.
 	 * @return An unmodifiable collection of resource names for each matching
 	 *         resource, or an empty collection if no matching resource could
 	 *         not be found or if the caller does not have the appropriate
 	 *         {@code AdminPermission[bundle,RESOURCE]} and the Java Runtime
 	 *         Environment supports permissions. The collection is unordered and
 	 *         must contain no duplicate resource names. If this bundle wiring
 	 *         is not {@link #isInUse() in use}, {@code null} must be returned.
 	 */
 	Collection<String> listResources(String path, String filePattern,
 			int options);

 	/**
 	 * The list resource names operation must recurse into subdirectories.
 	 *
 	 * <p>
 	 * This bit may be set when calling
 	 * {@link #listResources(String, String, int)} to specify the result must
 	 * include the names of matching resources from the specified path and its
 	 * subdirectories. If this bit is not set, then the result must only include
 	 * names of matching resources from the specified path.
 	 *
 	 * @see #listResources(String, String, int)
 	 */
 	int	LISTRESOURCES_RECURSE	= 0x00000001;

 	/**
 	 * The list resource names operation must limit the result to the names of
 	 * matching resources contained in this bundle wiring's
 	 * {@link #getBundleRevision() bundle revision} and its attached
 	 * {@link #getFragmentRevisions() fragment revisions}. The result must not
 	 * include resource names for resources in
 	 * {@link Capability#PACKAGE_CAPABILITY package} names which are
 	 * {@link #getRequiredCapabilities(String) imported} by this wiring.
 	 *
 	 * <p>
 	 * This bit may be set when calling
 	 * {@link #listResources(String, String, int)} to specify the result must
 	 * only include the names of matching resources contained in this bundle
 	 * wiring's bundle revision and its attached fragment revisions. If this bit
 	 * is not set, then the result must include the names of matching resources
 	 * reachable from this bundle wiring's class loader which may include the
 	 * names of matching resources contained in imported packages and required
 	 * bundles.
 	 *
 	 * @see #listResources(String, String, int)
 	 */
 	int	LISTRESOURCES_LOCAL		= 0x00000002;
 }
	/*
	* Copyright (c) OSGi Alliance (2010). 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.wiring;

	import java.net.URL;
	import java.util.Collection;
	import java.util.List;

	import org.osgi.framework.Bundle;
	import org.osgi.framework.BundleReference;

	/**
	* A wiring for a bundle. Each time a bundle is resolved, a new bundle wiring
	* for the bundle is created. A bundle wiring consists of a bundle and it
	* attached fragments and represents the dependencies with other bundle wirings.
	*
	* <p>
	* The bundle wiring for a bundle is the {@link #isCurrent() current} bundle
	* wiring if the bundle is resolved and the bundle wiring is the most recent
	* bundle wiring. All bundles with non-current, in use bundle wirings are
	* considered removal pending. A bundle wiring is {@link #isInUse() in use} if
	* it is the current wiring or if some other in use bundle wiring is dependent
	* upon it. For example, wired to a package exported by the bundle wiring or
	* requires the bundle wiring. An in use bundle wiring has a class loader. Once
	* a bundle wiring is no longer in use, it is considered stale and is discarded
	* by the framework.
	*
	* <p>
	* A list of all in use bundle wirings for a bundle can be obtained by calling
	* {@link Bundle#adapt(Class) bundle.adapt}({@link BundleWirings}.class).
	* {@link BundleWirings#getWirings() getWirings()}. For non-fragment bundles,
	* the first item in the returned list is the current bundle wiring.
	*
	* <p>
	* The current bundle wiring for a non-fragment bundle can be obtained by
	* calling {@link Bundle#adapt(Class) bundle.adapt}(BundleWiring.class). A
	* fragment bundle does not itself have bundle wirings. So calling
	* {@link Bundle#adapt(Class) bundle.adapt}(BundleWiring.class) on a fragment
	* must return {@code null}.
	*
	* @ThreadSafe
	* @noimplement
	* @version $Id: 77da60ad2f9fdeea7bd9465b633b35f8a06c6cdf $
	*/
	public interface BundleWiring extends BundleReference {
	/**
	* Returns {@code true} if this bundle wiring is the current bundle wiring.
	* The bundle wiring for a bundle is the current bundle wiring if the bundle
	* is resolved and the bundle wiring is the most recent bundle wiring. All
	* bundles with non-current, in use bundle wirings are considered
	* {@link FrameworkWiring#getRemovalPendingBundles() removal pending}.
	*
	* @return {@code true} if this bundle wiring is the current bundle wiring;
	* {@code false} otherwise.
	*/
	boolean isCurrent();

	/**
	* Returns {@code true} if this bundle wiring is in use. A bundle wiring is
	* in use if it is the {@link #isCurrent() current} wiring or if some other
	* in use bundle wiring is dependent upon it. Once a bundle wiring is no
	* longer in use, it is considered stale and is discarded by the framework.
	*
	* @return {@code true} if this bundle wiring is in use; {@code false}
	* otherwise.
	*/
	boolean isInUse();

	/**
	* Returns the capabilities provided by this bundle wiring.
	*
	* @param capabilityNamespace The name space of the provided capabilities to
	* return or {@code null} to return the provided capabilities from
	* all name spaces.
	* @return A list containing a snapshot of the {@link WiredCapability}s, or
	* an empty list if this bundle wiring provides no capabilities in
	* the specified name space. If this bundle wiring is not
	* {@link #isInUse() in use}, {@code null} will be returned. The
	* list contains the provided capabilities in the order they are
	* specified in the manifest.
	*/
	List<WiredCapability> getProvidedCapabilities(String capabilityNamespace);

	/**
	* Returns the required capabilities used by this bundle wiring.
	*
	* <p>
	* The result of this method can change if this bundle wiring requires
	* additional capabilities.
	*
	* @param capabilityNamespace The name space of the required capabilities to
	* return or {@code null} to return the required capabilities from
	* all name spaces.
	* @return A list containing a snapshot of the {@link WiredCapability}s used
	* by this bundle wiring, or an empty list if this bundle wiring
	* requires no capabilities in the specified name space. If this
	* bundle wiring is not {@link #isInUse() in use}, {@code null} will
	* be returned. The list contains the required capabilities in the
	* order they are specified in the manifest.
	*/
	List<WiredCapability> getRequiredCapabilities(String capabilityNamespace);

	/**
	* Returns the bundle revision for the bundle in this bundle wiring. Since a
	* bundle update can change the entries in a bundle, different bundle
	* wirings for the same bundle can have different bundle revisions.
	*
	* <p>
	* The bundle object {@link BundleReference#getBundle() referenced} by the
	* returned {@code BundleRevision} may return different information than the
	* returned {@code BundleRevision} since the returned {@code BundleRevision}
	* may refer to an older revision of the bundle.
	*
	* @return The bundle revision for this bundle wiring.
	*/
	BundleRevision getBundleRevision();

	/**
	* Returns the bundle revisions for all attached fragments of this bundle
	* wiring. Since a bundle update can change the entries in a fragment,
	* different bundle wirings for the same bundle can have different bundle
	* revisions.
	*
	* <p>
	* The bundle revisions in the list are ordered in fragment attachment order
	* such that the first revision in the list is the first attached fragment
	* and the last revision in the list is the last attached fragment.
	*
	* @return A list containing a snapshot of the {@link BundleRevision}s for
	* all attached fragments attached of this bundle wiring, or an
	* empty list if this bundle wiring does not have any attached
	* fragments. If this bundle wiring is not {@link #isInUse() in use}
	* , {@code null} will be returned.
	*/
	List<BundleRevision> getFragmentRevisions();

	/**
	* Returns the class loader for this bundle wiring. Since a bundle refresh
	* creates a new bundle wiring for a bundle, different bundle wirings for
	* the same bundle will have different class loaders.
	*
	* @return The class loader for this bundle wiring. If this bundle wiring is
	* not {@link #isInUse() in use}, {@code null} will be returned.
	* @throws SecurityException If the caller does not have the appropriate
	* {@code RuntimePermission("getClassLoader")}, and the Java Runtime
	* Environment supports permissions.
	*/
	ClassLoader getClassLoader();

	/**
	* Returns entries in this bundle wiring's {@link #getBundleRevision()
	* bundle revision} and its attached {@link #getFragmentRevisions() fragment
	* revisions}. This bundle wiring's class loader is not used to search for
	* entries. Only the contents of this bundle wiring's bundle revision and
	* its attached fragment revisions are searched for the specified entries.
	*
	* <p>
	* This method takes into account that the "contents" of this
	* bundle wiring can have attached fragments. This "bundle space"
	* is not a namespace with unique members; the same entry name can be
	* present multiple times. This method therefore returns a list of URL
	* objects. These URLs can come from different JARs but have the same path
	* name. This method can either return only entries in the specified path or
	* recurse into subdirectories returning entries in the directory tree
	* beginning at the specified path.
	*
	* <p>
	* Note: Jar and zip files are not required to include directory entries.
	* URLs to directory entries will not be returned if the bundle contents do
	* not contain directory entries.
	*
	* @param path The path name in which to look. The path is always relative
	* to the root of this bundle wiring and may begin with
	* "/". A path value of "/" indicates the root of
	* this bundle wiring.
	* @param filePattern The file name pattern for selecting entries in the
	* specified path. The pattern is only matched against the last
	* element of the entry path. If the entry is a directory then the
	* trailing "/" is not used for pattern matching. Substring
	* matching is supported, as specified in the Filter specification,
	* using the wildcard character ("*"). If {@code null} is
	* specified, this is equivalent to "*" and matches all
	* files.
	* @param options The options for listing resource names. See
	* {@link #FINDENTRIES_RECURSE}. The method must ignore unrecognized
	* options.
	* @return An unmodifiable list of URL objects for each matching entry, or
	* an empty list if no matching entry could not be found or if the
	* caller does not have the appropriate
	* {@code AdminPermission[bundle,RESOURCE]} and the Java Runtime
	* Environment supports permissions. The list is ordered such that
	* entries from the {@link #getBundleRevision() bundle revision} are
	* returned first followed by the entries from
	* {@link #getFragmentRevisions() attached fragment revisions} in
	* attachment order. If this bundle wiring is not {@link #isInUse()
	* in use}, {@code null} must be returned.
	* @see Bundle#findEntries(String, String, boolean)
	*/
	List<URL> findEntries(String path, String filePattern, int options);

	/**
	* The find entries operation must recurse into subdirectories.
	*
	* <p>
	* This bit may be set when calling
	* {@link #findEntries(String, String, int)} to specify the result must
	* include the matching entries from the specified path and its
	* subdirectories. If this bit is not set, then the result must only include
	* matching entries from the specified path.
	*
	* @see #findEntries(String, String, int)
	*/
	int FINDENTRIES_RECURSE = 0x00000001;

	/**
	* Returns the names of resources visible to this bundle wiring's
	* {@link #getClassLoader() class loader}. The returned names can be used to
	* access the resources via this bundle wiring's class loader.
	*
	* <ul>
	* <li>Only the resource names for resources in bundle wirings will be
	* returned. The names of resources visible to a bundle wiring's parent
	* class loader, such as the bootstrap class loader, must not be included in
	* the result.
	* <li>Only established wires will be examined for resources. This method
	* must not cause new wires for dynamic imports to be established.
	* </ul>
	*
	* @param path The path name in which to look. The path is always relative
	* to the root of this bundle wiring's class loader and may begin
	* with "/". A path value of "/" indicates the
	* root of this bundle wiring's class loader.
	* @param filePattern The file name pattern for selecting resource names in
	* the specified path. The pattern is only matched against the last
	* element of the resource path. If the resource is a directory then
	* the trailing "/" is not used for pattern matching.
	* Substring matching is supported, as specified in the Filter
	* specification, using the wildcard character ("*"). If
	* {@code null} is specified, this is equivalent to "*" and
	* matches all files.
	* @param options The options for listing resource names. See
	* {@link #LISTRESOURCES_LOCAL} and {@link #LISTRESOURCES_RECURSE}.
	* This method must ignore unrecognized options.
	* @return An unmodifiable collection of resource names for each matching
	* resource, or an empty collection if no matching resource could
	* not be found or if the caller does not have the appropriate
	* {@code AdminPermission[bundle,RESOURCE]} and the Java Runtime
	* Environment supports permissions. The collection is unordered and
	* must contain no duplicate resource names. If this bundle wiring
	* is not {@link #isInUse() in use}, {@code null} must be returned.
	*/
	Collection<String> listResources(String path, String filePattern,
	int options);

	/**
	* The list resource names operation must recurse into subdirectories.
	*
	* <p>
	* This bit may be set when calling
	* {@link #listResources(String, String, int)} to specify the result must
	* include the names of matching resources from the specified path and its
	* subdirectories. If this bit is not set, then the result must only include
	* names of matching resources from the specified path.
	*
	* @see #listResources(String, String, int)
	*/
	int LISTRESOURCES_RECURSE = 0x00000001;

	/**
	* The list resource names operation must limit the result to the names of
	* matching resources contained in this bundle wiring's
	* {@link #getBundleRevision() bundle revision} and its attached
	* {@link #getFragmentRevisions() fragment revisions}. The result must not
	* include resource names for resources in
	* {@link Capability#PACKAGE_CAPABILITY package} names which are
	* {@link #getRequiredCapabilities(String) imported} by this wiring.
	*
	* <p>
	* This bit may be set when calling
	* {@link #listResources(String, String, int)} to specify the result must
	* only include the names of matching resources contained in this bundle
	* wiring's bundle revision and its attached fragment revisions. If this bit
	* is not set, then the result must include the names of matching resources
	* reachable from this bundle wiring's class loader which may include the
	* names of matching resources contained in imported packages and required
	* bundles.
	*
	* @see #listResources(String, String, int)
	*/
	int LISTRESOURCES_LOCAL = 0x00000002;
	}