Attachment #198779 for bug #349618

Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.

Lines 403-408 Link Here

(-)src/org/eclipse/equinox/internal/region/hook/RegionResolverHookTests.java (+32 lines)
403	}	403	}
404		404
405	@Override	405	@Override
		406	public BundleRevision getResource() {
		407	return getRevision();
		408	}
		409
		410	@Override
406	public BundleRevision getRevision() {	411	public BundleRevision getRevision() {
407	return new StubBundleRevision(bundle(this.bundleSymbolicName));	412	return new StubBundleRevision(bundle(this.bundleSymbolicName));
408	}	413	}
Lines 481-486 Link Here
481	}	486	}
482		487
483	@Override	488	@Override
		489	public BundleRevision getResource() {
		490	return getRevision();
		491	}
		492
		493	@Override
484	public BundleRevision getRevision() {	494	public BundleRevision getRevision() {
485	return new StubBundleRevision(bundle(this.bundleSymbolicName));	495	return new StubBundleRevision(bundle(this.bundleSymbolicName));
486	}	496	}
Lines 543-548 Link Here
543	}	553	}
544		554
545	@Override	555	@Override
		556	public BundleRevision getResource() {
		557	return getRevision();
		558	}
		559
		560	@Override
546	public BundleRevision getRevision() {	561	public BundleRevision getRevision() {
547	return this.bundleRevision;	562	return this.bundleRevision;
548	}	563	}
Lines 552-557 Link Here
552	throw new UnsupportedOperationException();	567	throw new UnsupportedOperationException();
553	}	568	}
554		569
		570	@Override
		571	public boolean matches(Capability capability) {
		572	if (!(capability instanceof BundleCapability))
		573	return false;
		574	return matches((BundleCapability) capability);
		575	}
555	}	576	}
556		577
557	final class StubBundleRevision implements BundleRevision {	578	final class StubBundleRevision implements BundleRevision {
Lines 597-602 Link Here
597	throw new UnsupportedOperationException();	618	throw new UnsupportedOperationException();
598	}	619	}
599		620
		621	@SuppressWarnings({"cast", "unchecked", "rawtypes"})
		622	@Override
		623	public List<Capability> getCapabilities(String namespace) {
		624	return (List<Capability>) (List) getDeclaredCapabilities(namespace);
		625	}
		626
		627	@SuppressWarnings({"cast", "unchecked", "rawtypes"})
		628	@Override
		629	public List<Requirement> getRequirements(String namespace) {
		630	return (List<Requirement>) (List) getDeclaredRequirements(namespace);
		631	}
600	}	632	}
601		633
602	}	634	}

Lines 989-994 Link Here

(-).settings/.api_filters (+55 lines)
989	<message_argument value="org.osgi.framework.wiring.BundleCapability"/>	989	<message_argument value="org.osgi.framework.wiring.BundleCapability"/>
990	</message_arguments>	990	</message_arguments>
991	</filter>	991	</filter>
		992	<filter comment="Ignore osgi API." id="1211105284">
		993	<message_arguments>
		994	<message_argument value="getResource()"/>
		995	</message_arguments>
		996	</filter>
992	</resource>	997	</resource>
993	<resource path="osgi/src/org/osgi/framework/wiring/BundleRequirement.java" type="org.osgi.framework.wiring.BundleRequirement">	998	<resource path="osgi/src/org/osgi/framework/wiring/BundleRequirement.java" type="org.osgi.framework.wiring.BundleRequirement">
994	<filter comment="Ignore OSGi API" id="1110441988">	999	<filter comment="Ignore OSGi API" id="1110441988">
Lines 996-1001 Link Here
996	<message_argument value="org.osgi.framework.wiring.BundleRequirement"/>	1001	<message_argument value="org.osgi.framework.wiring.BundleRequirement"/>
997	</message_arguments>	1002	</message_arguments>
998	</filter>	1003	</filter>
		1004	<filter comment="Ignore osgi API." id="1211105284">
		1005	<message_arguments>
		1006	<message_argument value="getResource()"/>
		1007	</message_arguments>
		1008	</filter>
999	</resource>	1009	</resource>
1000	<resource path="osgi/src/org/osgi/framework/wiring/BundleRevision.java" type="org.osgi.framework.wiring.BundleRevision">	1010	<resource path="osgi/src/org/osgi/framework/wiring/BundleRevision.java" type="org.osgi.framework.wiring.BundleRevision">
1001	<filter comment="Ignore OSGi API" id="1110441988">	1011	<filter comment="Ignore OSGi API" id="1110441988">
Lines 1017-1022 Link Here
1017	<message_argument value="org.osgi.framework.wiring.BundleWire"/>	1027	<message_argument value="org.osgi.framework.wiring.BundleWire"/>
1018	</message_arguments>	1028	</message_arguments>
1019	</filter>	1029	</filter>
		1030	<filter comment="Ignore osgi API." id="1211105284">
		1031	<message_arguments>
		1032	<message_argument value="getProvider()"/>
		1033	</message_arguments>
		1034	</filter>
		1035	<filter comment="Ignore osgi API." id="1211105284">
		1036	<message_arguments>
		1037	<message_argument value="getRequirer()"/>
		1038	</message_arguments>
		1039	</filter>
1020	</resource>	1040	</resource>
1021	<resource path="osgi/src/org/osgi/framework/wiring/BundleWiring.java" type="org.osgi.framework.wiring.BundleWiring">	1041	<resource path="osgi/src/org/osgi/framework/wiring/BundleWiring.java" type="org.osgi.framework.wiring.BundleWiring">
1022	<filter comment="Ignore OSGi API" id="1110441988">	1042	<filter comment="Ignore OSGi API" id="1110441988">
Lines 1025-1030 Link Here
1025	</message_arguments>	1045	</message_arguments>
1026	</filter>	1046	</filter>
1027	</resource>	1047	</resource>
		1048	<resource path="osgi/src/org/osgi/framework/wiring/Capability.java" type="org.osgi.framework.wiring.Capability">
		1049	<filter comment="Ignore osgi API." id="1110441988">
		1050	<message_arguments>
		1051	<message_argument value="org.osgi.framework.wiring.Capability"/>
		1052	</message_arguments>
		1053	</filter>
		1054	</resource>
1028	<resource path="osgi/src/org/osgi/framework/wiring/FrameworkWiring.java" type="org.osgi.framework.wiring.FrameworkWiring">	1055	<resource path="osgi/src/org/osgi/framework/wiring/FrameworkWiring.java" type="org.osgi.framework.wiring.FrameworkWiring">
1029	<filter comment="Ignore OSGi API" id="1110441988">	1056	<filter comment="Ignore OSGi API" id="1110441988">
1030	<message_arguments>	1057	<message_arguments>
Lines 1032-1037 Link Here
1032	</message_arguments>	1059	</message_arguments>
1033	</filter>	1060	</filter>
1034	</resource>	1061	</resource>
		1062	<resource path="osgi/src/org/osgi/framework/wiring/Requirement.java" type="org.osgi.framework.wiring.Requirement">
		1063	<filter comment="Ignore osgi API." id="1110441988">
		1064	<message_arguments>
		1065	<message_argument value="org.osgi.framework.wiring.Requirement"/>
		1066	</message_arguments>
		1067	</filter>
		1068	</resource>
		1069	<resource path="osgi/src/org/osgi/framework/wiring/Resource.java" type="org.osgi.framework.wiring.Resource">
		1070	<filter comment="Ignore osgi API." id="1110441988">
		1071	<message_arguments>
		1072	<message_argument value="org.osgi.framework.wiring.Resource"/>
		1073	</message_arguments>
		1074	</filter>
		1075	</resource>
		1076	<resource path="osgi/src/org/osgi/framework/wiring/ResourceConstants.java" type="org.osgi.framework.wiring.ResourceConstants">
		1077	<filter comment="Ignore osgi API." id="1110441988">
		1078	<message_arguments>
		1079	<message_argument value="org.osgi.framework.wiring.ResourceConstants"/>
		1080	</message_arguments>
		1081	</filter>
		1082	</resource>
		1083	<resource path="osgi/src/org/osgi/framework/wiring/Wire.java" type="org.osgi.framework.wiring.Wire">
		1084	<filter comment="Ignore osgi API." id="1110441988">
		1085	<message_arguments>
		1086	<message_argument value="org.osgi.framework.wiring.Wire"/>
		1087	</message_arguments>
		1088	</filter>
		1089	</resource>
1035	<resource path="osgi/src/org/osgi/service/condpermadmin/ConditionalPermissionAdmin.java" type="org.osgi.service.condpermadmin.ConditionalPermissionAdmin">	1090	<resource path="osgi/src/org/osgi/service/condpermadmin/ConditionalPermissionAdmin.java" type="org.osgi.service.condpermadmin.ConditionalPermissionAdmin">
1036	<filter comment="Ignore OSGi API" id="403853384">	1091	<filter comment="Ignore OSGi API" id="403853384">
1037	<message_arguments>	1092	<message_arguments>

Lines 25-31 Link Here

(-)META-INF/MANIFEST.MF (-2 / +2 lines)
25	org.osgi.framework.hooks.service; version="1.1",	25	org.osgi.framework.hooks.service; version="1.1",
26	org.osgi.framework.hooks.weaving; version="1.0",	26	org.osgi.framework.hooks.weaving; version="1.0",
27	org.osgi.framework.startlevel; version="1.0",	27	org.osgi.framework.startlevel; version="1.0",
28	org.osgi.framework.wiring; version="1.0",	28	org.osgi.framework.wiring; version="1.1",
29	org.osgi.service.condpermadmin;version="1.1.1",	29	org.osgi.service.condpermadmin;version="1.1.1",
30	org.osgi.service.framework; version="1.0"; x-internal:=true,	30	org.osgi.service.framework; version="1.0"; x-internal:=true,
31	org.osgi.service.log; version="1.3",	31	org.osgi.service.log; version="1.3",
Lines 75-81 Link Here
75	Bundle-Description: %systemBundle	75	Bundle-Description: %systemBundle
76	Bundle-Copyright: %copyright	76	Bundle-Copyright: %copyright
77	Bundle-Vendor: %eclipse.org	77	Bundle-Vendor: %eclipse.org
78	Bundle-Version: 3.7.100.qualifier	78	Bundle-Version: 3.8.0.qualifier
79	Bundle-Localization: systembundle	79	Bundle-Localization: systembundle
80	Bundle-DocUrl: http://www.eclipse.org	80	Bundle-DocUrl: http://www.eclipse.org
81	Eclipse-ExtensibleAPI: true	81	Eclipse-ExtensibleAPI: true





import java.util.Map;


/**
 * A capability that has been declared from a {@link BundleRevision bundle
 * revision}.
 * 
 * @ThreadSafe
 * @noimplement
 * @version $Id: 6bbc1e645f927531d40fb245c95f5d26ad189db3 $
 */
public interface BundleCapability extends Capability{
	/**
	 * Returns the name space of this capability.
	 * 

	 * @return The bundle revision declaring this capability.
	 */
	BundleRevision getRevision();

	BundleRevision getResource();
}





import java.util.Map;


/**
 * A requirement that has been declared from a {@link BundleRevision bundle
 * revision}.
 * 
 * @ThreadSafe
 * @noimplement
 * @version $Id: 3ee254a3c0d5516b56affaa66544c892f3d522cb $
 */
public interface BundleRequirement extends Requirement{
	/**
	 * Returns the name space of this requirement.
	 * 

	BundleRevision getRevision();

	/**
	 * {@inheritDoc}
	 */
	BundleRevision getResource();

	/**
	 * Returns whether the specified capability matches this requirement.
	 * 
	 * @param capability The capability to match to this requirement.




 * 
 * @ThreadSafe
 * @noimplement
 * @version $Id: 2eb450f15fc9d4fe1b611dc55e2238b972b4c486 $
 */
public interface BundleRevision extends BundleReference, Resource {
	/**
	 * Returns the symbolic name for this bundle revision.
	 * 

	 * package wires required by a bundle wiring may change as the bundle wiring
	 * may dynamically import additional packages.
	 */
	String	PACKAGE_NAMESPACE	= ResourceConstants.WIRING_PACKAGE_NAMESPACE;

	/**
	 * Name space for bundle capabilities and requirements.

	 * {@link Constants#BUNDLE_MANIFESTVERSION Bundle-ManifestVersion}
	 * {@literal <} 2) must not provide a bundle capability.
	 */
	String	BUNDLE_NAMESPACE	= ResourceConstants.WIRING_BUNDLE_NAMESPACE;

	/**
	 * Name space for host capabilities and requirements.

	 * {@link Constants#BUNDLE_MANIFESTVERSION Bundle-ManifestVersion}
	 * {@literal <} 2) must not provide a host capability.
	 */
	String	HOST_NAMESPACE		= ResourceConstants.WIRING_HOST_NAMESPACE;

	/**
	 * Returns the special types of this bundle revision. The bundle revision





package org.osgi.framework.wiring;


/**
 * A wire connecting a {@link BundleCapability} to a {@link BundleRequirement}.
 * 
 * @ThreadSafe
 * @noimplement
 * @version $Id: aca8642cea91995d0b178129cba1131ed327c7e7 $
 */
public interface BundleWire extends Wire {
	/**
	 * Returns the {@link BundleCapability} for this wire.
	 * 

	 *         returned.
	 */
	BundleWiring getRequirerWiring();

	/**
	 * {@inheritDoc}
	 */
	BundleRevision getProvider();

	/**
	 * {@inheritDoc}
	 */
	BundleRevision getRequirer();
}




	 * <p>
	 * A bundle wiring for a non-fragment revision provides a subset of the
	 * declared capabilities from the bundle revision and all attached fragment
	 * revisions<sup>&#8224;</sup>. Not all declared capabilities may be provided since some may
	 * be discarded. For example, if a package is declared to be exported and
	 * import, only one is selected and the other is discarded.
	 * <p>
	 * A bundle wiring for a fragment revision with a symbolic name must 
	 * provide exactly one {@link ResourceConstants#IDENTITY_NAMESPACE identity} capability.
	 * <p>
	 * &#8224; The {@link ResourceConstants#IDENTITY_NAMESPACE identity} capability
	 * provided by attached fragment revisions must not be included in the capabilities of the 
	 * host bundle wiring.
	 * 
	 * @param namespace The name space of the capabilities to return or
	 *        {@code null} to return the capabilities from all name spaces.

	 *         {@link #isInUse() in use}, {@code null} will be returned. For a
	 *         given name space, the list contains the wires in the order the
	 *         capabilities were specified in the manifests of the
	 *         {@link #getRevision() bundle revision} and the attached fragments<sup>&#8224;</sup>
	 *         of this bundle wiring. There is no ordering defined between
	 *         capabilities in different name spaces.
	 */




/*
 * Copyright (c) OSGi Alliance (2010, 2011). 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.util.Map;

/**
 * A capability that has been declared from a {@link Resource}.
 * 
 * @ThreadSafe
 * @version $Id: f8bd10002691537806e4bc3cf08f3fce37510121 $
 */
public interface Capability {

	/**
	 * Returns the name space of this capability.
	 * 
	 * @return The name space of this capability.
	 */
	String getNamespace();

	/**
	 * Returns the directives of this capability. Only the following list of
	 * directives have semantic meaning in the returned {@link Map map} of
	 * directives:
	 * <ul>
	 * <li> {@link ResourceConstants#CAPABILITY_EFFECTIVE_DIRECTIVE effective}
	 * <li> {@link ResourceConstants#CAPABILITY_USES_DIRECTIVE uses}
	 * <li> {@link ResourceConstants#CAPABILITY_MANDATORY_DIRECTIVE mandatory} -
	 * only recognized for the
	 * {@link ResourceConstants#WIRING_BUNDLE_NAMESPACE osgi.wiring.bundle} and
	 * {@link ResourceConstants#WIRING_PACKAGE_NAMESPACE osgi.wiring.package}
	 * name spaces.
	 * <li> {@link ResourceConstants#CAPABILITY_EXCLUDE_DIRECTIVE exclude} -
	 * only recognized for the
	 * {@link ResourceConstants#WIRING_PACKAGE_NAMESPACE osgi.wiring.package}
	 * name space.
	 * <li> {@link ResourceConstants#CAPABILITY_INCLUDE_DIRECTIVE include} -
	 * only recognized for the
	 * {@link ResourceConstants#WIRING_PACKAGE_NAMESPACE osgi.wiring.package}
	 * name space.
	 * </ul>
	 * All other directive are considered extra user defined information that
	 * has no semantic meaning. OSGi Alliance reserves the right to extend the
	 * set of directives which have semantic meaning.
	 * 
	 * @return An unmodifiable map of directive names to directive values for
	 *         this capability, or an empty map if this capability has no
	 *         directives.
	 */
	Map<String, String> getDirectives();

	/**
	 * Returns the attributes of this capability.
	 * 
	 * @return An unmodifiable map of attribute names to attribute values for
	 *         this capability, or an empty map if this capability has no
	 *         attributes.
	 */
	Map<String, Object> getAttributes();

	/**
	 * The resource that declares this capability.
	 * 
	 * @return the resource
	 */
	Resource getResource();
}




/*
 * Copyright (c) OSGi Alliance (2010, 2011). 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.util.Map;

import org.osgi.framework.Constants;

/**
 * A requirement that has been declared from a {@link Resource} .
 * 
 * @ThreadSafe
 * @version $Id: 3a6b0afb063fa288c07b68e0de742af291f869cc $
 */
public interface Requirement {
	/**
	 * Returns the name space of this requirement.
	 * 
	 * @return The name space of this requirement.
	 */
	String getNamespace();

	/**
	 * Returns the directives of this requirement. Only the following list of
	 * directives have semantic meaning in the returned {@link Map map} of
	 * directives:
	 * <ul>
	 * <li> {@link ResourceConstants#REQUIREMENT_EFFECTIVE_DIRECTIVE effective}
	 * <li> {@link ResourceConstants#REQUIREMENT_FILTER_DIRECTIVE filter}
	 * <li> {@link ResourceConstants#REQUIREMENT_CARDINALITY_DIRECTIVE
	 * cardinality}
	 * <li> {@link ResourceConstants#REQUIREMENT_RESOLUTION_DIRECTIVE resolution}
	 * <li> {@link ResourceConstants#REQUIREMENT_VISIBILITY_DIRECTIVE visibility}
	 * - only recognized for the
	 * {@link ResourceConstants#WIRING_BUNDLE_NAMESPACE osgi.wiring.bundle} name
	 * space.
	 * </ul>
	 * All other directive are considered extra user defined information that
	 * has no semantic meaning. OSGi Alliance reserves the right to extend the
	 * set of directives which have semantic meaning.
	 * 
	 * @return An unmodifiable map of directive names to directive values for
	 *         this requirement, or an empty map if this requirement has no
	 *         directives.
	 */
	Map<String, String> getDirectives();

	/**
	 * Returns the attributes of this requirement. Requirement attributes have
	 * no semantic meaning and are considered extra user defined information.
	 * 
	 * @return An unmodifiable map of attribute names to attribute values for
	 *         this requirement, or an empty map if this requirement has no
	 *         attributes.
	 */
	Map<String, Object> getAttributes();

	/**
	 * Returns the resource declaring this requirement. If there is no resource
	 * declaring this requirement, {@code null} is returned.
	 * 
	 * @return The resource declaring this requirement, if any.
	 */
	Resource getResource();

	/**
	 * Returns whether the specified capability matches this requirement. A
	 * capability matches this requirement when all of the following are true:
	 * <ul>
	 * <li>The specified capability has the same {@link #getNamespace() name
	 * space} as this requirement.
	 * <li>The filter specified by the {@link Constants#FILTER_DIRECTIVE filter}
	 * directive of this requirement matches the
	 * {@link Capability#getAttributes() attributes of the specified capability}.
	 * <li>The {@link #getDirectives() requirement directives} and the
	 * {@link Capability#getDirectives() capability directives} that apply to
	 * the name space are satisfied.
	 * </ul>
	 * 
	 * 
	 * @param capability
	 *            The capability to match to this requirement.
	 * @return {@code true} if the specified capability matches this this
	 *         requirement. {@link #getNamespace() name space} as this
	 *         requirement and the filter for this requirement matches the
	 *         {@link BundleCapability#getAttributes() attributes of the
	 *         specified capability}; {@code false} otherwise.
	 */
	// TODO much debate on the placement and need for this method.
	boolean matches(Capability capability);
}




package org.osgi.framework.wiring;

import java.util.List;


/**
 * A resource is the representation of a uniquely identified and typed data.
 * 
 * A resources can be wired together via capabilities and requirements.
 * 
 * TODO decide on identity characteristics of a revision. Given in OSGi multiple
 * bundles can be installed with same bsn/version this cannot be used as a key.
 * 
 * What then is identity of a resource? Object identity? URI (needs getter
 * method?)
 * 
 * @ThreadSafe
 * @version $Id: ec3a00454c760f49059b1890f5212e528e65926e $
 */
public interface Resource {
	/**
	 * Returns the capabilities declared by this resource.
	 * 
	 * @param namespace
	 *            The name space of the declared capabilities to return or
	 *            {@code null} to return the declared capabilities from all name
	 *            spaces.
	 * @return A list containing a snapshot of the declared {@link Capability}s,
	 *         or an empty list if this resource declares no capabilities in the
	 *         specified name space.
	 */
	List<Capability> getCapabilities(String namespace);

	/**
	 * Returns the requirements declared by this bundle resource.
	 * 
	 * @param namespace
	 *            The name space of the declared requirements to return or
	 *            {@code null} to return the declared requirements from all name
	 *            spaces.
	 * @return A list containing a snapshot of the declared {@link Requirement}
	 *         s, or an empty list if this resource declares no requirements in
	 *         the specified name space.
	 */
	List<Requirement> getRequirements(String namespace);
}




/*
 * Copyright (c) OSGi Alliance (2011). 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 org.osgi.framework.Constants;
import org.osgi.framework.Version;

/**
 * Defines standard names for the attributes, directives and name spaces for
 * resources, capabilities and requirements.
 * 
 * <p>
 * The values associated with these keys are of type {@code String}, unless
 * otherwise indicated.
 * 
 * @version $Id: 6a0df41f82a587eb72c0c513fdd0411f18564586 $
 */
public final class ResourceConstants {

	private ResourceConstants() {
		// keep others from creating objects of this type.
	}

	/**
	 * Name space for the identity capability.  Each {@link Resource resource} 
	 * provides exactly one<sup>&#8224;</sup> identity capability that can be 
	 * used to identify the resource.
	 * 
	 * For identity capability attributes the following applies:
	 * <ul>
	 * <li>The
	 * <q>osgi.identity</q> attribute contains the symbolic name of the
	 * resource.
	 * <li>The {@link #IDENTITY_VERSION_ATTRIBUTE version} attribute contains
	 * the {@link Version} of the resource.
	 * <li>The {@link #IDENTITY_TYPE_ATTRIBUTE type} attribute contains the
	 * resource type.
	 * </ul>
	 * <p>
	 * A resource with a symbolic name 
	 * {@link Resource#getCapabilities(String) provides} exactly one 
	 * <sup>&#8224;</sup> identity
	 * {@link Resource#getCapabilities(String) capability}.
	 * <p>
	 * For a {@link BundleRevision revision} with a symbolic name the 
	 * {@link BundleWiring wiring} for the revision
	 * {@link BundleWiring#getCapabilities(String) provides} exactly
	 * one<sup>&#8224;</sup> identity capability. 
	 * <p>
	 * &#8224; A resource with no symbolic name must not provide an identity
	 * capability.
	 */
	public static final String IDENTITY_NAMESPACE = "osgi.identity";

	/**
	 * An {@link #IDENTITY_NAMESPACE identity} capability attribute identifying the
	 * {@link Version version} of the resource.  This attribute must be set to a value of
	 * type {@link Version}.  If the resource has no version then the value 
	 * {@link Version#emptyVersion 0.0.0} must be used for the attribute.
	 */
	public static final String IDENTITY_VERSION_ATTRIBUTE = Constants.VERSION_ATTRIBUTE;

	/**
	 * An {@link #IDENTITY_NAMESPACE identity} capability attribute identifying the
	 * resource type.  This attribute must be set to a value of type {@link String}.
	 * if the resource has no type then the value 
	 * {@link ResourceConstants#IDENTITY_TYPE_UNKNOWN unknown} must be used for the
	 * attribute.
	 */
	public static final String IDENTITY_TYPE_ATTRIBUTE = "type";

	/**
	 * An {@link #IDENTITY_NAMESPACE identity} capability {@link #IDENTITY_TYPE_ATTRIBUTE type}
	 * attribute value identifying the resource type as an OSGi bundle.
	 */
	public static final String IDENTITY_TYPE_BUNDLE = "osgi.bundle";

	/**
	 * An {@link #IDENTITY_NAMESPACE identity} capability {@link #IDENTITY_TYPE_ATTRIBUTE type}
	 * attribute value identifying the resource type as an OSGi fragment.
	 */
	public static final String IDENTITY_TYPE_FRAGMENT = "osgi.fragment";

	/**
	 * An {@link #IDENTITY_NAMESPACE identity} capability {@link #IDENTITY_TYPE_ATTRIBUTE type}
	 * attribute value identifying the resource type as unknown.
	 */
	public static final String IDENTITY_TYPE_UNKNOWN = "unknown";

	/**
	 * An {@link #IDENTITY_NAMESPACE identity} capability {@link Requirement#getDirectives() directive}
	 * identifying if the resource is a singleton.  A {@link String} value of &quot;true&quot; indicates
	 * the resource is a singleton; any other value or <code>null</code> indicates the resource is not a 
	 * singleton.
	 */
	public static final String IDENTITY_SINGLETON_DIRECTIVE = Constants.SINGLETON_DIRECTIVE;

	/**
	 * Name space for package capabilities and requirements.
	 * 
	 * For capability attributes the following applies:
	 * <ul>
	 * <li>The
	 * <q>osgi.wiring.package</q> attribute contains the name of the package.
	 * <li>The {@link Constants#VERSION_ATTRIBUTE version} attribute contains
	 * the the {@link Version} of the package if one is specified or
	 * {@link Version#emptyVersion} if not specified.
	 * <li>The {@link Constants#BUNDLE_SYMBOLICNAME_ATTRIBUTE
	 * bundle-symbolic-name} attribute contains the symbolic name of the
	 * resource providing the package if one is specified.
	 * <li>The {@link Constants#BUNDLE_VERSION_ATTRIBUTE bundle-version}
	 * attribute contains the {@link Version} of resource providing the package
	 * if one is specified or {@link Version#emptyVersion} if not specified.
	 * <li>All other attributes are of type {@link String} and are used as
	 * arbitrary matching attributes for the capability.
	 * </ul>
	 * <p>
	 * A resource provides zero or more package
	 * {@link Resource#getCapabilities(String) capabilities} (this is, exported
	 * packages) and requires zero or more package
	 * {@link Resource#getRequirements(String) requirements} (that is, imported
	 * packages).
	 */
	public static final String WIRING_PACKAGE_NAMESPACE = "osgi.wiring.package";

	/**
	 * Name space for bundle capabilities and requirements.
	 * 
	 * For capability attributes the following applies:
	 * <ul>
	 * <li>The
	 * <q>osgi.wiring.bundle</q> attribute contains the symbolic name of the
	 * bundle.
	 * <li>The {@link Constants#BUNDLE_VERSION_ATTRIBUTE bundle-version}
	 * attribute contains the {@link Version} of the bundle if one is specified
	 * or {@link Version#emptyVersion} if not specified.
	 * <li>All other attributes are of type {@link String} and are used as
	 * arbitrary matching attributes for the capability.
	 * </ul>
	 * <p>
	 * A non-fragment resource with the {@link #IDENTITY_TYPE_BUNDLE
	 * osgi.bundle} type {@link #IDENTITY_TYPE_ATTRIBUTE identity} provides 
	 * exactly one <sup>&#8224;</sup> bundle
	 * {@link Resource#getCapabilities(String) capability} (that is, the bundle
	 * can be required by another bundle). A fragment resource with the 
	 * {@link #IDENTITY_TYPE_FRAGMENT osgi.fragment} type 
	 * {@link #IDENTITY_TYPE_ATTRIBUTE identity} must not declare
	 * a bundle capability. A resource requires zero or more bundle
	 * {@link Resource#getRequirements(String) requirements} (that is, required
	 * bundles).
	 * <p>
	 * &#8224; A resource with no symbolic name must not provide a bundle
	 * capability.
	 */
	public static final String WIRING_BUNDLE_NAMESPACE = "osgi.wiring.bundle";

	/**
	 * Name space for host capabilities and requirements.
	 * 
	 * For capability attributes the following applies:
	 * <ul>
	 * <li>The
	 * <q>osgi.wiring.host</q> attribute contains the symbolic name of the
	 * bundle.
	 * <li>The {@link Constants#BUNDLE_VERSION_ATTRIBUTE bundle-version}
	 * attribute contains the {@link Version} of the bundle if one is specified
	 * or {@link Version#emptyVersion} if not specified.
	 * <li>All other attributes are of type {@link String} and are used as
	 * arbitrary matching attributes for the capability.
	 * </ul>
	 * <p>
	 * <p>
	 * A non-fragment resource with the with the {@link #IDENTITY_TYPE_BUNDLE
	 * osgi.bundle} type {@link #IDENTITY_TYPE_ATTRIBUTE identity} provides 
	 * zero or one <sup>&#8224;</sup> host
	 * {@link Resource#getCapabilities(String) capabilities}. 
	 * A fragment resource with the 
	 * {@link #IDENTITY_TYPE_FRAGMENT osgi.fragment} type 
	 * {@link #IDENTITY_TYPE_ATTRIBUTE identity} must not declare
	 * a host capability and must 
	 * {@link Resource#getRequirements(String) declare} exactly one host
	 * requirement.
	 * <p>
	 * &#8224; A resource with no bundle symbolic name must not provide a host
	 * capability.
	 */
	public static final String WIRING_HOST_NAMESPACE = "osgi.wiring.host";

	/**
	 * A requirement {@link Requirement#getDirectives() directive} used to
	 * specify a capability filter. This filter is used to match against a
	 * capability's {@link Capability#getAttributes() attributes}.
	 */
	public final static String REQUIREMENT_FILTER_DIRECTIVE = Constants.FILTER_DIRECTIVE;

	/**
	 * A requirement {@link Requirement#getDirectives() directive} used to
	 * specify the resolution type for a requirement. The default value is
	 * {@link #REQUIREMENT_RESOLUTION_MANDATORY mandatory}.
	 * 
	 * @see #REQUIREMENT_RESOLUTION_MANDATORY mandatory
	 * @see #REQUIREMENT_RESOLUTION_OPTIONAL optional
	 */
	public final static String REQUIREMENT_RESOLUTION_DIRECTIVE = Constants.RESOLUTION_DIRECTIVE;
	/**
	 * A directive value identifying a mandatory
	 * {@link Resource#getRequirements(String) requirement} resolution type. A
	 * mandatory resolution type indicates that the requirement must be resolved
	 * when the {@link Resource resource} is resolved. If such requirement
	 * cannot be resolved, the resource fails to resolve.
	 * 
	 * @see #REQUIREMENT_RESOLUTION_DIRECTIVE
	 */
	public final static String REQUIREMENT_RESOLUTION_MANDATORY = Constants.RESOLUTION_MANDATORY;

	/**
	 * A directive value identifying an optional
	 * {@link Resource#getRequirements(String) requirement} resolution type. An
	 * optional resolution type indicates that the requirement is optional and
	 * the {@link Resource resource} may be resolved without requirement being
	 * resolved.
	 * 
	 * @see #REQUIREMENT_RESOLUTION_DIRECTIVE
	 */
	public final static String REQUIREMENT_RESOLUTION_OPTIONAL = Constants.RESOLUTION_OPTIONAL;

	/**
	 * A requirement {@link Requirement#getDirectives() directive} used to
	 * specify the effective time for the requirement. The default value is
	 * {@link #EFFECTIVE_RESOLVE resolve}.
	 * 
	 * @see #EFFECTIVE_RESOLVE resolve
	 * @see #EFFECTIVE_ACTIVE active
	 */
	public final static String REQUIREMENT_EFFECTIVE_DIRECTIVE = Constants.EFFECTIVE_DIRECTIVE;

	/**
	 * A directive value identifying a {@link #CAPABILITY_EFFECTIVE_DIRECTIVE
	 * capability} or {@link #REQUIREMENT_EFFECTIVE_DIRECTIVE requirement} that
	 * is effective at resolve time. Capabilities and requirements with an
	 * effective time of resolve are the only capabilities which are processed
	 * while resolving a resource.
	 * 
	 * @see #REQUIREMENT_EFFECTIVE_DIRECTIVE
	 * @see #CAPABILITY_EFFECTIVE_DIRECTIVE
	 */
	public final static String EFFECTIVE_RESOLVE = Constants.EFFECTIVE_RESOLVE;

	/**
	 * A directive value identifying a {@link #CAPABILITY_EFFECTIVE_DIRECTIVE
	 * capability} or {@link #REQUIREMENT_EFFECTIVE_DIRECTIVE requirement} that
	 * is effective at active time. Capabilities and requirements with an
	 * effective time of active are ignored while resolving a resource.
	 * 
	 * @see #REQUIREMENT_EFFECTIVE_DIRECTIVE
	 * @see #CAPABILITY_EFFECTIVE_DIRECTIVE
	 */
	public final static String EFFECTIVE_ACTIVE = Constants.EFFECTIVE_ACTIVE;

	/**
	 * A requirement {@link Requirement#getDirectives() directive} used to
	 * specify the visibility type for a requirement. The default value is
	 * {@link #REQUIREMENT_VISIBILITY_PRIVATE private}. This directive must only
	 * be used for requirements with the require
	 * {@link #WIRING_BUNDLE_NAMESPACE bundle} name space.
	 * 
	 * @see #REQUIREMENT_VISIBILITY_PRIVATE private
	 * @see #REQUIREMENT_VISIBILITY_REEXPORT reexport
	 */
	public final static String REQUIREMENT_VISIBILITY_DIRECTIVE = Constants.VISIBILITY_DIRECTIVE;

	/**
	 * A directive value identifying a private
	 * {@link #REQUIREMENT_VISIBILITY_DIRECTIVE visibility} type. A private
	 * visibility type indicates that any {@link #WIRING_PACKAGE_NAMESPACE
	 * packages} that are exported by the required
	 * {@link #WIRING_BUNDLE_NAMESPACE bundle} are not made visible on the
	 * export signature of the requiring {@link #WIRING_BUNDLE_NAMESPACE bundle}
	 * .
	 * 
	 * @see #REQUIREMENT_VISIBILITY_DIRECTIVE
	 */
	public final static String REQUIREMENT_VISIBILITY_PRIVATE = Constants.VISIBILITY_PRIVATE;

	/**
	 * A directive value identifying a reexport
	 * {@link #REQUIREMENT_VISIBILITY_DIRECTIVE visibility} type. A reexport
	 * visibility type indicates any {@link #WIRING_PACKAGE_NAMESPACE packages}
	 * that are exported by the required {@link #WIRING_BUNDLE_NAMESPACE bundle}
	 * are re-exported by the requiring {@link #WIRING_BUNDLE_NAMESPACE bundle}.
	 */
	public final static String REQUIREMENT_VISIBILITY_REEXPORT = Constants.VISIBILITY_REEXPORT;
	
	/**
	 * A requirement {@link Requirement#getDirectives() directive} used to
	 * specify the cardinality for a requirement. The default value is
	 * {@link #REQUIREMENT_CARDINALITY_SINGULAR singular}.
	 * 
	 * @see #REQUIREMENT_CARDINALITY_MULTIPLE multiple
	 * @see #REQUIREMENT_CARDINALITY_SINGULAR singular
	 */
	public final static String REQUIREMENT_CARDINALITY_DIRECTIVE = "cardinality";
	  
	/**
	 * A directive value identifying a multiple
	 * {@link #REQUIREMENT_CARDINALITY_DIRECTIVE cardinality} type.
	 */
	public final static String REQUIREMENT_CARDINALITY_MULTIPLE = "multiple";
	  
	/**
	 * A directive value identifying a singular
	 * {@link #REQUIREMENT_CARDINALITY_DIRECTIVE cardinality} type.
	 */
	public final static String REQUIREMENT_CARDINALITY_SINGULAR = "singular";


	/**
	 * A capability {@link Capability#getDirectives() directive} used to specify
	 * the comma separated list of {@link #WIRING_PACKAGE_NAMESPACE package}
	 * names a capability uses.
	 */
	public final static String CAPABILITY_USES_DIRECTIVE = Constants.USES_DIRECTIVE;

	/**
	 * A capability {@link Capability#getDirectives() directive} used to specify
	 * the effective time for the capability. The default value is
	 * {@link #EFFECTIVE_RESOLVE resolve}.
	 * 
	 * @see #EFFECTIVE_RESOLVE resolve
	 * @see #EFFECTIVE_ACTIVE active
	 */
	public final static String CAPABILITY_EFFECTIVE_DIRECTIVE = Constants.EFFECTIVE_DIRECTIVE;

	/**
	 * A capability {@link Capability#getDirectives() directive} used to specify
	 * the comma separated list of mandatory attributes which must be specified
	 * in the {@link #REQUIREMENT_FILTER_DIRECTIVE filter} of a requirement in
	 * order for the capability to match the requirement. This directive must
	 * only be used for capabilities with the {@link #WIRING_PACKAGE_NAMESPACE
	 * package} name space.
	 */
	public final static String CAPABILITY_MANDATORY_DIRECTIVE = "mandatory";

	/**
	 * A capability {@link Capability#getDirectives() directive} used to specify
	 * the comma separated list of classes which must be allowed to be exported.
	 * This directive must only be used for capabilities with the
	 * {@link #WIRING_PACKAGE_NAMESPACE package} name space.
	 */
	public final static String CAPABILITY_INCLUDE_DIRECTIVE = "include";

	/**
	 * A capability {@link Capability#getDirectives() directive} used to specify
	 * the comma separated list of classes which must not be allowed to be
	 * exported. This directive must only be used for capabilities with the
	 * {@link #WIRING_PACKAGE_NAMESPACE package} name space.
	 */
	public final static String CAPABILITY_EXCLUDE_DIRECTIVE = "exclude";	
}




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

/**
 * A wire connecting a {@link Capability} to a {@link Requirement}.
 * 
 * @ThreadSafe
 * @version $Id: 328ede0f8ddf3795594a8e0fc2cb11bbe7fa38fc $
 */
public interface Wire {
	/**
	 * Returns the {@link Capability} for this wire.
	 * 
	 * @return The {@link Capability} for this wire.
	 */
	Capability getCapability();

	/**
	 * Return the {@link Requirement} for this wire.
	 * 
	 * @return The {@link Requirement} for this wire.
	 */
	Requirement getRequirement();

	/**
	 * Return the providing {@link Resource resource} of the {@link #getCapability() capability}.
	 * <p>
	 * The resource returned may differ from the resource referenced by the {@link #getCapability()
	 * capability}.
	 * @return the providing {@link Resource resource}.
	 */
	Resource getProvider();

	/**
	 * Return the requiring {@link Resource resource} of the {@link #getRequirement() requirement}.
	 * <p>
	 * The resource returned my differ from the resource referenced by the {@link #getRequirement()
	 * requirement}
	 * @return the requiring {@link Resource resource}.
	 */
	Resource getRequirer();
}

Lines 16-21 Link Here

(-)resolver/src/org/eclipse/osgi/internal/module/ResolverBundle.java (-6 / +20 lines)
16	import org.eclipse.osgi.internal.resolver.GenericDescriptionImpl;	16	import org.eclipse.osgi.internal.resolver.GenericDescriptionImpl;
17	import org.eclipse.osgi.service.resolver.*;	17	import org.eclipse.osgi.service.resolver.*;
18	import org.osgi.framework.Constants;	18	import org.osgi.framework.Constants;
		19	import org.osgi.framework.wiring.ResourceConstants;
19		20
20	/*	21	/*
21	* A companion to BundleDescription from the state used while resolving.	22	* A companion to BundleDescription from the state used while resolving.
Lines 62-68 Link Here
62	imports = new ResolverImport[0];	63	imports = new ResolverImport[0];
63	requires = new BundleConstraint[0];	64	requires = new BundleConstraint[0];
64	genericReqiures = new GenericConstraint[0];	65	genericReqiures = new GenericConstraint[0];
65	genericCapabilities = new GenericCapability[0];	66	GenericDescription[] capabilities = getBundleDescription().getGenericCapabilities();
		67	GenericCapability identity = null;
		68	for (GenericDescription capability : capabilities) {
		69	if (ResourceConstants.IDENTITY_NAMESPACE.equals(capability.getType())) {
		70	identity = new GenericCapability(this, capability);
		71	break;
		72	}
		73	}
		74
		75	genericCapabilities = identity == null ? new GenericCapability[0] : new GenericCapability[] {identity};
66	return;	76	return;
67	}	77	}
68		78
Lines 311-318 Link Here
311	return; // do not allow fragments with conflicting constraints	321	return; // do not allow fragments with conflicting constraints
312	if (isResolved() && newExports.length > 0)	322	if (isResolved() && newExports.length > 0)
313	fragment.setNewFragmentExports(true);	323	fragment.setNewFragmentExports(true);
314	if (isResolved() && newGenericCapabilities.length > 0)
315	fragment.setNewFragmentCapabilities(true);
316		324
317	initFragments();	325	initFragments();
318	// need to make sure there is not already another version of this fragment	326	// need to make sure there is not already another version of this fragment
Lines 371-380 Link Here
371	List<GenericCapability> hostCapabilities = new ArrayList<GenericCapability>(newGenericCapabilities.length);	379	List<GenericCapability> hostCapabilities = new ArrayList<GenericCapability>(newGenericCapabilities.length);
372	if (newGenericCapabilities.length > 0 && dynamicAttach) {	380	if (newGenericCapabilities.length > 0 && dynamicAttach) {
373	for (GenericDescription capability : newGenericCapabilities) {	381	for (GenericDescription capability : newGenericCapabilities) {
374	GenericDescription hostCapabililty = new GenericDescriptionImpl(getBundleDescription(), capability);	382	if (!ResourceConstants.IDENTITY_NAMESPACE.equals(capability.getType())) {
375	hostCapabilities.add(new GenericCapability(this, hostCapabililty));	383	GenericDescription hostCapabililty = new GenericDescriptionImpl(getBundleDescription(), capability);
		384	hostCapabilities.add(new GenericCapability(this, hostCapabililty));
		385	}
		386	}
		387	if (hostCapabilities.size() > 0) {
		388	fragmentGenericCapabilities.put(fragment.bundleID, hostCapabilities);
		389	if (isResolved())
		390	fragment.setNewFragmentCapabilities(true);
376	}	391	}
377	fragmentGenericCapabilities.put(fragment.bundleID, hostCapabilities);
378	}	392	}
379	if (dynamicAttach) {	393	if (dynamicAttach) {
380	resolver.getResolverExports().put(hostExports.toArray(new ResolverExport[hostExports.size()]));	394	resolver.getResolverExports().put(hostExports.toArray(new ResolverExport[hostExports.size()]));




		if (namespace == null)
			capabilities = Collections.EMPTY_LIST;
		else
			capabilities = name == null || name.indexOf('*') >= 0 ? namespace.getAllValues() : namespace.get(name);
		List<GenericCapability> candidates = new ArrayList<GenericCapability>(capabilities);
		List<BundleCapability> genCapabilities = new ArrayList<BundleCapability>(candidates.size());
		// Must remove candidates that do not match before calling hooks.

				result = true; // Wired to ourselves
				continue;
			}
			VersionSupplier[] capabilityHosts = capability.getResolverBundle().isFragment() ? capability.getResolverBundle().getHost().getPossibleSuppliers() : new ResolverBundle[] {capability.getResolverBundle()};
			boolean foundResolvedMatch = false;
			for (int i = 0; capabilityHosts != null && i < capabilityHosts.length; i++) {
				ResolverBundle capabilitySupplier = capabilityHosts[i].getResolverBundle();
				if (capabilitySupplier == constraint.getBundle()) {
					// the capability is from a fragment attached to this host do not recursively resolve the host again
					foundResolvedMatch = true;
					continue;
				}
				// if in dev mode then allow a constraint to resolve to an unresolved bundle
				if (capabilitySupplier.getState() == ResolverBundle.RESOLVED || (resolveBundle(capabilitySupplier, cycle) || developmentMode)) {
					foundResolvedMatch |= !capability.getResolverBundle().isFragment() ? true : capability.getResolverBundle().getHost().getPossibleSuppliers() != null;
					// Check cyclic dependencies
					if (capabilitySupplier.getState() == ResolverBundle.RESOLVING)
						if (!cycle.contains(capabilitySupplier))
							cycle.add(capabilitySupplier);
				}
			}
			if (!foundResolvedMatch) {
				constraint.removePossibleSupplier(capability);
				continue; // constraint hasn't resolved
			}

Lines 156-160 Link Here

(-)resolver/src/org/eclipse/osgi/internal/resolver/BaseDescriptionImpl.java (+4 lines)
156	public String toString() {	156	public String toString() {
157	return getNamespace() + BaseDescriptionImpl.toString(getAttributes(), false) + BaseDescriptionImpl.toString(getDirectives(), true);	157	return getNamespace() + BaseDescriptionImpl.toString(getAttributes(), false) + BaseDescriptionImpl.toString(getDirectives(), true);
158	}	158	}
		159
		160	public BundleRevision getResource() {
		161	return getRevision();
		162	}
159	}	163	}
160	}	164	}

Lines 1031-1036 Link Here

(-)resolver/src/org/eclipse/osgi/internal/resolver/BundleDescriptionImpl.java (-1 / +20 lines)
1031	public String toString() {	1031	public String toString() {
1032	return getRequirement() + " -> " + getCapability(); //$NON-NLS-1$	1032	return getRequirement() + " -> " + getCapability(); //$NON-NLS-1$
1033	}	1033	}
		1034
		1035	public BundleRevision getProvider() {
		1036	return getCapability().getRevision();
		1037	}
		1038
		1039	public BundleRevision getRequirer() {
		1040	return getRequirement().getRevision();
		1041	}
1034	}	1042	}
1035		1043
1036	// Note that description wiring are identity equality based	1044	// Note that description wiring are identity equality based
Lines 1093-1099 Link Here
1093	requirements.add(wire.getRequirement());	1101	requirements.add(wire.getRequirement());
1094	}	1102	}
1095	// get dynamic imports	1103	// get dynamic imports
1096	if (namespace == null \|\| BundleRevision.PACKAGE_NAMESPACE.equals(namespace)) {	1104	if (getHost() == null && (namespace == null \|\| BundleRevision.PACKAGE_NAMESPACE.equals(namespace))) {
		1105	// TODO need to handle fragments that add dynamic imports
1097	if (hasDynamicImports()) {	1106	if (hasDynamicImports()) {
1098	ImportPackageSpecification[] imports = getImportPackages();	1107	ImportPackageSpecification[] imports = getImportPackages();
1099	for (ImportPackageSpecification impPackage : imports) {	1108	for (ImportPackageSpecification impPackage : imports) {
Lines 1230-1233 Link Here
1230	return BundleDescriptionImpl.this.toString();	1239	return BundleDescriptionImpl.this.toString();
1231	}	1240	}
1232	}	1241	}
		1242
		1243	@SuppressWarnings({"cast", "unchecked", "rawtypes"})
		1244	public List<Capability> getCapabilities(String namespace) {
		1245	return (List<Capability>) (List) getDeclaredCapabilities(namespace);
		1246	}
		1247
		1248	@SuppressWarnings({"cast", "unchecked", "rawtypes"})
		1249	public List<Requirement> getRequirements(String namespace) {
		1250	return (List<Requirement>) (List) getDeclaredRequirements(namespace);
		1251	}
1233	}	1252	}




			}
		}
		String[] mandatory = (String[]) candidate.getDirective(Constants.MANDATORY_DIRECTIVE);
		if (!hasMandatoryAttributes(mandatory))
			return false;
		if (getName() != null && getName().equals(candidate.getSymbolicName()) && (getVersionRange() == null || getVersionRange().isIncluded(candidate.getVersion())))
			return true;
		return false;
	}

	@Override
	protected boolean hasMandatoryAttributes(String[] mandatory) {
		if (mandatory != null) {
			Map<String, ?> requiredAttrs = getAttributes();
			for (String key : mandatory) {
				if (Constants.BUNDLE_VERSION_ATTRIBUTE.equals(key))
					continue; // has a default value of 0.0.0

					return false;
			}
		}
		return true;
			return true;
		return false;
	}

	public String toString() {

Lines 57-62 Link Here

(-)resolver/src/org/eclipse/osgi/internal/resolver/GenericSpecificationImpl.java (+5 lines)
57	return matchingFilter == null \|\| matchingFilter.match(candidate.getAttributes());	57	return matchingFilter == null \|\| matchingFilter.match(candidate.getAttributes());
58	}	58	}
59		59
		60	@Override
		61	protected boolean hasMandatoryAttributes(String[] mandatory) {
		62	return true;
		63	}
		64
60	public String toString() {	65	public String toString() {
61	StringBuffer sb = new StringBuffer();	66	StringBuffer sb = new StringBuffer();
62	sb.append(Constants.REQUIRE_CAPABILITY).append(": ").append(getType()); //$NON-NLS-1$	67	sb.append(Constants.REQUIRE_CAPABILITY).append(": ").append(getType()); //$NON-NLS-1$




			}
		}
		String[] mandatory = (String[]) candidate.getDirective(Constants.MANDATORY_DIRECTIVE);
		if (!hasMandatoryAttributes(mandatory))
			return false;
				if (Constants.BUNDLE_VERSION_ATTRIBUTE.equals(key))
					continue; // has a default value of 0.0.0
				if (requiredAttrs == null || requiredAttrs.get(key) == null)
					return false;
			}
		}
		if (getName() != null && getName().equals(candidate.getSymbolicName()) && (getVersionRange() == null || getVersionRange().isIncluded(candidate.getVersion())))
			return true;
		return false;

		}
	}

	@Override
	protected boolean hasMandatoryAttributes(String[] mandatory) {
		if (mandatory != null) {
			Map<String, ?> requiredAttrs = getAttributes();
			for (String key : mandatory) {
				if (Constants.BUNDLE_VERSION_ATTRIBUTE.equals(key))
					continue; // has a default value of 0.0.0
				if (requiredAttrs == null || requiredAttrs.get(key) == null)
					return false;
			}
		}
		return true;
	}

	public boolean isResolved() {
		synchronized (this.monitor) {
			return hosts != null && hosts.length > 0;




			}
		}
		String[] mandatory = (String[]) pkgDes.getDirective(Constants.MANDATORY_DIRECTIVE);
		if (!hasMandatoryAttributes(mandatory))
			return false;
		// finally check the ee index
		if (((BundleDescriptionImpl) getBundle()).getEquinoxEE() < 0)
			return true;
		int eeIndex = ((Integer) pkgDes.getDirective(ExportPackageDescriptionImpl.EQUINOX_EE)).intValue();
		return eeIndex < 0 || eeIndex == ((BundleDescriptionImpl) getBundle()).getEquinoxEE();
	}

	@Override
	protected boolean hasMandatoryAttributes(String[] mandatory) {
		if (mandatory != null) {
			Map<String, ?> importAttrs = getAttributes();
			for (int i = 0; i < mandatory.length; i++) {
				if (Constants.BUNDLE_SYMBOLICNAME_ATTRIBUTE.equals(mandatory[i])) {
					if (getBundleSymbolicName() == null)
						return false;
				} else if (Constants.BUNDLE_VERSION_ATTRIBUTE.equals(mandatory[i])) {
					if (bundleVersionRange == null)

				}
			}
		}
		return true;
		if (((BundleDescriptionImpl) getBundle()).getEquinoxEE() < 0)
			return true;
		int eeIndex = ((Integer) pkgDes.getDirective(ExportPackageDescriptionImpl.EQUINOX_EE)).intValue();
		return eeIndex < 0 || eeIndex == ((BundleDescriptionImpl) getBundle()).getEquinoxEE();
	}

	protected void setBundleSymbolicName(String symbolicName) {

Lines 145-150 Link Here

(-)resolver/src/org/eclipse/osgi/internal/resolver/NativeCodeSpecificationImpl.java (+5 lines)
145	return match;	145	return match;
146	}	146	}
147		147
		148	@Override
		149	protected boolean hasMandatoryAttributes(String[] mandatory) {
		150	return true;
		151	}
		152
148	public String toString() {	153	public String toString() {
149	StringBuffer sb = new StringBuffer();	154	StringBuffer sb = new StringBuffer();
150	NativeCodeDescription[] suppliers = getPossibleSuppliers();	155	NativeCodeDescription[] suppliers = getPossibleSuppliers();




import org.eclipse.osgi.util.ManifestElement;
import org.eclipse.osgi.util.NLS;
import org.osgi.framework.*;
import org.osgi.framework.wiring.ResourceConstants;

/**
 * This class builds bundle description objects from manifests

		result.setGenericRequires(createGenericRequires(genericRequires, osgiRequires));
		ManifestElement[] genericCapabilities = getGenericCapabilities(manifest, genericAliases);
		ManifestElement[] osgiCapabilities = ManifestElement.parseHeader(Constants.PROVIDE_CAPABILITY, manifest.get(Constants.PROVIDE_CAPABILITY));
		result.setGenericCapabilities(createGenericCapabilities(genericCapabilities, osgiCapabilities, result));
		ManifestElement[] nativeCode = ManifestElement.parseHeader(Constants.BUNDLE_NATIVECODE, manifest.get(Constants.BUNDLE_NATIVECODE));
		result.setNativeCodeSpecification(createNativeCode(nativeCode));
		return result;

		return results;
	}

	private static GenericDescription[] createGenericCapabilities(ManifestElement[] equinoxCapabilities, ManifestElement[] osgiCapabilities, BundleDescription description) throws BundleException {
		List<GenericDescription> result = createEquinoxCapabilities(equinoxCapabilities);
		result = createOSGiCapabilities(osgiCapabilities, result, description);
		return result == null ? null : result.toArray(new GenericDescription[result.size()]);
	}

	private static List<GenericDescription> createOSGiCapabilities(ManifestElement[] osgiCapabilities, List<GenericDescription> result, BundleDescription description) throws BundleException {
		if (result == null)
			result = new ArrayList<GenericDescription>(osgiCapabilities == null ? 1 : osgiCapabilities.length + 1);
		// Always have an osgi.identity capability if there is a symbolic name.
		GenericDescription osgiIdentity = createOsgiIdentityCapability(description);
		if (osgiIdentity != null)
			// always add the capability to the front
			result.add(0, osgiIdentity);
		return createOSGiCapabilities(osgiCapabilities, result);
	}

	static List<GenericDescription> createOSGiCapabilities(ManifestElement[] osgiCapabilities, List<GenericDescription> result) throws BundleException {
		if (osgiCapabilities == null)
			return result;
		if (result == null)

			String[] namespaces = element.getValueComponents();
			types: for (String namespace : namespaces) {
				String effective = element.getDirective(Constants.EFFECTIVE_DIRECTIVE);
				// Any declared osgi.identity capability with an effective directive value of "resolve" will be overridden.
				if (effective != null && !Constants.EFFECTIVE_RESOLVE.equals(effective))
					break types; // ignore any namespace that is not effective at resolve time.
				if (ResourceConstants.IDENTITY_NAMESPACE.equals(namespace))
					throw new BundleException("A bundle is not allowed to define a capability in the " + ResourceConstants.IDENTITY_NAMESPACE + " name space."); //$NON-NLS-1$ //$NON-NLS-2$

				GenericDescriptionImpl desc = new GenericDescriptionImpl();
				desc.setType(namespace);
				Map<String, Object> mapAttrs = getAttributes(element, new String[0]);

		return result;
	}

	private static List<GenericDescription> createEquinoxCapabilities(ManifestElement[] equinoxCapabilities) throws BundleException {
		if (equinoxCapabilities == null)
			return null;
		ArrayList<GenericDescription> results = new ArrayList<GenericDescription>(equinoxCapabilities.length);

				if (colonIdx > 0) {
					name = genericNames[j].substring(0, colonIdx);
					desc.setType(genericNames[j].substring(colonIdx + 1));
					if (ResourceConstants.IDENTITY_NAMESPACE.equals(desc.getType()))
						throw new BundleException("A bundle is not allowed to define a capability in the " + ResourceConstants.IDENTITY_NAMESPACE + " name space."); //$NON-NLS-1$ //$NON-NLS-2$
				}
				Map<String, Object> mapAttrs = getAttributes(equinoxCapabilities[i], new String[] {Constants.VERSION_ATTRIBUTE});
				Dictionary<String, Object> attrs = mapAttrs == null ? new Hashtable<String, Object>() : new Hashtable<String, Object>(mapAttrs);

			throw new BundleException(message + " : " + NLS.bind(StateMsg.HEADER_EXTENSION_ERROR, hostName), BundleException.MANIFEST_ERROR); //$NON-NLS-1$
		}
	}

	private static GenericDescription createOsgiIdentityCapability(BundleDescription description) {
		if (description.getSymbolicName() == null)
			return null;
		GenericDescriptionImpl result = new GenericDescriptionImpl();
		result.setType(ResourceConstants.IDENTITY_NAMESPACE);
		Dictionary<String, Object> attributes = new Hashtable<String, Object>();
		attributes.put(ResourceConstants.IDENTITY_NAMESPACE, description.getSymbolicName());
		attributes.put(ResourceConstants.IDENTITY_TYPE_ATTRIBUTE, description.getHost() == null ? ResourceConstants.IDENTITY_TYPE_BUNDLE : ResourceConstants.IDENTITY_TYPE_FRAGMENT);
		attributes.put(ResourceConstants.IDENTITY_VERSION_ATTRIBUTE, description.getVersion());
		result.setAttributes(attributes);
		Map<String, String> directives = new HashMap<String, String>();
		directives.put(ResourceConstants.IDENTITY_SINGLETON_DIRECTIVE, String.valueOf(description.isSingleton()));
		// The effective directive should be resolve
		directives.put(ResourceConstants.CAPABILITY_EFFECTIVE_DIRECTIVE, ResourceConstants.EFFECTIVE_RESOLVE);
		result.setDirectives(directives);
		return result;
	}
}

Lines 871-877 Link Here

(-)resolver/src/org/eclipse/osgi/internal/resolver/StateImpl.java (-1 / +5 lines)
871	}	871	}
872		872
873	private void addSystemCapabilities(List<GenericDescription> capabilities, ManifestElement[] elements) {	873	private void addSystemCapabilities(List<GenericDescription> capabilities, ManifestElement[] elements) {
874	StateBuilder.createOSGiCapabilities(elements, capabilities);	874	try {
		875	StateBuilder.createOSGiCapabilities(elements, capabilities);
		876	} catch (BundleException e) {
		877	throw new RuntimeException("Unexpected exception adding system capabilities.", e); //$NON-NLS-1$
		878	}
875	}	879	}
876		880
877	@SuppressWarnings("rawtypes")	881	@SuppressWarnings("rawtypes")

Lines 17-23 Link Here

(-)resolver/src/org/eclipse/osgi/internal/resolver/VersionConstraintImpl.java (-1 / +24 lines)
17	import org.eclipse.osgi.framework.internal.core.Constants;	17	import org.eclipse.osgi.framework.internal.core.Constants;
18	import org.eclipse.osgi.internal.resolver.BaseDescriptionImpl.BaseCapability;	18	import org.eclipse.osgi.internal.resolver.BaseDescriptionImpl.BaseCapability;
19	import org.eclipse.osgi.service.resolver.*;	19	import org.eclipse.osgi.service.resolver.*;
20	import org.osgi.framework.Version;	20	import org.eclipse.osgi.util.ManifestElement;
		21	import org.osgi.framework.*;
21	import org.osgi.framework.wiring.*;	22	import org.osgi.framework.wiring.*;
22		23
23	abstract class VersionConstraintImpl implements VersionConstraint {	24	abstract class VersionConstraintImpl implements VersionConstraint {
Lines 101-106 Link Here
101		102
102	protected abstract Map<String, Object> getInteralAttributes();	103	protected abstract Map<String, Object> getInteralAttributes();
103		104
		105	protected abstract boolean hasMandatoryAttributes(String[] mandatory);
		106
104	public BundleRequirement getRequirement() {	107	public BundleRequirement getRequirement() {
105	String namespace = getInternalNameSpace();	108	String namespace = getInternalNameSpace();
106	if (namespace == null)	109	if (namespace == null)
Lines 156-161 Link Here
156	public String toString() {	159	public String toString() {
157	return getNamespace() + BaseDescriptionImpl.toString(getAttributes(), false) + BaseDescriptionImpl.toString(getDirectives(), true);	160	return getNamespace() + BaseDescriptionImpl.toString(getAttributes(), false) + BaseDescriptionImpl.toString(getDirectives(), true);
158	}	161	}
		162
		163	public boolean matches(Capability capability) {
		164	if (capability instanceof BundleCapability)
		165	return matches((BundleCapability) capability);
		166	// now we must do the generic thing
		167	String filterSpec = getDirectives().get(ResourceConstants.REQUIREMENT_FILTER_DIRECTIVE);
		168	boolean match;
		169	try {
		170	match = FrameworkUtil.createFilter(filterSpec).matches(capability.getAttributes());
		171	} catch (InvalidSyntaxException e) {
		172	return false;
		173	}
		174	if (!match)
		175	return false;
		176	return hasMandatoryAttributes(ManifestElement.getArrayFromList(capability.getDirectives().get(ResourceConstants.CAPABILITY_MANDATORY_DIRECTIVE)));
		177	}
		178
		179	public BundleRevision getResource() {
		180	return getRevision();
		181	}
159	}	182	}
160		183
161	static StringBuffer addFilterAttributes(StringBuffer filter, Map<String, ?> attributes) {	184	static StringBuffer addFilterAttributes(StringBuffer filter, Map<String, ?> attributes) {

Lines 111-116 Link Here

(-).classpath (+6 lines)
111	<classpathentry kind="src" output="bundle_tests/test.bug306181b" path="bundles_src/test.bug306181b"/>	111	<classpathentry kind="src" output="bundle_tests/test.bug306181b" path="bundles_src/test.bug306181b"/>
112	<classpathentry kind="src" output="bundle_tests/test.logging.a" path="bundles_src/test.logging.a"/>	112	<classpathentry kind="src" output="bundle_tests/test.logging.a" path="bundles_src/test.logging.a"/>
113	<classpathentry kind="src" output="bundle_tests/console.test" path="bundles_src/console.test"/>	113	<classpathentry kind="src" output="bundle_tests/console.test" path="bundles_src/console.test"/>
		114	<classpathentry kind="src" output="bundle_tests/resource.tb1" path="bundles_src/resource.tb1"/>
		115	<classpathentry kind="src" output="bundle_tests/resource.tb2" path="bundles_src/resource.tb2"/>
		116	<classpathentry kind="src" output="bundle_tests/resource.tf1" path="bundles_src/resource.tf1"/>
		117	<classpathentry kind="src" output="bundle_tests/resource.tf2" path="bundles_src/resource.tf2"/>
		118	<classpathentry kind="src" output="bundle_tests/resource.tb3" path="bundles_src/resource.tb3"/>
		119	<classpathentry kind="src" output="bundle_tests/resource.tb4" path="bundles_src/resource.tb4"/>
114	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/J2SE-1.4"/>	120	<classpathentry kind="con" path="org.eclipse.jdt.launching.JRE_CONTAINER/org.eclipse.jdt.internal.debug.ui.launcher.StandardVMType/J2SE-1.4"/>
115	<classpathentry kind="con" path="org.eclipse.pde.core.requiredPlugins"/>	121	<classpathentry kind="con" path="org.eclipse.pde.core.requiredPlugins"/>
116	<classpathentry kind="output" path="bin"/>	122	<classpathentry kind="output" path="bin"/>

Added Link Here

(-)bundles_src/resource.tb1/META-INF/MANIFEST.MF (+5 lines)
1	Manifest-Version: 1.0
2	Bundle-ManifestVersion: 2
3	Bundle-SymbolicName: resource.tb1
4	Bundle-Version: 1.0.0
5

Added Link Here

(-)bundles_src/resource.tb2/META-INF/MANIFEST.MF (+3 lines)
1	Manifest-Version: 1.0
2	Bundle-ManifestVersion: 1
3

Added Link Here

(-)bundles_src/resource.tb3/META-INF/MANIFEST.MF (+9 lines)
1	Manifest-Version: 1.0
2	Bundle-ManifestVersion: 2
3	Bundle-SymbolicName: resource.tb3
4	Bundle-Version: 1.0.0
5	Require-Capability: osgi.identity;
6	filter:=(&(osgi.identity=resource.tb1)(version=1.0.0)(type=osgi.bundle)),
7	osgi.identity;
8	filter:=(&(osgi.identity=resource.tf1)(version=1.0.0)(type=osgi.fragment))
9

Added Link Here

(-)bundles_src/resource.tb4/META-INF/MANIFEST.MF (+5 lines)
1	Manifest-Version: 1.0
2	Bundle-ManifestVersion: 2
3	Bundle-SymbolicName: resource.tb4
4	Bundle-Version: 1.0.0
5

Added Link Here

(-)bundles_src/resource.tf1/META-INF/MANIFEST.MF (+8 lines)
1	Manifest-Version: 1.0
2	Bundle-ManifestVersion: 2
3	Bundle-SymbolicName: resource.tf1
4	Bundle-Version: 1.0.0
5	Fragment-Host: resource.tb1
6	Require-Capability: osgi.identity;
7	filter:=(&(osgi.identity=resource.tb4)(version=1.0.0)(type=osgi.bundle))
8

Added Link Here

(-)bundles_src/resource.tf2/META-INF/MANIFEST.MF (+4 lines)
1	Manifest-Version: 1.0
2	Bundle-ManifestVersion: 1
3	Fragment-Host: resource.tb1
4

Lines 63-68 Link Here

(-)src/org/eclipse/osgi/tests/AutomatedTests.java (+1 lines)
63	suite.addTest(AllCompositeTests.suite());	63	suite.addTest(AllCompositeTests.suite());
64	suite.addTest(org.eclipse.osgi.tests.securityadmin.AllSecurityAdminTests.suite());	64	suite.addTest(org.eclipse.osgi.tests.securityadmin.AllSecurityAdminTests.suite());
65	suite.addTest(AllConsoleTests.suite());	65	suite.addTest(AllConsoleTests.suite());
		66	suite.addTest(org.eclipse.osgi.tests.resource.AllTests.suite());
66	return suite;	67	return suite;
67	}	68	}
68	}	69	}




/*******************************************************************************
 * Copyright (c) 2011 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 * 
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.osgi.tests.resource;

import org.eclipse.osgi.tests.OSGiTest;
import org.eclipse.osgi.tests.OSGiTestsActivator;
import org.eclipse.osgi.tests.bundles.BundleInstaller;
import org.osgi.framework.InvalidSyntaxException;

public abstract class AbstractResourceTest extends OSGiTest {
	protected BundleInstaller installer;

	public AbstractResourceTest() {
		super();
	}

	public AbstractResourceTest(String name) {
		super(name);
	}

	protected void setUp() throws Exception {
		super.setUp();
		try {
			installer = new BundleInstaller("bundle_tests", OSGiTestsActivator.getContext()); //$NON-NLS-1$
		} catch (InvalidSyntaxException e) {
			fail("Failed to create bundle installer", e); //$NON-NLS-1$
		}
	}

	protected void tearDown() throws Exception {
		installer.shutdown();
		super.tearDown();
	}
}




/*******************************************************************************
 * Copyright (c) 2011 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 * 
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.osgi.tests.resource;

import junit.framework.Test;
import junit.framework.TestSuite;

public class AllTests {
	public static Test suite() {
		TestSuite suite = new TestSuite(AllTests.class.getName());
		suite.addTest(IdentityTest.suite());
		return suite;
	}
}




/*******************************************************************************
 * Copyright (c) 2011 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at
 * http://www.eclipse.org/legal/epl-v10.html
 * 
 * Contributors:
 *     IBM Corporation - initial API and implementation
 *******************************************************************************/
package org.eclipse.osgi.tests.resource;

import java.util.List;
import junit.framework.*;
import org.osgi.framework.Bundle;
import org.osgi.framework.Version;
import org.osgi.framework.wiring.*;

/*
 * Currently not tested:
 * 
 * IDENTITY_TYPE_UNKNOWN
 */
public class IdentityTest extends AbstractResourceTest {
	private interface CapabilityProvider {
		List getCapabilities(String namespace);
	}

	private Bundle tb1;
	private Bundle tb2;
	private Bundle tb3;
	private Bundle tb4;
	private Bundle tf1;
	private Bundle tf2;

	public static Test suite() {
		return new TestSuite(IdentityTest.class);
	}

	public IdentityTest(String name) {
		super(name);
	}

	public void testIdentityNamespace() throws Exception {
		assertTb1();
		assertTb2();
		assertTb3();
		assertTb4();
		assertTf1();
		assertTf2();
	}

	protected void setUp() throws Exception {
		super.setUp();
		tb1 = installer.installBundle("resource.tb1");
		tb2 = installer.installBundle("resource.tb2");
		tb3 = installer.installBundle("resource.tb3");
		tb4 = installer.installBundle("resource.tb4");
		tf1 = installer.installBundle("resource.tf1");
		tf2 = installer.installBundle("resource.tf2");
		tb1.start();
		tb2.start();
		tb3.start();
		tb4.start();
	}

	/*
	 * TB1
	 * Requirements:
	 * 		osgi.identity;osgi.identity=resource.tb4;version=1.0.0;type=osgi.bundle (via TF1)
	 * Capabilities:
	 * 		osgi.identity;osgi.identity=resource.tb1;version=1.0.0;type=osgi.bundle
	 * 		osgi.wiring.host;osgi.wiring.host=resource.tb1;version=1.0.0
	 * Wires:
	 * 		osgi.identity <-> TB3
	 * 		osgi.wiring.host <-> TF1
	 * 		TB4 <-> osgi.identity
	 */
	private void assertTb1() {
		BundleRevision revision = (BundleRevision) tb1.adapt(BundleRevision.class);
		String symbolicName = revision.getSymbolicName();
		assertSymbolicName("resource.tb1", symbolicName);
		Version version = revision.getVersion();
		assertVersion("1.0.0", version);
		String type = getType(revision);
		assertType(ResourceConstants.IDENTITY_TYPE_BUNDLE, type);
		Capability capability = getIdentityCapability(revision);
		assertIdentityCapability(capability, symbolicName, version, type);
		Resource resource = revision;
		capability = getIdentityCapability(resource);
		assertIdentityCapability(capability, symbolicName, version, type);
		BundleWiring wiring = (BundleWiring) tb1.adapt(BundleWiring.class);
		capability = getIdentityCapability(wiring);
		assertIdentityCapability(capability, symbolicName, version, type);
		List wires = wiring.getProvidedWires(ResourceConstants.IDENTITY_NAMESPACE);
		assertWires(wires, 1);
		Wire wire = (Wire) wires.get(0);
		BundleRevision requirer = (BundleRevision) tb3.adapt(BundleRevision.class);
		Requirement requirement = getIdentityRequirement(requirer, 0);
		assertIdentityWire(wire, capability, revision, requirement, requirer);
		BundleRevision provider = (BundleRevision) tb4.adapt(BundleRevision.class);
		capability = getIdentityCapability(provider);
		wires = wiring.getRequiredWires(ResourceConstants.IDENTITY_NAMESPACE);
		assertWires(wires, 1);
		wire = (Wire) wires.get(0);
		// TODO Commented out because failing.
		//		requirement = getIdentityRequirement(revision, 0);
		//		assertIdentityWire(wire, capability, revision, requirement, requirer);
	}

	/*
	 * TB2
	 * Requirements:
	 * 		None
	 * Capabilities:
	 * 		None
	 * Wires:
	 * 		None
	 */
	private void assertTb2() {
		final BundleRevision revision = (BundleRevision) tb2.adapt(BundleRevision.class);
		assertNotIdentityCapability(new CapabilityProvider() {
			public List getCapabilities(String namespace) {
				return revision.getCapabilities(namespace);
			}
		});
		final Resource resource = revision;
		assertNotIdentityCapability(new CapabilityProvider() {
			public List getCapabilities(String namespace) {
				return resource.getCapabilities(namespace);
			}
		});
		final BundleWiring wiring = (BundleWiring) tb2.adapt(BundleWiring.class);
		assertNotIdentityCapability(new CapabilityProvider() {
			public List getCapabilities(String namespace) {
				return wiring.getCapabilities(namespace);
			}
		});
	}

	/*
	 * TB3
	 * Requirements:
	 * 		osgi.identity;osgi.identity=resource.tb1;version=1.0.0;type=osgi.bundle
	 * 		osgi.identity;osgi.identity=resource.tf1;version=1.0.0;type=osgi.fragment
	 * Capabilities:
	 * 		osgi.identity;osgi.identity=resource.tb3;version=1.0.0;type=osgi.bundle
	 * 		osgi.wiring.host;osgi.wiring.host=resource.tb3;version=1.0.0
	 * Wires:
	 * 		TB1 <-> osgi.identity
	 * 		TF1 <-> osgi.identity
	 */
	private void assertTb3() {
		BundleRevision revision = (BundleRevision) tb3.adapt(BundleRevision.class);
		String symbolicName = revision.getSymbolicName();
		assertSymbolicName("resource.tb3", symbolicName);
		Version version = revision.getVersion();
		assertVersion("1.0.0", version);
		String type = getType(revision);
		assertType(ResourceConstants.IDENTITY_TYPE_BUNDLE, type);
		Capability capability = getIdentityCapability(revision);
		assertIdentityCapability(capability, symbolicName, version, type);
		Resource resource = revision;
		capability = getIdentityCapability(resource);
		assertIdentityCapability(capability, symbolicName, version, type);
		BundleWiring wiring = (BundleWiring) tb3.adapt(BundleWiring.class);
		capability = getIdentityCapability(wiring);
		assertIdentityCapability(capability, symbolicName, version, type);
		List wires = wiring.getRequiredWires(ResourceConstants.IDENTITY_NAMESPACE);
		assertWires(wires, 2);
		Requirement requirement = getIdentityRequirement(revision, 0);
		BundleRevision provider = (BundleRevision) tb1.adapt(BundleRevision.class);
		capability = getIdentityCapability(provider);
		Wire wire = (Wire) wires.get(0);
		assertIdentityWire(wire, capability, provider, requirement, revision);
		requirement = getIdentityRequirement(revision, 1);
		provider = (BundleRevision) tf1.adapt(BundleRevision.class);
		capability = getIdentityCapability(provider);
		wire = (Wire) wires.get(1);
		assertIdentityWire(wire, capability, provider, requirement, revision);
	}

	/*
	 * TB4
	 * Requirements:
	 * 		None
	 * Capabilities:
	 * 		osgi.identity;osgi.identity=resource.tb4;version=1.0.0;type=osgi.bundle
	 * 		osgi.wiring.host;osgi.wiring.host=resource.tb4;version=1.0.0
	 * Wires:
	 * 		osgi.identity <-> TB1 (via TF1)
	 */
	private void assertTb4() {
		BundleRevision revision = (BundleRevision) tb4.adapt(BundleRevision.class);
		String symbolicName = revision.getSymbolicName();
		assertSymbolicName("resource.tb4", symbolicName);
		Version version = revision.getVersion();
		assertVersion("1.0.0", version);
		String type = getType(revision);
		assertType(ResourceConstants.IDENTITY_TYPE_BUNDLE, type);
		Capability capability = getIdentityCapability(revision);
		assertIdentityCapability(capability, symbolicName, version, type);
		Resource resource = revision;
		capability = getIdentityCapability(resource);
		assertIdentityCapability(capability, symbolicName, version, type);
		BundleWiring wiring = (BundleWiring) tb4.adapt(BundleWiring.class);
		capability = getIdentityCapability(wiring);
		assertIdentityCapability(capability, symbolicName, version, type);
		List wires = wiring.getProvidedWires(ResourceConstants.IDENTITY_NAMESPACE);
		assertWires(wires, 1);
		Wire wire = (Wire) wires.get(0);
		BundleRevision requirer = (BundleRevision) tb1.adapt(BundleRevision.class);
		// TODO Commented out because failing.
		//		Requirement requirement = getIdentityRequirement(requirer, 0);
		//		assertIdentityWire(wire, capability, revision, requirement, requirer);
	}

	/*
	 * TF1
	 * Requirements:
	 * 		osgi.wiring.host;osgi.wiring.host=resource.tb1;version=1.0.0
	 * Capabilities:
	 * 		osgi.identity;osgi.identity=resource.tf1;version=1.0.0;type=osgi.fragment
	 * Wires:
	 * 		TB1 <-> osgi.wiring.host
	 * 		osgi.identity <-> TB3
	 */
	private void assertTf1() {
		BundleRevision revision = (BundleRevision) tf1.adapt(BundleRevision.class);
		String symbolicName = revision.getSymbolicName();
		assertSymbolicName("resource.tf1", symbolicName);
		Version version = revision.getVersion();
		assertVersion("1.0.0", version);
		String type = getType(revision);
		assertType(ResourceConstants.IDENTITY_TYPE_FRAGMENT, type);
		Capability capability = getIdentityCapability(revision);
		assertIdentityCapability(capability, symbolicName, version, type);
		Resource resource = revision;
		capability = getIdentityCapability(resource);
		assertIdentityCapability(capability, symbolicName, version, type);
		BundleWiring wiring = (BundleWiring) tf1.adapt(BundleWiring.class);
		// TODO Commented out because failing.
		//		capability = getIdentityCapability(wiring);
		//		assertIdentityCapability(capability, symbolicName, version, type);
		BundleRevision requirer = (BundleRevision) tb3.adapt(BundleRevision.class);
		Requirement requirement = getIdentityRequirement(requirer, 1);
		List wires = wiring.getProvidedWires(ResourceConstants.IDENTITY_NAMESPACE);
		// TODO Commented out because failing.
		//		assertWires(wires, 1);
		//		Wire wire = (Wire) wires.get(0);
		//		assertIdentityWire(wire, capability, revision, requirement, requirer);
	}

	/*
	 * TF2
	 * Requirements:
	 * 		osgi.wiring.host;osgi.wiring.host=resource.tb1;version=1.0.0
	 * Capabilities:
	 * 		None
	 * Wires:
	 * 		TB1 <-> osgi.wiring.host
	 */
	private void assertTf2() {
		final BundleRevision revision = (BundleRevision) tf2.adapt(BundleRevision.class);
		assertNotIdentityCapability(new CapabilityProvider() {
			public List getCapabilities(String namespace) {
				return revision.getDeclaredCapabilities(namespace);
			}
		});
		final Resource resource = revision;
		assertNotIdentityCapability(new CapabilityProvider() {
			public List getCapabilities(String namespace) {
				return resource.getCapabilities(namespace);
			}
		});
		final BundleWiring wiring = (BundleWiring) tf2.adapt(BundleWiring.class);
		assertNotIdentityCapability(new CapabilityProvider() {
			public List getCapabilities(String namespace) {
				return wiring.getCapabilities(namespace);
			}
		});
	}

	private void assertCapabilities(List capabilities, int size) {
		assertNotNull("Null capabilities", capabilities);
		assertEquals("Wrong number of capabilities", size, capabilities.size());
	}

	private void assertIdentityCapability(Capability capability, String symbolicName, Version version, String type) {
		assertEquals("Wrong namespace", ResourceConstants.IDENTITY_NAMESPACE, capability.getNamespace());
		assertEquals("Wrong number of attributes", 3, capability.getAttributes().size());
		// The osgi.identity attribute contains the symbolic name of the resource.
		assertSymbolicName(symbolicName, (String) capability.getAttributes().get(ResourceConstants.IDENTITY_NAMESPACE));
		// The version attribute must be of type Version.
		// The version attribute contains the version of the resource.
		assertVersion(version, (Version) capability.getAttributes().get(ResourceConstants.IDENTITY_VERSION_ATTRIBUTE));
		// The type attribute must be of type String.
		// The type attribute contains the resource type.
		assertType(type, (String) capability.getAttributes().get(ResourceConstants.IDENTITY_TYPE_ATTRIBUTE));
	}

	private void assertIdentityWire(Wire wire, Capability capability, Resource provider, Requirement requirement, Resource requirer) {
		assertEquals("Wrong capability", capability, wire.getCapability());
		assertEquals("Wrong provider", provider, wire.getProvider());
		assertEquals("Wrong requirement", requirement, wire.getRequirement());
		assertEquals("Wrong requirer", requirer, wire.getRequirer());
	}

	private void assertNotIdentityCapability(CapabilityProvider provider) {
		List capabilities = provider.getCapabilities(ResourceConstants.IDENTITY_NAMESPACE);
		// A resource with no symbolic name must not provide an identity capability.
		assertCapabilities(capabilities, 0);
	}

	private void assertNotNull(Capability capability) {
		Assert.assertNotNull("Null capability", capability);
	}

	private void assertNotNull(Requirement requirement) {
		Assert.assertNotNull("Null requirement", requirement);
	}

	private void assertRequirements(List requirements, int index) {
		assertNotNull("Null requirements", requirements);
		assertTrue("Wrong number of requirements", requirements.size() > index);
	}

	private void assertSymbolicName(String expected, String actual) {
		assertEquals("Wrong symbolic name", expected, actual);
	}

	private void assertType(String expected, String actual) {
		assertEquals("Wrong type", expected, actual);
	}

	private void assertVersion(String expected, Version actual) {
		assertVersion(Version.parseVersion(expected), actual);
	}

	private void assertVersion(Version expected, Version actual) {
		assertEquals("Wrong version", expected, actual);
	}

	private void assertWires(List wires, int size) {
		assertNotNull("Null wires", wires);
		assertEquals("Wrong number of wires", size, wires.size());
	}

	private Capability getIdentityCapability(BundleRevision revision) {
		List capabilities = revision.getDeclaredCapabilities(ResourceConstants.IDENTITY_NAMESPACE);
		assertCapabilities(capabilities, 1);
		Capability capability = (Capability) capabilities.get(0);
		assertNotNull(capability);
		return capability;
	}

	private Capability getIdentityCapability(BundleWiring wiring) {
		List capabilities = wiring.getCapabilities(ResourceConstants.IDENTITY_NAMESPACE);
		assertCapabilities(capabilities, 1);
		Capability capability = (Capability) capabilities.get(0);
		assertNotNull(capability);
		return capability;
	}

	private Capability getIdentityCapability(Resource resource) {
		List capabilities = resource.getCapabilities(ResourceConstants.IDENTITY_NAMESPACE);
		assertCapabilities(capabilities, 1);
		Capability capability = (Capability) capabilities.get(0);
		assertNotNull(capability);
		return capability;
	}

	private Requirement getIdentityRequirement(BundleRevision revision, int index) {
		List requirements = revision.getDeclaredRequirements(ResourceConstants.IDENTITY_NAMESPACE);
		assertRequirements(requirements, index);
		Requirement requirement = (Requirement) requirements.get(index);
		assertNotNull(requirement);
		return requirement;
	}

	private String getType(BundleRevision revision) {
		return (revision.getTypes() & BundleRevision.TYPE_FRAGMENT) == 0 ? ResourceConstants.IDENTITY_TYPE_BUNDLE : ResourceConstants.IDENTITY_TYPE_FRAGMENT;
	}
}

Lines 106-114 Link Here

(-)src/org/eclipse/osgi/tests/services/resolver/AbstractStateTest.java (-2 / +2 lines)
106	if (original.getSupplier() != null) {	106	if (original.getSupplier() != null) {
107	Object o = original.getSupplier();	107	Object o = original.getSupplier();
108	if (o instanceof BundleDescription)	108	if (o instanceof BundleDescription)
109	assertEquals(tag + ".5", (BundleDescription)original.getSupplier(), (BundleDescription)copy.getSupplier());	109	assertEquals(tag + ".5", (BundleDescription) original.getSupplier(), (BundleDescription) copy.getSupplier());
110	else	110	else
111	assertEquals(tag + ".5", (ExportPackageDescription)original.getSupplier(), (ExportPackageDescription)copy.getSupplier());	111	assertEquals(tag + ".5", (ExportPackageDescription) original.getSupplier(), (ExportPackageDescription) copy.getSupplier());
112	}	112	}
113	}	113	}
114		114




/*******************************************************************************
 * Copyright (c) 2003, 2011 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at

import org.osgi.framework.Constants;

public class GenericCapabilityTest extends AbstractStateTest {
	static final String GENERIC_REQUIRE = "Eclipse-GenericRequire"; //$NON-NLS-1$
	static final String GENERIC_CAPABILITY = "Eclipse-GenericCapability"; //$NON-NLS-1$

	public static Test suite() {
		return new TestSuite(GenericCapabilityTest.class);

		Hashtable manifest = new Hashtable();
		long bundleID = 0;
		manifest.put(Constants.BUNDLE_MANIFESTVERSION, "2");
		manifest.put(Constants.BUNDLE_SYMBOLICNAME, "genericCapability");
		manifest.put(Constants.BUNDLE_VERSION, "1.0.0");
		StringBuffer capabililty = new StringBuffer();
		capabililty.append("foo; version=\"1.3.1\"; attr1=\"value1\"; attr2=\"value2\",");

		manifest.put(Constants.BUNDLE_SYMBOLICNAME, "genericRequire");
		manifest.put(Constants.BUNDLE_VERSION, "1.0.0");
		StringBuffer required = new StringBuffer();
		required.append("genericCapability:osgi.identity; selection-filter=\"(version=1.0)\",");
		required.append("foo; selection-filter=\"(version>=1.3.0)\",");
		required.append("bar:bartype; selection-filter=\"(attr1=value1)\",");
		required.append("test.types:testtype; selection-filter=\"(&(aVersion>=2.0.0)(aLong>=5555)(aDouble>=1.00)(aUri=file:/test)(aSet=c)(aString=someString))\"");

		assertTrue("1.0", genCap.isResolved());
		assertTrue("1.1", genReq.isResolved());
		GenericSpecification[] genSpecs = genReq.getGenericRequires();
		assertTrue("2.0", genSpecs.length == 4);
		assertTrue("2.1", genSpecs[0].isResolved());
		assertEquals("2.1.1", genSpecs[0].getSupplier(), genCap.getGenericCapabilities()[0]);
		assertTrue("2.2", genSpecs[1].isResolved());
		assertEquals("2.2.1", genSpecs[1].getSupplier(), genCap.getGenericCapabilities()[1]);
		assertTrue("2.3", genSpecs[2].isResolved());
		assertEquals("2.3.1", genSpecs[2].getSupplier(), genCap.getGenericCapabilities()[2]);
		assertTrue("2.4", genSpecs[3].isResolved());
		assertEquals("2.4.1", genSpecs[3].getSupplier(), genCap.getGenericCapabilities()[3]);
	}

	public void testGenericsUpdate() throws BundleException {

		Hashtable manifest = new Hashtable();
		long bundleID = 0;
		manifest.put(Constants.BUNDLE_MANIFESTVERSION, "2");
		manifest.put(Constants.BUNDLE_SYMBOLICNAME, "genericCapability");
		manifest.put(Constants.BUNDLE_VERSION, "1.0.0");
		StringBuffer capabililty = new StringBuffer();
		capabililty.append("foo; version=\"1.3.1\"; attr1=\"value1\"; attr2=\"value2\",");

		manifest.put(Constants.BUNDLE_SYMBOLICNAME, "genericRequire");
		manifest.put(Constants.BUNDLE_VERSION, "1.0.0");
		StringBuffer required = new StringBuffer();
		required.append("genericCapability:osgi.identity; selection-filter=\"(version>=1.0)\",");
		required.append("foo; selection-filter=\"(version>=1.3.0)\",");
		required.append("bar:bartype; selection-filter=\"(attr1=value1)\",");
		required.append("test.types:testtype; selection-filter=\"(&(aVersion>=2.0.0)(aLong>=5555)(aDouble>=1.00)(aUri=file:/test)(aSet=c)(aString=someString))\"");

		assertTrue("1.0", genCap.isResolved());
		assertTrue("1.1", genReq.isResolved());
		GenericSpecification[] genSpecs = genReq.getGenericRequires();
		assertTrue("2.0", genSpecs.length == 4);
		assertTrue("2.1", genSpecs[0].isResolved());
		assertEquals("2.1.1", genSpecs[0].getSupplier(), genCap.getGenericCapabilities()[0]);
		assertTrue("2.2", genSpecs[1].isResolved());
		assertEquals("2.2.1", genSpecs[1].getSupplier(), genCap.getGenericCapabilities()[1]);
		assertTrue("2.3", genSpecs[2].isResolved());
		assertEquals("2.3.1", genSpecs[2].getSupplier(), genCap.getGenericCapabilities()[2]);
		assertTrue("2.4", genSpecs[3].isResolved());
		assertEquals("2.4.1", genSpecs[3].getSupplier(), genCap.getGenericCapabilities()[3]);

		manifest.clear();
		manifest.put(Constants.BUNDLE_MANIFESTVERSION, "2");
		manifest.put(Constants.BUNDLE_SYMBOLICNAME, "genericCapability");
		manifest.put(Constants.BUNDLE_VERSION, "2.0.0");
		capabililty = new StringBuffer();
		capabililty.append("foo; version=\"1.3.2\"; attr1=\"value1\"; attr2=\"value2\",");

		assertTrue("3.0", genCap2.isResolved());
		assertTrue("3.1", genReq.isResolved());
		genSpecs = genReq.getGenericRequires();
		assertTrue("4.0", genSpecs.length == 4);
		assertTrue("4.1", genSpecs[0].isResolved());
		assertEquals("4.1.1", genSpecs[0].getSupplier(), genCap2.getGenericCapabilities()[0]);
		assertTrue("4.2", genSpecs[1].isResolved());
		assertEquals("4.2.1", genSpecs[1].getSupplier(), genCap2.getGenericCapabilities()[1]);
		assertTrue("4.3", genSpecs[2].isResolved());
		assertEquals("4.3.1", genSpecs[2].getSupplier(), genCap2.getGenericCapabilities()[2]);
		assertTrue("4.4", genSpecs[3].isResolved());
		assertEquals("4.4.1", genSpecs[3].getSupplier(), genCap2.getGenericCapabilities()[3]);

	}


		Hashtable manifest = new Hashtable();
		long bundleID = 0;
		manifest.put(Constants.BUNDLE_MANIFESTVERSION, "2");
		manifest.put(Constants.BUNDLE_SYMBOLICNAME, "genericCapability");
		manifest.put(Constants.BUNDLE_VERSION, "1.0.0");
		StringBuffer capabililty = new StringBuffer();
		capabililty.append("foo; version=\"1.3.1\"; attr1=\"value1\"; attr2=\"value2\",");

		manifest.put(Constants.BUNDLE_SYMBOLICNAME, "genericRequire");
		manifest.put(Constants.BUNDLE_VERSION, "1.0.0");
		StringBuffer required = new StringBuffer();
		required.append("genericCapability:osgi.identity; selection-filter=\"(version>=1.0)\",");
		required.append("foo; selection-filter=\"(version>=1.3.0)\",");
		required.append("bar:bartype; selection-filter=\"(attr1=value1)\",");
		required.append("test.types:testtype; selection-filter=\"(&(aVersion>=2.0.0)(aLong>=5555)(aDouble>=1.00)(aUri=file:/test)(aSet=c)(aString=someString))\"");

		assertTrue("1.0", genCap.isResolved());
		assertTrue("1.1", genReq.isResolved());
		GenericSpecification[] genSpecs = genReq.getGenericRequires();
		assertTrue("2.0", genSpecs.length == 4);
		assertTrue("2.1", genSpecs[0].isResolved());
		assertEquals("2.1.1", genSpecs[0].getSupplier(), genCap.getGenericCapabilities()[0]);
		assertTrue("2.2", genSpecs[1].isResolved());
		assertEquals("2.2.1", genSpecs[1].getSupplier(), genCap.getGenericCapabilities()[1]);
		assertTrue("2.3", genSpecs[2].isResolved());
		assertEquals("2.3.1", genSpecs[2].getSupplier(), genCap.getGenericCapabilities()[2]);
		assertTrue("2.4", genSpecs[3].isResolved());
		assertEquals("2.4.1", genSpecs[3].getSupplier(), genCap.getGenericCapabilities()[3]);

		state.resolve(new BundleDescription[] {genCap});

		assertTrue("3.0", genCap.isResolved());
		assertTrue("3.1", genReq.isResolved());
		genSpecs = genReq.getGenericRequires();
		assertTrue("4.0", genSpecs.length == 4);
		assertTrue("4.1", genSpecs[0].isResolved());
		assertEquals("4.1.1", genSpecs[0].getSupplier(), genCap.getGenericCapabilities()[0]);
		assertTrue("4.2", genSpecs[1].isResolved());
		assertEquals("4.2.1", genSpecs[1].getSupplier(), genCap.getGenericCapabilities()[1]);
		assertTrue("4.3", genSpecs[2].isResolved());
		assertEquals("4.3.1", genSpecs[2].getSupplier(), genCap.getGenericCapabilities()[2]);
		assertTrue("4.4", genSpecs[3].isResolved());
		assertEquals("4.4.1", genSpecs[3].getSupplier(), genCap.getGenericCapabilities()[3]);

	}


		long bundleID = 0;

		manifest.put(Constants.BUNDLE_MANIFESTVERSION, "2");
		manifest.put(Constants.BUNDLE_SYMBOLICNAME, "genericCapability");
		manifest.put(Constants.BUNDLE_VERSION, "1.0.0");
		StringBuffer capabililty = new StringBuffer();
		capabililty.append("foo; version=\"1.3.1\"; attr1=\"value1\"; attr2=\"value2\",");

		manifest.put(Constants.BUNDLE_MANIFESTVERSION, "2");
		manifest.put(Constants.BUNDLE_SYMBOLICNAME, "genericCapability.frag1");
		manifest.put(Constants.BUNDLE_VERSION, "1.0.0");
		manifest.put(Constants.FRAGMENT_HOST, "genericCapability;bundle-version=\"[1.0.0,2.0.0)\"");
		capabililty = new StringBuffer();
		capabililty.append("fragmentStuff");
		manifest.put(GENERIC_CAPABILITY, capabililty.toString());

		manifest.put(Constants.BUNDLE_SYMBOLICNAME, "genericRequire");
		manifest.put(Constants.BUNDLE_VERSION, "1.0.0");
		StringBuffer required = new StringBuffer();
		required.append("genericCapability:osgi.identity; selection-filter=\"(&(version=1.0.0)(type=osgi.bundle))\",");
		required.append("foo; selection-filter=\"(version>=1.3.0)\",");
		required.append("bar:bartype; selection-filter=\"(attr1=value1)\",");
		required.append("test.types:testtype; selection-filter=\"(&(aVersion>=2.0.0)(aLong>=5555)(aDouble>=1.00)(aUri=file:/test)(aSet=c)(aString=someString))\",");
		required.append("fragmentStuff,");
		required.append("genericCapability.frag1:osgi.identity; selection-filter=\"(&(version=1.0.0)(type=osgi.fragment))\"");
		manifest.put(GENERIC_REQUIRE, required.toString());
		BundleDescription genReq = state.getFactory().createBundleDescription(state, manifest, (String) manifest.get(Constants.BUNDLE_SYMBOLICNAME), bundleID++);


		assertTrue("1.1", genReq.isResolved());
		assertTrue("1.2", genCapFrag.isResolved());
		GenericSpecification[] genSpecs = genReq.getGenericRequires();
		GenericDescription[] selectedHostCapabilities = genCap.getSelectedGenericCapabilities();
		GenericDescription[] selectedFragCapabilities = genCapFrag.getSelectedGenericCapabilities();
		assertTrue("2.0", genSpecs.length == 6);
		assertEquals("Wrong number of selected capabilities", 5, selectedHostCapabilities.length);
		assertEquals("Wrong number of selected capabilities", 1, selectedFragCapabilities.length);
		assertTrue("2.1", genSpecs[0].isResolved());
		assertEquals("2.1.1", genSpecs[0].getSupplier(), selectedHostCapabilities[0]);
		assertTrue("2.2", genSpecs[1].isResolved());
		assertEquals("2.2.1", genSpecs[1].getSupplier(), selectedHostCapabilities[1]);
		assertTrue("2.3", genSpecs[2].isResolved());
		assertEquals("2.3.1", genSpecs[2].getSupplier(), selectedHostCapabilities[2]);
		assertTrue("2.4", genSpecs[3].isResolved());
		assertEquals("2.4.1", genSpecs[3].getSupplier(), selectedHostCapabilities[3]);
		assertTrue("2.5", genSpecs[4].isResolved());
		assertEquals("2.5.1", genSpecs[4].getSupplier(), selectedHostCapabilities[4]);
		assertTrue("2.6", genSpecs[5].isResolved());
		assertEquals("2.6.1", genSpecs[5].getSupplier(), selectedFragCapabilities[0]);
	}

	public void testGenericsIntraFrags() throws BundleException {

		manifest.put(Constants.BUNDLE_SYMBOLICNAME, "org.eclipse.equinox.generic.frag.b");
		manifest.put(Constants.BUNDLE_VERSION, "1.0.0");
		manifest.put(Constants.FRAGMENT_HOST, "org.eclipse.equinox.generic.host;bundle-version=\"1.0.0\"");
		StringBuffer required = new StringBuffer();
		required.append("org.eclipse.equinox.generic.host:osgi.identity; selection-filter=\"(&(version=1.0.0)(type=osgi.bundle))\",");
		required.append("frag.a,");
		required.append("org.eclipse.equinox.generic.frag.a:osgi.identity; selection-filter=\"(&(version=1.0.0)(type=osgi.fragment))\",");
		required.append("org.eclipse.equinox.generic.frag.b:osgi.identity; selection-filter=\"(&(version=1.0.0)(type=osgi.fragment))\"");
		manifest.put(GENERIC_REQUIRE, required.toString());
		BundleDescription genFragB = state.getFactory().createBundleDescription(state, manifest, (String) manifest.get(Constants.BUNDLE_SYMBOLICNAME), bundleID++);

		state.addBundle(genHost);

		assertTrue("1.2", genFragB.isResolved());
		GenericSpecification[] genSpecs = genFragB.getGenericRequires();
		GenericDescription[] selected = genHost.getSelectedGenericCapabilities();
		assertEquals("Wrong number of selected", 1 + 1, selected.length); // + 1 for host osgi.identity cap
		assertTrue("2.0", genSpecs.length == 4);
		GenericDescription[] selectedHostCapabilities = genHost.getSelectedGenericCapabilities();
		GenericDescription[] selectedFragACapabilities = genFragA.getSelectedGenericCapabilities();
		GenericDescription[] selectedFragBCapabilities = genFragB.getSelectedGenericCapabilities();
		assertEquals("Wrong number of selected capabilities", 2, selectedHostCapabilities.length);
		assertEquals("Wrong number of selected capabilities", 1, selectedFragACapabilities.length);
		assertEquals("Wrong number of selected capabilities", 1, selectedFragBCapabilities.length);
		assertTrue("2.1", genSpecs[0].isResolved());
		assertEquals("2.1.1", genSpecs[0].getSupplier(), selectedHostCapabilities[0]);
		assertTrue("2.2", genSpecs[1].isResolved());
		assertEquals("2.2.1", genSpecs[1].getSupplier(), selectedHostCapabilities[1]);
		assertTrue("2.3", genSpecs[2].isResolved());
		assertEquals("2.3.1", genSpecs[2].getSupplier(), selectedFragACapabilities[0]);
		assertTrue("2.4", genSpecs[3].isResolved());
		assertEquals("2.4.1", genSpecs[3].getSupplier(), selectedFragBCapabilities[0]);
	}

	public void testGenericsAliases() throws BundleException {

		Hashtable manifest = new Hashtable();
		long bundleID = 0;
		manifest.put(Constants.BUNDLE_MANIFESTVERSION, "2");
		manifest.put(Constants.BUNDLE_SYMBOLICNAME, "genericCapability");
		manifest.put(Constants.BUNDLE_VERSION, "1.0.0");
		manifest.put(Constants.EXPORT_SERVICE, "org.osgi.service.log.LogService; version=1.2");
		manifest.put("TJW-Export", "my.great.stuff; aLong:long=5150; aDouble:double=3.14; aVersion:version=1.2.0");

		manifest.put(Constants.BUNDLE_VERSION, "1.0.0");
		manifest.put(Constants.IMPORT_SERVICE, "org.osgi.service.log.LogService; selection-filter=(version>=1.0.0)");
		manifest.put("TJW-Import", "my.great.stuff; selection-filter=(&(aLong<=10000)(aLong>=5000))");
		manifest.put(GENERIC_REQUIRE, "genericCapability:osgi.identity; selection-filter=\"(&(version=1.0.0)(type=osgi.bundle))\"");
		BundleDescription genReq = state.getFactory().createBundleDescription(state, manifest, (String) manifest.get(Constants.BUNDLE_SYMBOLICNAME), bundleID++);

		state.addBundle(genCap);

		assertTrue("1.0", genCap.isResolved());
		assertTrue("1.1", genReq.isResolved());
		GenericSpecification[] genSpecs = genReq.getGenericRequires();
		assertTrue("2.0", genSpecs.length == 3);
		assertTrue("2.1", genSpecs[0].isResolved());
		assertEquals("2.1.1", genSpecs[0].getSupplier(), genCap.getGenericCapabilities()[1]);
		assertTrue("2.2", genSpecs[1].isResolved());
		assertEquals("2.2.1", genSpecs[1].getSupplier(), genCap.getGenericCapabilities()[2]);
		assertTrue("2.3", genSpecs[2].isResolved());
		assertEquals("2.3.1", genSpecs[2].getSupplier(), genCap.getGenericCapabilities()[0]);
	}

	public void testGenericsOptionalMultiple() throws BundleException {

		Hashtable manifest = new Hashtable();
		long bundleID = 0;
		manifest.put(Constants.BUNDLE_MANIFESTVERSION, "2");
		manifest.put(Constants.BUNDLE_SYMBOLICNAME, "genericCapability");
		manifest.put(Constants.BUNDLE_VERSION, "1.0.0");
		StringBuffer capabililty = new StringBuffer();
		capabililty.append("foo; version=\"1.3.1\"; attr1=\"value1\"; attr2=\"value2\",");

		manifest.put(Constants.BUNDLE_SYMBOLICNAME, "genericRequire");
		manifest.put(Constants.BUNDLE_VERSION, "1.0.0");
		StringBuffer required = new StringBuffer();
		required.append("genericCapability:osgi.identity; selection-filter=\"(&(version=1.0.0)(type=osgi.bundle))\",");
		required.append("foo; selection-filter=\"(version>=1.3.0)\",");
		required.append("bar:bartype; selection-filter=\"(attr1=value1)\",");
		required.append("test.types:testtype; selection-filter=\"(&(aVersion>=2.0.0)(aLong>=5555)(aDouble>=1.00)(aUri=file:/test)(aSet=c)(aString=someString))\",");

		assertTrue("1.0", genCap.isResolved());
		assertTrue("1.1", genReq.isResolved());
		GenericSpecification[] genSpecs = genReq.getGenericRequires();
		assertTrue("2.0", genSpecs.length == 7);
		assertTrue("2.1", genSpecs[0].isResolved());
		assertEquals("2.1.1", genSpecs[0].getSupplier(), genCap.getGenericCapabilities()[0]);
		assertTrue("2.2", genSpecs[1].isResolved());
		assertEquals("2.2.1", genSpecs[1].getSupplier(), genCap.getGenericCapabilities()[1]);
		assertTrue("2.3", genSpecs[2].isResolved());
		assertEquals("2.3.1", genSpecs[2].getSupplier(), genCap.getGenericCapabilities()[2]);
		assertTrue("2.3", genSpecs[3].isResolved());
		assertEquals("2.3.1", genSpecs[3].getSupplier(), genCap.getGenericCapabilities()[3]);
		assertFalse("2.4", genSpecs[4].isResolved());
		assertTrue("2.5", genSpecs[5].isResolved());
		assertEquals("2.5.1", genSpecs[5].getSupplier(), genCap.getGenericCapabilities()[4]);
		assertTrue("2.6", genSpecs[6].isResolved());
		GenericDescription[] suppliers = genSpecs[6].getSuppliers();
		assertTrue("2.6.1", suppliers != null && suppliers.length == 2);
		assertEquals("2.6.2", suppliers[0], genCap.getGenericCapabilities()[6]);
		assertEquals("2.6.3", suppliers[1], genCap.getGenericCapabilities()[5]);
	}

	public void testGenericsCycles() throws BundleException {

		GenericSpecification[] genSpecs = genReq.getGenericRequires();
		GenericDescription[] selected = genCap.getSelectedGenericCapabilities();
		assertTrue("2.0", genSpecs.length == 4);
		assertEquals("Wrong number of selected", 4 + 1, selected.length); // + 1 for host osgi.identity caps
		assertTrue("2.1", genSpecs[0].isResolved());
		assertEquals("2.1.1", genSpecs[0].getSupplier(), selected[1]);
		assertTrue("2.2", genSpecs[1].isResolved());
		assertEquals("2.2.1", genSpecs[1].getSupplier(), selected[2]);
		assertTrue("2.3", genSpecs[2].isResolved());
		assertEquals("2.3.1", genSpecs[2].getSupplier(), selected[3]);
		assertTrue("2.4", genSpecs[3].isResolved());
		assertEquals("2.4.1", genSpecs[3].getSupplier(), selected[4]);
		genSpecs = genCap.getGenericRequires();
		assertTrue("3.0", genSpecs.length == 1);
		assertTrue("3.1", genSpecs[0].isResolved());
		assertEquals("3.1.1", genSpecs[0].getSupplier(), genReq.getGenericCapabilities()[1]);
	}
}




/*******************************************************************************
 * Copyright (c) 2010, 2011 IBM Corporation and others.
 * All rights reserved. This program and the accompanying materials
 * are made available under the terms of the Eclipse Public License v1.0
 * which accompanies this distribution, and is available at

import java.io.File;
import java.io.IOException;
import java.net.URL;
import java.util.*;
import junit.framework.Test;
import junit.framework.TestSuite;
import org.eclipse.osgi.framework.util.Headers;
import org.eclipse.osgi.service.resolver.*;
import org.osgi.framework.BundleException;
import org.osgi.framework.Constants;
import org.osgi.framework.wiring.ResourceConstants;

public class OSGiCapabilityTest extends AbstractStateTest {
	private static final String MANIFEST_ROOT = "test_files/genericCapability/";

		assertTrue("c2", c2.isResolved());
		assertTrue("c3", c3.isResolved());

		checkGenericBasics(4, c1.getResolvedGenericRequires(), p1.getSelectedGenericCapabilities());
		checkGenericBasics(4, c2.getResolvedGenericRequires(), p2.getSelectedGenericCapabilities());
		checkGenericBasics(4, c3.getResolvedGenericRequires(), p3.getSelectedGenericCapabilities());

		File stateDir = getContext().getDataFile(getName()); //$NON-NLS-1$
		stateDir.mkdirs();

		assertTrue("c2", c2.isResolved());
		assertTrue("c3", c3.isResolved());

		checkGenericBasics(4, c1.getResolvedGenericRequires(), p1.getSelectedGenericCapabilities());
		checkGenericBasics(4, c2.getResolvedGenericRequires(), p2.getSelectedGenericCapabilities());
		checkGenericBasics(4, c3.getResolvedGenericRequires(), p3.getSelectedGenericCapabilities());
	}

	private void checkGenericBasics(int expectedCnt, GenericDescription[] genRequired, GenericDescription[] genProvided) {
		checkGenericBasics(expectedCnt, genRequired, genProvided, null);
	}

	private void checkGenericBasics(int expectedCnt, GenericDescription[] genRequired, GenericDescription[] genProvided, GenericDescription fragIdentity) {
		assertEquals("Expected number of capabilities do not match", expectedCnt, genRequired.length);
		assertEquals("Specs do not match Descs", genRequired.length, genProvided.length + (fragIdentity == null ? 0 : 1));
		Collection providedCollection = new ArrayList(Arrays.asList(genProvided));
		for (int i = 0; i < genRequired.length; i++) {
			if (ResourceConstants.IDENTITY_NAMESPACE.equals(genRequired[i].getType()) && genRequired[i].getSupplier().getHost() != null)
				assertEquals("Wrong fragment provider: " + genRequired[i], fragIdentity, genRequired[i]);
			else
				assertTrue("Wrong provider for requirement: " + genRequired[i], providedCollection.remove(genRequired[i]));
		}
	}


		assertTrue("c1Frag", c1Frag.isResolved());
		assertTrue("p4", p4.isResolved());

		checkGenericBasics(6, c1.getResolvedGenericRequires(), p1.getSelectedGenericCapabilities(), p1Frag.getSelectedGenericCapabilities()[0]);

		File stateDir = getContext().getDataFile(getName()); //$NON-NLS-1$
		stateDir.mkdirs();

		assertTrue("c1Frag", c1Frag.isResolved());
		assertTrue("p4", p4.isResolved());

		checkGenericBasics(6, c1.getResolvedGenericRequires(), p1.getSelectedGenericCapabilities(), p1Frag.getSelectedGenericCapabilities()[0]);

		state.setResolver(platformAdmin.createResolver());
		state.resolve(new BundleDescription[] {p1});

		assertTrue("c1Frag", c1Frag.isResolved());
		assertTrue("p4", p4.isResolved());

		checkGenericBasics(6, c1.getResolvedGenericRequires(), p1.getSelectedGenericCapabilities(), p1Frag.getSelectedGenericCapabilities()[0]);
	}

	public void testGenericFragments02() throws BundleException {

		assertTrue("c1", c1.isResolved());
		assertFalse("c1Frag", c1Frag.isResolved());

		checkGenericBasics(4, c1.getResolvedGenericRequires(), p1.getSelectedGenericCapabilities());

		File stateDir = getContext().getDataFile(getName() + 1); //$NON-NLS-1$
		stateDir.mkdirs();

		assertTrue("c1", c1.isResolved());
		assertFalse("c1Frag", c1Frag.isResolved());

		checkGenericBasics(4, c1.getResolvedGenericRequires(), p1.getSelectedGenericCapabilities());

		manifest = loadManifest("p4.osgi.MF");
		BundleDescription p4 = state.getFactory().createBundleDescription(state, manifest, (String) manifest.get(Constants.BUNDLE_SYMBOLICNAME), bundleID++);

		assertTrue("c1Frag", c1Frag.isResolved());
		assertTrue("p4", p4.isResolved());

		checkGenericBasics(6, c1.getResolvedGenericRequires(), p1.getSelectedGenericCapabilities(), p1Frag.getSelectedGenericCapabilities()[0]);

		stateDir = getContext().getDataFile(getName() + 2); //$NON-NLS-1$
		stateDir.mkdirs();

		assertTrue("c1Frag", c1Frag.isResolved());
		assertTrue("p4", p4.isResolved());

		checkGenericBasics(6, c1.getResolvedGenericRequires(), p1.getSelectedGenericCapabilities(), p1Frag.getSelectedGenericCapabilities()[0]);
	}

	public void testGenericUses() throws BundleException {

		checkUsedCapability(c4v130, p5v100Capability);
	}

	public void testDeclaringIdentityCapability() {
		State state = buildEmptyState();
		Hashtable manifest = new Hashtable();
		long bundleID = 0;
		manifest.put(Constants.BUNDLE_MANIFESTVERSION, "2");
		manifest.put(Constants.BUNDLE_SYMBOLICNAME, "genericCapability");
		manifest.put(Constants.BUNDLE_VERSION, "1.0.0");
		StringBuffer capabililty = new StringBuffer();
		capabililty.append("testFailure:osgi.identity; test=failure");
		manifest.put(GenericCapabilityTest.GENERIC_CAPABILITY, capabililty.toString());

		try {
			state.getFactory().createBundleDescription(state, manifest, (String) manifest.get(Constants.BUNDLE_SYMBOLICNAME), bundleID++);
			fail("Expected failure to create description that specifies osgi.identity capability");
		} catch (BundleException e) {
			// expected
		}

		manifest.remove(GenericCapabilityTest.GENERIC_CAPABILITY);
		manifest.put(Constants.PROVIDE_CAPABILITY, "osgi.identity; osgi.identity=testFailure; test=failure");
		try {
			state.getFactory().createBundleDescription(state, manifest, (String) manifest.get(Constants.BUNDLE_SYMBOLICNAME), bundleID++);
			fail("Expected failure to create description that specifies osgi.identity capability");
		} catch (BundleException e) {
			// expected
		}
	}

	private void checkUsedImports(BundleDescription importer, ExportPackageDescription[] expectedPackages) {
		ExportPackageDescription[] imported = importer.getResolvedImports();
		assertEquals("Wrong number of imports for bundle: " + importer, expectedPackages.length, imported.length);

	private void checkUsedCapability(BundleDescription requirer, GenericDescription[] expectedCapabilities) {
		GenericDescription[] required = requirer.getResolvedGenericRequires();
		assertEquals("Wrong number of capabilities for bundle: " + requirer, expectedCapabilities.length, required.length);
		Collection providedCollection = new ArrayList(Arrays.asList(expectedCapabilities));
		for (int i = 0; i < required.length; i++) {
			assertTrue("Wrong provider for requirement: " + required[i], providedCollection.remove(required[i]));
		}
	}
}

Lines 17-20 Link Here

(-)test_files/genericCapability/c1.equinox.MF (-1 / +3 lines)
17	selection-filter="(&(rank>=100)(!(rank>=200))	17	selection-filter="(&(rank>=100)(!(rank>=200))
18	(percent>=0.1)(!(percent>=0.2))	18	(percent>=0.1)(!(percent>=0.2))
19	(test.version>=1.0)(!(test.version>=2.0))	19	(test.version>=1.0)(!(test.version>=2.0))
20	(test.string~=abc))"	20	(test.string~=abc))",
		21	*:osgi.identity;
		22	selection-filter="(&(osgi.identity=p1.*)(version=1.0)(type=osgi.bundle))"

Lines 17-20 Link Here

(-)test_files/genericCapability/c1.equinox.name.MF (-1 / +3 lines)
17	selection-filter="(&(rank>=100)(!(rank>=200))	17	selection-filter="(&(rank>=100)(!(rank>=200))
18	(percent>=0.1)(!(percent>=0.2))	18	(percent>=0.1)(!(percent>=0.2))
19	(test.version>=1.0)(!(test.version>=2.0))	19	(test.version>=1.0)(!(test.version>=2.0))
20	(test.string~=abc))"	20	(test.string~=abc))",
		21	p1.*:osgi.identity;
		22	selection-filter="(&(version=1.0)(type=osgi.bundle))"

Lines 17-20 Link Here

(-)test_files/genericCapability/c1.osgi.MF (-1 / +3 lines)
17	filter:="(&(rank>=100)(!(rank>=200))	17	filter:="(&(rank>=100)(!(rank>=200))
18	(percent>=0.1)(!(percent>=0.2))	18	(percent>=0.1)(!(percent>=0.2))
19	(test.version>=1.0)(!(test.version>=2.0))	19	(test.version>=1.0)(!(test.version>=2.0))
20	(test.string~=abc))"	20	(test.string~=abc))",
		21	osgi.identity;
		22	filter:="(&(osgi.identity=p1.*)(version=1.0)(type=osgi.bundle))"

Lines 8-11 Link Here

(-)test_files/genericCapability/c1.osgi.frag.MF (-1 / +3 lines)
8	filter:="(&(rank>=100)(!(rank>=200))	8	filter:="(&(rank>=100)(!(rank>=200))
9	(percent>=0.1)(!(percent>=0.2))	9	(percent>=0.1)(!(percent>=0.2))
10	(test.version>=1.0)(!(test.version>=2.0))	10	(test.version>=1.0)(!(test.version>=2.0))
11	(test.string~=abc))"	11	(test.string~=abc))",
		12	osgi.identity;
		13	filter:="(&(osgi.identity=p1.*.frag)(version=1.0)(type=osgi.fragment))"

Lines 17-20 Link Here

(-)test_files/genericCapability/c2.equinox.MF (-1 / +3 lines)
17	selection-filter="(&(rank>=200)(!(rank>=300))	17	selection-filter="(&(rank>=200)(!(rank>=300))
18	(percent>=0.2)(!(percent>=0.3))	18	(percent>=0.2)(!(percent>=0.3))
19	(test.version>=2.0)(!(test.version>=3.0))	19	(test.version>=2.0)(!(test.version>=3.0))
20	(test.string~=abc))"	20	(test.string~=abc))",
		21	*:osgi.identity;
		22	selection-filter="(&(osgi.identity=p2.*)(version=1.0)(type=osgi.bundle))"

Lines 17-20 Link Here

(-)test_files/genericCapability/c2.equinox.name.MF (-1 / +3 lines)
17	selection-filter="(&(rank>=200)(!(rank>=300))	17	selection-filter="(&(rank>=200)(!(rank>=300))
18	(percent>=0.2)(!(percent>=0.3))	18	(percent>=0.2)(!(percent>=0.3))
19	(test.version>=2.0)(!(test.version>=3.0))	19	(test.version>=2.0)(!(test.version>=3.0))
20	(test.string~=abc))"	20	(test.string~=abc))",
		21	p2.*:osgi.identity;
		22	selection-filter="(&(version=1.0)(type=osgi.bundle))"

Lines 17-20 Link Here

(-)test_files/genericCapability/c2.osgi.MF (-1 / +3 lines)
17	filter:="(&(rank>=200)(!(rank>=300))	17	filter:="(&(rank>=200)(!(rank>=300))
18	(percent>=0.2)(!(percent>=0.3))	18	(percent>=0.2)(!(percent>=0.3))
19	(test.version>=2.0)(!(test.version>=3.0))	19	(test.version>=2.0)(!(test.version>=3.0))
20	(test.string~=abc))"	20	(test.string~=abc))",
		21	osgi.identity;
		22	filter:="(&(osgi.identity=p2.*)(version=1.0)(type=osgi.bundle))"

Lines 17-20 Link Here

(-)test_files/genericCapability/c3.equinox.MF (-1 / +3 lines)
17	selection-filter="(&(rank>=300)(!(rank>=400))	17	selection-filter="(&(rank>=300)(!(rank>=400))
18	(percent>=0.3)(!(percent>=0.4))	18	(percent>=0.3)(!(percent>=0.4))
19	(test.version>=3.0)(!(test.version>=4.0))	19	(test.version>=3.0)(!(test.version>=4.0))
20	(test.string~=abc))"	20	(test.string~=abc))",
		21	*:osgi.identity;
		22	selection-filter="(&(osgi.identity=p3.*)(version=1.0)(type=osgi.bundle))"

Lines 17-20 Link Here

(-)test_files/genericCapability/c3.equinox.name.MF (-1 / +3 lines)
17	selection-filter="(&(rank>=300)(!(rank>=400))	17	selection-filter="(&(rank>=300)(!(rank>=400))
18	(percent>=0.3)(!(percent>=0.4))	18	(percent>=0.3)(!(percent>=0.4))
19	(test.version>=3.0)(!(test.version>=4.0))	19	(test.version>=3.0)(!(test.version>=4.0))
20	(test.string~=abc))"	20	(test.string~=abc))",
		21	p3.*:osgi.identity;
		22	selection-filter="(&(version=1.0)(type=osgi.bundle))"

Lines 17-20 Link Here

(-)test_files/genericCapability/c3.osgi.MF (-1 / +3 lines)
17	filter:="(&(rank>=300)(!(rank>=400))	17	filter:="(&(rank>=300)(!(rank>=400))
18	(percent>=0.3)(!(percent>=0.4))	18	(percent>=0.3)(!(percent>=0.4))
19	(test.version>=3.0)(!(test.version>=4.0))	19	(test.version>=3.0)(!(test.version>=4.0))
20	(test.string~=abc))"	20	(test.string~=abc))",
		21	osgi.identity;
		22	filter:="(&(osgi.identity=p3.*)(version=1.0)(type=osgi.bundle))"

Lines 3-7 Link Here

(-)test_files/genericCapability/c4.v100.osgi.MF (-1 / +2 lines)
3	Bundle-SymbolicName: c4.osgi	3	Bundle-SymbolicName: c4.osgi
4	Bundle-Version: 1.0	4	Bundle-Version: 1.0
5	Require-Capability:	5	Require-Capability:
6	namespace.5; filter:="(version=1.0)"	6	namespace.5; filter:="(version=1.0)",
		7	osgi.identity; filter:="(&(osgi.identity=p5.osgi)(version=1.0)(type=osgi.bundle))"
7	Import-Package: p6, p7	8	Import-Package: p6, p7

Lines 3-7 Link Here

(-)test_files/genericCapability/c4.v110.osgi.MF (-1 / +2 lines)
3	Bundle-SymbolicName: c4.osgi	3	Bundle-SymbolicName: c4.osgi
4	Bundle-Version: 1.1	4	Bundle-Version: 1.1
5	Require-Capability:	5	Require-Capability:
6	namespace.5; filter:="(namespace.5=test)"	6	namespace.5; filter:="(namespace.5=test)",
		7	osgi.identity; filter:="(&(osgi.identity=p5.osgi)(version=1.0)(type=osgi.bundle))"
7	Import-Package: p6; p7; version="[1.0,1.1)"	8	Import-Package: p6; p7; version="[1.0,1.1)"

Lines 3-7 Link Here

(-)test_files/genericCapability/c4.v120.osgi.MF (-1 / +2 lines)
3	Bundle-SymbolicName: c4.osgi	3	Bundle-SymbolicName: c4.osgi
4	Bundle-Version: 1.2	4	Bundle-Version: 1.2
5	Require-Capability:	5	Require-Capability:
6	namespace.5; filter:="(version=1.0)"	6	namespace.5; filter:="(version=1.0)",
		7	osgi.identity; filter:="(&(osgi.identity=p5.osgi)(version=1.0)(type=osgi.bundle))"
7	DynamicImport-Package: p6, p7	8	DynamicImport-Package: p6, p7

Lines 3-7 Link Here

(-)test_files/genericCapability/c4.v130.osgi.MF (-1 / +2 lines)
3	Bundle-SymbolicName: c4.osgi	3	Bundle-SymbolicName: c4.osgi
4	Bundle-Version: 1.3	4	Bundle-Version: 1.3
5	Require-Capability:	5	Require-Capability:
6	namespace.5; filter:="(version=1.0)"	6	namespace.5; filter:="(version=1.0)",
		7	osgi.identity; filter:="(&(osgi.identity=p5.osgi)(version=1.0)(type=osgi.bundle))"
7	Require-Bundle: p6.osgi, p7.osgi	8	Require-Bundle: p6.osgi, p7.osgi

Return to bug 349618

Lines 1333-1339 Link Here

(-)resolver/src/org/eclipse/osgi/internal/module/ResolverImpl.java (-9 / +20 lines)
1333	if (namespace == null)	1333	if (namespace == null)
1334	capabilities = Collections.EMPTY_LIST;	1334	capabilities = Collections.EMPTY_LIST;
1335	else	1335	else
1336	capabilities = name == null \|\| "*".equals(name) ? namespace.getAllValues() : namespace.get(name); //$NON-NLS-1$	1336	capabilities = name == null \|\| name.indexOf('*') >= 0 ? namespace.getAllValues() : namespace.get(name);
1337	List<GenericCapability> candidates = new ArrayList<GenericCapability>(capabilities);	1337	List<GenericCapability> candidates = new ArrayList<GenericCapability>(capabilities);
1338	List<BundleCapability> genCapabilities = new ArrayList<BundleCapability>(candidates.size());	1338	List<BundleCapability> genCapabilities = new ArrayList<BundleCapability>(candidates.size());
1339	// Must remove candidates that do not match before calling hooks.	1339	// Must remove candidates that do not match before calling hooks.
Lines 1359-1372 Link Here
1359	result = true; // Wired to ourselves	1359	result = true; // Wired to ourselves
1360	continue;	1360	continue;
1361	}	1361	}
1362	ResolverBundle supplier = capability.getResolverBundle();	1362	VersionSupplier[] capabilityHosts = capability.getResolverBundle().isFragment() ? capability.getResolverBundle().getHost().getPossibleSuppliers() : new ResolverBundle[] {capability.getResolverBundle()};
1363	// if in dev mode then allow a constraint to resolve to an unresolved bundle	1363	boolean foundResolvedMatch = false;
1364	if (supplier.getState() == ResolverBundle.RESOLVED \|\| (resolveBundle(supplier, cycle) \|\| developmentMode)) {	1364	for (int i = 0; capabilityHosts != null && i < capabilityHosts.length; i++) {
1365	// Check cyclic dependencies	1365	ResolverBundle capabilitySupplier = capabilityHosts[i].getResolverBundle();
1366	if (supplier.getState() == ResolverBundle.RESOLVING)	1366	if (capabilitySupplier == constraint.getBundle()) {
1367	if (!cycle.contains(supplier))	1367	// the capability is from a fragment attached to this host do not recursively resolve the host again
1368	cycle.add(supplier);	1368	foundResolvedMatch = true;
1369	} else {	1369	continue;
		1370	}
		1371	// if in dev mode then allow a constraint to resolve to an unresolved bundle
		1372	if (capabilitySupplier.getState() == ResolverBundle.RESOLVED \|\| (resolveBundle(capabilitySupplier, cycle) \|\| developmentMode)) {
		1373	foundResolvedMatch \|= !capability.getResolverBundle().isFragment() ? true : capability.getResolverBundle().getHost().getPossibleSuppliers() != null;
		1374	// Check cyclic dependencies
		1375	if (capabilitySupplier.getState() == ResolverBundle.RESOLVING)
		1376	if (!cycle.contains(capabilitySupplier))
		1377	cycle.add(capabilitySupplier);
		1378	}
		1379	}
		1380	if (!foundResolvedMatch) {
1370	constraint.removePossibleSupplier(capability);	1381	constraint.removePossibleSupplier(capability);
1371	continue; // constraint hasn't resolved	1382	continue; // constraint hasn't resolved
1372	}	1383	}

Lines 18-32 Link Here

(-)osgi/src/org/osgi/framework/wiring/BundleCapability.java (-2 / +5 lines)
18		18
19	import java.util.Map;	19	import java.util.Map;
20		20
		21
21	/**	22	/**
22	* A capability that has been declared from a {@link BundleRevision bundle	23	* A capability that has been declared from a {@link BundleRevision bundle
23	* revision}.	24	* revision}.
24	*	25	*
25	* @ThreadSafe	26	* @ThreadSafe
26	* @noimplement	27	* @noimplement
27	* @version $Id: 0fde13c3228af1aa97872b37ccf0aa6e23123b11 $	28	* @version $Id: 6bbc1e645f927531d40fb245c95f5d26ad189db3 $
28	*/	29	*/
29	public interface BundleCapability {	30	public interface BundleCapability extends Capability{
30	/**	31	/**
31	* Returns the name space of this capability.	32	* Returns the name space of this capability.
32	*	33	*
Lines 58-61 Link Here
58	* @return The bundle revision declaring this capability.	59	* @return The bundle revision declaring this capability.
59	*/	60	*/
60	BundleRevision getRevision();	61	BundleRevision getRevision();
		62
		63	BundleRevision getResource();
61	}	64	}

Lines 16-29 Link Here

(-)osgi/src/org/osgi/framework/wiring/BundleWire.java (-2 / +13 lines)
16		16
17	package org.osgi.framework.wiring;	17	package org.osgi.framework.wiring;
18		18
		19
19	/**	20	/**
20	* A wire connecting a {@link BundleCapability} to a {@link BundleRequirement}.	21	* A wire connecting a {@link BundleCapability} to a {@link BundleRequirement}.
21	*	22	*
22	* @ThreadSafe	23	* @ThreadSafe
23	* @noimplement	24	* @noimplement
24	* @version $Id: 4f936a84065762ec3267a44f86ae01b0150e44ce $	25	* @version $Id: aca8642cea91995d0b178129cba1131ed327c7e7 $
25	*/	26	*/
26	public interface BundleWire {	27	public interface BundleWire extends Wire {
27	/**	28	/**
28	* Returns the {@link BundleCapability} for this wire.	29	* Returns the {@link BundleCapability} for this wire.
29	*	30	*
Lines 69-72 Link Here
69	* returned.	70	* returned.
70	*/	71	*/
71	BundleWiring getRequirerWiring();	72	BundleWiring getRequirerWiring();
		73
		74	/**
		75	* {@inheritDoc}
		76	*/
		77	BundleRevision getProvider();
		78
		79	/**
		80	* {@inheritDoc}
		81	*/
		82	BundleRevision getRequirer();
72	}	83	}

Lines 83-91 Link Here

(-)osgi/src/org/osgi/framework/wiring/BundleWiring.java (-2 / +9 lines)
83	* <p>	83	* <p>
84	* A bundle wiring for a non-fragment revision provides a subset of the	84	* A bundle wiring for a non-fragment revision provides a subset of the
85	* declared capabilities from the bundle revision and all attached fragment	85	* declared capabilities from the bundle revision and all attached fragment
86	* revisions. Not all declared capabilities may be provided since some may	86	* revisions<sup>†</sup>. Not all declared capabilities may be provided since some may
87	* be discarded. For example, if a package is declared to be exported and	87	* be discarded. For example, if a package is declared to be exported and
88	* import, only one is selected and the other is discarded.	88	* import, only one is selected and the other is discarded.
		89	* <p>
		90	* A bundle wiring for a fragment revision with a symbolic name must
		91	* provide exactly one {@link ResourceConstants#IDENTITY_NAMESPACE identity} capability.
		92	* <p>
		93	* † The {@link ResourceConstants#IDENTITY_NAMESPACE identity} capability
		94	* provided by attached fragment revisions must not be included in the capabilities of the
		95	* host bundle wiring.
89	*	96	*
90	* @param namespace The name space of the capabilities to return or	97	* @param namespace The name space of the capabilities to return or
91	* {@code null} to return the capabilities from all name spaces.	98	* {@code null} to return the capabilities from all name spaces.
Lines 95-101 Link Here
95	* {@link #isInUse() in use}, {@code null} will be returned. For a	102	* {@link #isInUse() in use}, {@code null} will be returned. For a
96	* given name space, the list contains the wires in the order the	103	* given name space, the list contains the wires in the order the
97	* capabilities were specified in the manifests of the	104	* capabilities were specified in the manifests of the
98	* {@link #getRevision() bundle revision} and the attached fragments	105	* {@link #getRevision() bundle revision} and the attached fragments<sup>†</sup>
99	* of this bundle wiring. There is no ordering defined between	106	* of this bundle wiring. There is no ordering defined between
100	* capabilities in different name spaces.	107	* capabilities in different name spaces.
101	*/	108	*/

Added Link Here

(-)osgi/src/org/osgi/framework/wiring/Capability.java (+82 lines)
1	/*
2	* Copyright (c) OSGi Alliance (2010, 2011). All Rights Reserved.
3	*
4	* Licensed under the Apache License, Version 2.0 (the "License");
5	* you may not use this file except in compliance with the License.
6	* You may obtain a copy of the License at
7	*
8	* http://www.apache.org/licenses/LICENSE-2.0
9	*
10	* Unless required by applicable law or agreed to in writing, software
11	* distributed under the License is distributed on an "AS IS" BASIS,
12	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13	* See the License for the specific language governing permissions and
14	* limitations under the License.
15	*/
16
17	package org.osgi.framework.wiring;
18
19	import java.util.Map;
20
21	/**
22	* A capability that has been declared from a {@link Resource}.
23	*
24	* @ThreadSafe
25	* @version $Id: f8bd10002691537806e4bc3cf08f3fce37510121 $
26	*/
27	public interface Capability {
28
29	/**
30	* Returns the name space of this capability.
31	*
32	* @return The name space of this capability.
33	*/
34	String getNamespace();
35
36	/**
37	* Returns the directives of this capability. Only the following list of
38	* directives have semantic meaning in the returned {@link Map map} of
39	* directives:
40	* <ul>
41	* <li> {@link ResourceConstants#CAPABILITY_EFFECTIVE_DIRECTIVE effective}
42	* <li> {@link ResourceConstants#CAPABILITY_USES_DIRECTIVE uses}
43	* <li> {@link ResourceConstants#CAPABILITY_MANDATORY_DIRECTIVE mandatory} -
44	* only recognized for the
45	* {@link ResourceConstants#WIRING_BUNDLE_NAMESPACE osgi.wiring.bundle} and
46	* {@link ResourceConstants#WIRING_PACKAGE_NAMESPACE osgi.wiring.package}
47	* name spaces.
48	* <li> {@link ResourceConstants#CAPABILITY_EXCLUDE_DIRECTIVE exclude} -
49	* only recognized for the
50	* {@link ResourceConstants#WIRING_PACKAGE_NAMESPACE osgi.wiring.package}
51	* name space.
52	* <li> {@link ResourceConstants#CAPABILITY_INCLUDE_DIRECTIVE include} -
53	* only recognized for the
54	* {@link ResourceConstants#WIRING_PACKAGE_NAMESPACE osgi.wiring.package}
55	* name space.
56	* </ul>
57	* All other directive are considered extra user defined information that
58	* has no semantic meaning. OSGi Alliance reserves the right to extend the
59	* set of directives which have semantic meaning.
60	*
61	* @return An unmodifiable map of directive names to directive values for
62	* this capability, or an empty map if this capability has no
63	* directives.
64	*/
65	Map<String, String> getDirectives();
66
67	/**
68	* Returns the attributes of this capability.
69	*
70	* @return An unmodifiable map of attribute names to attribute values for
71	* this capability, or an empty map if this capability has no
72	* attributes.
73	*/
74	Map<String, Object> getAttributes();
75
76	/**
77	* The resource that declares this capability.
78	*
79	* @return the resource
80	*/
81	Resource getResource();
82	}

Added Link Here

(-)osgi/src/org/osgi/framework/wiring/Requirement.java (+105 lines)
1	/*
2	* Copyright (c) OSGi Alliance (2010, 2011). All Rights Reserved.
3	*
4	* Licensed under the Apache License, Version 2.0 (the "License");
5	* you may not use this file except in compliance with the License.
6	* You may obtain a copy of the License at
7	*
8	* http://www.apache.org/licenses/LICENSE-2.0
9	*
10	* Unless required by applicable law or agreed to in writing, software
11	* distributed under the License is distributed on an "AS IS" BASIS,
12	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13	* See the License for the specific language governing permissions and
14	* limitations under the License.
15	*/
16
17	package org.osgi.framework.wiring;
18
19	import java.util.Map;
20
21	import org.osgi.framework.Constants;
22
23	/**
24	* A requirement that has been declared from a {@link Resource} .
25	*
26	* @ThreadSafe
27	* @version $Id: 3a6b0afb063fa288c07b68e0de742af291f869cc $
28	*/
29	public interface Requirement {
30	/**
31	* Returns the name space of this requirement.
32	*
33	* @return The name space of this requirement.
34	*/
35	String getNamespace();
36
37	/**
38	* Returns the directives of this requirement. Only the following list of
39	* directives have semantic meaning in the returned {@link Map map} of
40	* directives:
41	* <ul>
42	* <li> {@link ResourceConstants#REQUIREMENT_EFFECTIVE_DIRECTIVE effective}
43	* <li> {@link ResourceConstants#REQUIREMENT_FILTER_DIRECTIVE filter}
44	* <li> {@link ResourceConstants#REQUIREMENT_CARDINALITY_DIRECTIVE
45	* cardinality}
46	* <li> {@link ResourceConstants#REQUIREMENT_RESOLUTION_DIRECTIVE resolution}
47	* <li> {@link ResourceConstants#REQUIREMENT_VISIBILITY_DIRECTIVE visibility}
48	* - only recognized for the
49	* {@link ResourceConstants#WIRING_BUNDLE_NAMESPACE osgi.wiring.bundle} name
50	* space.
51	* </ul>
52	* All other directive are considered extra user defined information that
53	* has no semantic meaning. OSGi Alliance reserves the right to extend the
54	* set of directives which have semantic meaning.
55	*
56	* @return An unmodifiable map of directive names to directive values for
57	* this requirement, or an empty map if this requirement has no
58	* directives.
59	*/
60	Map<String, String> getDirectives();
61
62	/**
63	* Returns the attributes of this requirement. Requirement attributes have
64	* no semantic meaning and are considered extra user defined information.
65	*
66	* @return An unmodifiable map of attribute names to attribute values for
67	* this requirement, or an empty map if this requirement has no
68	* attributes.
69	*/
70	Map<String, Object> getAttributes();
71
72	/**
73	* Returns the resource declaring this requirement. If there is no resource
74	* declaring this requirement, {@code null} is returned.
75	*
76	* @return The resource declaring this requirement, if any.
77	*/
78	Resource getResource();
79
80	/**
81	* Returns whether the specified capability matches this requirement. A
82	* capability matches this requirement when all of the following are true:
83	* <ul>
84	* <li>The specified capability has the same {@link #getNamespace() name
85	* space} as this requirement.
86	* <li>The filter specified by the {@link Constants#FILTER_DIRECTIVE filter}
87	* directive of this requirement matches the
88	* {@link Capability#getAttributes() attributes of the specified capability}.
89	* <li>The {@link #getDirectives() requirement directives} and the
90	* {@link Capability#getDirectives() capability directives} that apply to
91	* the name space are satisfied.
92	* </ul>
93	*
94	*
95	* @param capability
96	* The capability to match to this requirement.
97	* @return {@code true} if the specified capability matches this this
98	* requirement. {@link #getNamespace() name space} as this
99	* requirement and the filter for this requirement matches the
100	* {@link BundleCapability#getAttributes() attributes of the
101	* specified capability}; {@code false} otherwise.
102	*/
103	// TODO much debate on the placement and need for this method.
104	boolean matches(Capability capability);
105	}

Added Link Here

(-)osgi/src/org/osgi/framework/wiring/Resource.java (+46 lines)
1	package org.osgi.framework.wiring;
2
3	import java.util.List;
4
5
6	/**
7	* A resource is the representation of a uniquely identified and typed data.
8	*
9	* A resources can be wired together via capabilities and requirements.
10	*
11	* TODO decide on identity characteristics of a revision. Given in OSGi multiple
12	* bundles can be installed with same bsn/version this cannot be used as a key.
13	*
14	* What then is identity of a resource? Object identity? URI (needs getter
15	* method?)
16	*
17	* @ThreadSafe
18	* @version $Id: ec3a00454c760f49059b1890f5212e528e65926e $
19	*/
20	public interface Resource {
21	/**
22	* Returns the capabilities declared by this resource.
23	*
24	* @param namespace
25	* The name space of the declared capabilities to return or
26	* {@code null} to return the declared capabilities from all name
27	* spaces.
28	* @return A list containing a snapshot of the declared {@link Capability}s,
29	* or an empty list if this resource declares no capabilities in the
30	* specified name space.
31	*/
32	List<Capability> getCapabilities(String namespace);
33
34	/**
35	* Returns the requirements declared by this bundle resource.
36	*
37	* @param namespace
38	* The name space of the declared requirements to return or
39	* {@code null} to return the declared requirements from all name
40	* spaces.
41	* @return A list containing a snapshot of the declared {@link Requirement}
42	* s, or an empty list if this resource declares no requirements in
43	* the specified name space.
44	*/
45	List<Requirement> getRequirements(String namespace);
46	}

Added Link Here

(-)osgi/src/org/osgi/framework/wiring/ResourceConstants.java (+372 lines)
1	/*
2	* Copyright (c) OSGi Alliance (2011). All Rights Reserved.
3	*
4	* Licensed under the Apache License, Version 2.0 (the "License");
5	* you may not use this file except in compliance with the License.
6	* You may obtain a copy of the License at
7	*
8	* http://www.apache.org/licenses/LICENSE-2.0
9	*
10	* Unless required by applicable law or agreed to in writing, software
11	* distributed under the License is distributed on an "AS IS" BASIS,
12	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13	* See the License for the specific language governing permissions and
14	* limitations under the License.
15	*/
16	package org.osgi.framework.wiring;
17
18	import org.osgi.framework.Constants;
19	import org.osgi.framework.Version;
20
21	/**
22	* Defines standard names for the attributes, directives and name spaces for
23	* resources, capabilities and requirements.
24	*
25	* <p>
26	* The values associated with these keys are of type {@code String}, unless
27	* otherwise indicated.
28	*
29	* @version $Id: 6a0df41f82a587eb72c0c513fdd0411f18564586 $
30	*/
31	public final class ResourceConstants {
32
33	private ResourceConstants() {
34	// keep others from creating objects of this type.
35	}
36
37	/**
38	* Name space for the identity capability. Each {@link Resource resource}
39	* provides exactly one<sup>†</sup> identity capability that can be
40	* used to identify the resource.
41	*
42	* For identity capability attributes the following applies:
43	* <ul>
44	* <li>The
45	* <q>osgi.identity</q> attribute contains the symbolic name of the
46	* resource.
47	* <li>The {@link #IDENTITY_VERSION_ATTRIBUTE version} attribute contains
48	* the {@link Version} of the resource.
49	* <li>The {@link #IDENTITY_TYPE_ATTRIBUTE type} attribute contains the
50	* resource type.
51	* </ul>
52	* <p>
53	* A resource with a symbolic name
54	* {@link Resource#getCapabilities(String) provides} exactly one
55	* <sup>†</sup> identity
56	* {@link Resource#getCapabilities(String) capability}.
57	* <p>
58	* For a {@link BundleRevision revision} with a symbolic name the
59	* {@link BundleWiring wiring} for the revision
60	* {@link BundleWiring#getCapabilities(String) provides} exactly
61	* one<sup>†</sup> identity capability.
62	* <p>
63	* † A resource with no symbolic name must not provide an identity
64	* capability.
65	*/
66	public static final String IDENTITY_NAMESPACE = "osgi.identity";
67
68	/**
69	* An {@link #IDENTITY_NAMESPACE identity} capability attribute identifying the
70	* {@link Version version} of the resource. This attribute must be set to a value of
71	* type {@link Version}. If the resource has no version then the value
72	* {@link Version#emptyVersion 0.0.0} must be used for the attribute.
73	*/
74	public static final String IDENTITY_VERSION_ATTRIBUTE = Constants.VERSION_ATTRIBUTE;
75
76	/**
77	* An {@link #IDENTITY_NAMESPACE identity} capability attribute identifying the
78	* resource type. This attribute must be set to a value of type {@link String}.
79	* if the resource has no type then the value
80	* {@link ResourceConstants#IDENTITY_TYPE_UNKNOWN unknown} must be used for the
81	* attribute.
82	*/
83	public static final String IDENTITY_TYPE_ATTRIBUTE = "type";
84
85	/**
86	* An {@link #IDENTITY_NAMESPACE identity} capability {@link #IDENTITY_TYPE_ATTRIBUTE type}
87	* attribute value identifying the resource type as an OSGi bundle.
88	*/
89	public static final String IDENTITY_TYPE_BUNDLE = "osgi.bundle";
90
91	/**
92	* An {@link #IDENTITY_NAMESPACE identity} capability {@link #IDENTITY_TYPE_ATTRIBUTE type}
93	* attribute value identifying the resource type as an OSGi fragment.
94	*/
95	public static final String IDENTITY_TYPE_FRAGMENT = "osgi.fragment";
96
97	/**
98	* An {@link #IDENTITY_NAMESPACE identity} capability {@link #IDENTITY_TYPE_ATTRIBUTE type}
99	* attribute value identifying the resource type as unknown.
100	*/
101	public static final String IDENTITY_TYPE_UNKNOWN = "unknown";
102
103	/**
104	* An {@link #IDENTITY_NAMESPACE identity} capability {@link Requirement#getDirectives() directive}
105	* identifying if the resource is a singleton. A {@link String} value of "true" indicates
106	* the resource is a singleton; any other value or <code>null</code> indicates the resource is not a
107	* singleton.
108	*/
109	public static final String IDENTITY_SINGLETON_DIRECTIVE = Constants.SINGLETON_DIRECTIVE;
110
111	/**
112	* Name space for package capabilities and requirements.
113	*
114	* For capability attributes the following applies:
115	* <ul>
116	* <li>The
117	* <q>osgi.wiring.package</q> attribute contains the name of the package.
118	* <li>The {@link Constants#VERSION_ATTRIBUTE version} attribute contains
119	* the the {@link Version} of the package if one is specified or
120	* {@link Version#emptyVersion} if not specified.
121	* <li>The {@link Constants#BUNDLE_SYMBOLICNAME_ATTRIBUTE
122	* bundle-symbolic-name} attribute contains the symbolic name of the
123	* resource providing the package if one is specified.
124	* <li>The {@link Constants#BUNDLE_VERSION_ATTRIBUTE bundle-version}
125	* attribute contains the {@link Version} of resource providing the package
126	* if one is specified or {@link Version#emptyVersion} if not specified.
127	* <li>All other attributes are of type {@link String} and are used as
128	* arbitrary matching attributes for the capability.
129	* </ul>
130	* <p>
131	* A resource provides zero or more package
132	* {@link Resource#getCapabilities(String) capabilities} (this is, exported
133	* packages) and requires zero or more package
134	* {@link Resource#getRequirements(String) requirements} (that is, imported
135	* packages).
136	*/
137	public static final String WIRING_PACKAGE_NAMESPACE = "osgi.wiring.package";
138
139	/**
140	* Name space for bundle capabilities and requirements.
141	*
142	* For capability attributes the following applies:
143	* <ul>
144	* <li>The
145	* <q>osgi.wiring.bundle</q> attribute contains the symbolic name of the
146	* bundle.
147	* <li>The {@link Constants#BUNDLE_VERSION_ATTRIBUTE bundle-version}
148	* attribute contains the {@link Version} of the bundle if one is specified
149	* or {@link Version#emptyVersion} if not specified.
150	* <li>All other attributes are of type {@link String} and are used as
151	* arbitrary matching attributes for the capability.
152	* </ul>
153	* <p>
154	* A non-fragment resource with the {@link #IDENTITY_TYPE_BUNDLE
155	* osgi.bundle} type {@link #IDENTITY_TYPE_ATTRIBUTE identity} provides
156	* exactly one <sup>†</sup> bundle
157	* {@link Resource#getCapabilities(String) capability} (that is, the bundle
158	* can be required by another bundle). A fragment resource with the
159	* {@link #IDENTITY_TYPE_FRAGMENT osgi.fragment} type
160	* {@link #IDENTITY_TYPE_ATTRIBUTE identity} must not declare
161	* a bundle capability. A resource requires zero or more bundle
162	* {@link Resource#getRequirements(String) requirements} (that is, required
163	* bundles).
164	* <p>
165	* † A resource with no symbolic name must not provide a bundle
166	* capability.
167	*/
168	public static final String WIRING_BUNDLE_NAMESPACE = "osgi.wiring.bundle";
169
170	/**
171	* Name space for host capabilities and requirements.
172	*
173	* For capability attributes the following applies:
174	* <ul>
175	* <li>The
176	* <q>osgi.wiring.host</q> attribute contains the symbolic name of the
177	* bundle.
178	* <li>The {@link Constants#BUNDLE_VERSION_ATTRIBUTE bundle-version}
179	* attribute contains the {@link Version} of the bundle if one is specified
180	* or {@link Version#emptyVersion} if not specified.
181	* <li>All other attributes are of type {@link String} and are used as
182	* arbitrary matching attributes for the capability.
183	* </ul>
184	* <p>
185	* <p>
186	* A non-fragment resource with the with the {@link #IDENTITY_TYPE_BUNDLE
187	* osgi.bundle} type {@link #IDENTITY_TYPE_ATTRIBUTE identity} provides
188	* zero or one <sup>†</sup> host
189	* {@link Resource#getCapabilities(String) capabilities}.
190	* A fragment resource with the
191	* {@link #IDENTITY_TYPE_FRAGMENT osgi.fragment} type
192	* {@link #IDENTITY_TYPE_ATTRIBUTE identity} must not declare
193	* a host capability and must
194	* {@link Resource#getRequirements(String) declare} exactly one host
195	* requirement.
196	* <p>
197	* † A resource with no bundle symbolic name must not provide a host
198	* capability.
199	*/
200	public static final String WIRING_HOST_NAMESPACE = "osgi.wiring.host";
201
202	/**
203	* A requirement {@link Requirement#getDirectives() directive} used to
204	* specify a capability filter. This filter is used to match against a
205	* capability's {@link Capability#getAttributes() attributes}.
206	*/
207	public final static String REQUIREMENT_FILTER_DIRECTIVE = Constants.FILTER_DIRECTIVE;
208
209	/**
210	* A requirement {@link Requirement#getDirectives() directive} used to
211	* specify the resolution type for a requirement. The default value is
212	* {@link #REQUIREMENT_RESOLUTION_MANDATORY mandatory}.
213	*
214	* @see #REQUIREMENT_RESOLUTION_MANDATORY mandatory
215	* @see #REQUIREMENT_RESOLUTION_OPTIONAL optional
216	*/
217	public final static String REQUIREMENT_RESOLUTION_DIRECTIVE = Constants.RESOLUTION_DIRECTIVE;
218	/**
219	* A directive value identifying a mandatory
220	* {@link Resource#getRequirements(String) requirement} resolution type. A
221	* mandatory resolution type indicates that the requirement must be resolved
222	* when the {@link Resource resource} is resolved. If such requirement
223	* cannot be resolved, the resource fails to resolve.
224	*
225	* @see #REQUIREMENT_RESOLUTION_DIRECTIVE
226	*/
227	public final static String REQUIREMENT_RESOLUTION_MANDATORY = Constants.RESOLUTION_MANDATORY;
228
229	/**
230	* A directive value identifying an optional
231	* {@link Resource#getRequirements(String) requirement} resolution type. An
232	* optional resolution type indicates that the requirement is optional and
233	* the {@link Resource resource} may be resolved without requirement being
234	* resolved.
235	*
236	* @see #REQUIREMENT_RESOLUTION_DIRECTIVE
237	*/
238	public final static String REQUIREMENT_RESOLUTION_OPTIONAL = Constants.RESOLUTION_OPTIONAL;
239
240	/**
241	* A requirement {@link Requirement#getDirectives() directive} used to
242	* specify the effective time for the requirement. The default value is
243	* {@link #EFFECTIVE_RESOLVE resolve}.
244	*
245	* @see #EFFECTIVE_RESOLVE resolve
246	* @see #EFFECTIVE_ACTIVE active
247	*/
248	public final static String REQUIREMENT_EFFECTIVE_DIRECTIVE = Constants.EFFECTIVE_DIRECTIVE;
249
250	/**
251	* A directive value identifying a {@link #CAPABILITY_EFFECTIVE_DIRECTIVE
252	* capability} or {@link #REQUIREMENT_EFFECTIVE_DIRECTIVE requirement} that
253	* is effective at resolve time. Capabilities and requirements with an
254	* effective time of resolve are the only capabilities which are processed
255	* while resolving a resource.
256	*
257	* @see #REQUIREMENT_EFFECTIVE_DIRECTIVE
258	* @see #CAPABILITY_EFFECTIVE_DIRECTIVE
259	*/
260	public final static String EFFECTIVE_RESOLVE = Constants.EFFECTIVE_RESOLVE;
261
262	/**
263	* A directive value identifying a {@link #CAPABILITY_EFFECTIVE_DIRECTIVE
264	* capability} or {@link #REQUIREMENT_EFFECTIVE_DIRECTIVE requirement} that
265	* is effective at active time. Capabilities and requirements with an
266	* effective time of active are ignored while resolving a resource.
267	*
268	* @see #REQUIREMENT_EFFECTIVE_DIRECTIVE
269	* @see #CAPABILITY_EFFECTIVE_DIRECTIVE
270	*/
271	public final static String EFFECTIVE_ACTIVE = Constants.EFFECTIVE_ACTIVE;
272
273	/**
274	* A requirement {@link Requirement#getDirectives() directive} used to
275	* specify the visibility type for a requirement. The default value is
276	* {@link #REQUIREMENT_VISIBILITY_PRIVATE private}. This directive must only
277	* be used for requirements with the require
278	* {@link #WIRING_BUNDLE_NAMESPACE bundle} name space.
279	*
280	* @see #REQUIREMENT_VISIBILITY_PRIVATE private
281	* @see #REQUIREMENT_VISIBILITY_REEXPORT reexport
282	*/
283	public final static String REQUIREMENT_VISIBILITY_DIRECTIVE = Constants.VISIBILITY_DIRECTIVE;
284
285	/**
286	* A directive value identifying a private
287	* {@link #REQUIREMENT_VISIBILITY_DIRECTIVE visibility} type. A private
288	* visibility type indicates that any {@link #WIRING_PACKAGE_NAMESPACE
289	* packages} that are exported by the required
290	* {@link #WIRING_BUNDLE_NAMESPACE bundle} are not made visible on the
291	* export signature of the requiring {@link #WIRING_BUNDLE_NAMESPACE bundle}
292	* .
293	*
294	* @see #REQUIREMENT_VISIBILITY_DIRECTIVE
295	*/
296	public final static String REQUIREMENT_VISIBILITY_PRIVATE = Constants.VISIBILITY_PRIVATE;
297
298	/**
299	* A directive value identifying a reexport
300	* {@link #REQUIREMENT_VISIBILITY_DIRECTIVE visibility} type. A reexport
301	* visibility type indicates any {@link #WIRING_PACKAGE_NAMESPACE packages}
302	* that are exported by the required {@link #WIRING_BUNDLE_NAMESPACE bundle}
303	* are re-exported by the requiring {@link #WIRING_BUNDLE_NAMESPACE bundle}.
304	*/
305	public final static String REQUIREMENT_VISIBILITY_REEXPORT = Constants.VISIBILITY_REEXPORT;
306
307	/**
308	* A requirement {@link Requirement#getDirectives() directive} used to
309	* specify the cardinality for a requirement. The default value is
310	* {@link #REQUIREMENT_CARDINALITY_SINGULAR singular}.
311	*
312	* @see #REQUIREMENT_CARDINALITY_MULTIPLE multiple
313	* @see #REQUIREMENT_CARDINALITY_SINGULAR singular
314	*/
315	public final static String REQUIREMENT_CARDINALITY_DIRECTIVE = "cardinality";
316
317	/**
318	* A directive value identifying a multiple
319	* {@link #REQUIREMENT_CARDINALITY_DIRECTIVE cardinality} type.
320	*/
321	public final static String REQUIREMENT_CARDINALITY_MULTIPLE = "multiple";
322
323	/**
324	* A directive value identifying a singular
325	* {@link #REQUIREMENT_CARDINALITY_DIRECTIVE cardinality} type.
326	*/
327	public final static String REQUIREMENT_CARDINALITY_SINGULAR = "singular";
328
329
330	/**
331	* A capability {@link Capability#getDirectives() directive} used to specify
332	* the comma separated list of {@link #WIRING_PACKAGE_NAMESPACE package}
333	* names a capability uses.
334	*/
335	public final static String CAPABILITY_USES_DIRECTIVE = Constants.USES_DIRECTIVE;
336
337	/**
338	* A capability {@link Capability#getDirectives() directive} used to specify
339	* the effective time for the capability. The default value is
340	* {@link #EFFECTIVE_RESOLVE resolve}.
341	*
342	* @see #EFFECTIVE_RESOLVE resolve
343	* @see #EFFECTIVE_ACTIVE active
344	*/
345	public final static String CAPABILITY_EFFECTIVE_DIRECTIVE = Constants.EFFECTIVE_DIRECTIVE;
346
347	/**
348	* A capability {@link Capability#getDirectives() directive} used to specify
349	* the comma separated list of mandatory attributes which must be specified
350	* in the {@link #REQUIREMENT_FILTER_DIRECTIVE filter} of a requirement in
351	* order for the capability to match the requirement. This directive must
352	* only be used for capabilities with the {@link #WIRING_PACKAGE_NAMESPACE
353	* package} name space.
354	*/
355	public final static String CAPABILITY_MANDATORY_DIRECTIVE = "mandatory";
356
357	/**
358	* A capability {@link Capability#getDirectives() directive} used to specify
359	* the comma separated list of classes which must be allowed to be exported.
360	* This directive must only be used for capabilities with the
361	* {@link #WIRING_PACKAGE_NAMESPACE package} name space.
362	*/
363	public final static String CAPABILITY_INCLUDE_DIRECTIVE = "include";
364
365	/**
366	* A capability {@link Capability#getDirectives() directive} used to specify
367	* the comma separated list of classes which must not be allowed to be
368	* exported. This directive must only be used for capabilities with the
369	* {@link #WIRING_PACKAGE_NAMESPACE package} name space.
370	*/
371	public final static String CAPABILITY_EXCLUDE_DIRECTIVE = "exclude";
372	}

Added Link Here

(-)osgi/src/org/osgi/framework/wiring/Wire.java (+57 lines)
1	/*
2	* Copyright (c) OSGi Alliance (2011). All Rights Reserved.
3	*
4	* Licensed under the Apache License, Version 2.0 (the "License");
5	* you may not use this file except in compliance with the License.
6	* You may obtain a copy of the License at
7	*
8	* http://www.apache.org/licenses/LICENSE-2.0
9	*
10	* Unless required by applicable law or agreed to in writing, software
11	* distributed under the License is distributed on an "AS IS" BASIS,
12	* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13	* See the License for the specific language governing permissions and
14	* limitations under the License.
15	*/
16
17	package org.osgi.framework.wiring;
18
19	/**
20	* A wire connecting a {@link Capability} to a {@link Requirement}.
21	*
22	* @ThreadSafe
23	* @version $Id: 328ede0f8ddf3795594a8e0fc2cb11bbe7fa38fc $
24	*/
25	public interface Wire {
26	/**
27	* Returns the {@link Capability} for this wire.
28	*
29	* @return The {@link Capability} for this wire.
30	*/
31	Capability getCapability();
32
33	/**
34	* Return the {@link Requirement} for this wire.
35	*
36	* @return The {@link Requirement} for this wire.
37	*/
38	Requirement getRequirement();
39
40	/**
41	* Return the providing {@link Resource resource} of the {@link #getCapability() capability}.
42	* <p>
43	* The resource returned may differ from the resource referenced by the {@link #getCapability()
44	* capability}.
45	* @return the providing {@link Resource resource}.
46	*/
47	Resource getProvider();
48
49	/**
50	* Return the requiring {@link Resource resource} of the {@link #getRequirement() requirement}.
51	* <p>
52	* The resource returned my differ from the resource referenced by the {@link #getRequirement()
53	* requirement}
54	* @return the requiring {@link Resource resource}.
55	*/
56	Resource getRequirer();
57	}

Lines 91-97 Link Here

(-)resolver/src/org/eclipse/osgi/internal/resolver/BundleSpecificationImpl.java (-3 / +11 lines)
91	}	91	}
92	}	92	}
93	String[] mandatory = (String[]) candidate.getDirective(Constants.MANDATORY_DIRECTIVE);	93	String[] mandatory = (String[]) candidate.getDirective(Constants.MANDATORY_DIRECTIVE);
		94	if (!hasMandatoryAttributes(mandatory))
		95	return false;
		96	if (getName() != null && getName().equals(candidate.getSymbolicName()) && (getVersionRange() == null \|\| getVersionRange().isIncluded(candidate.getVersion())))
		97	return true;
		98	return false;
		99	}
		100
		101	@Override
		102	protected boolean hasMandatoryAttributes(String[] mandatory) {
94	if (mandatory != null) {	103	if (mandatory != null) {
		104	Map<String, ?> requiredAttrs = getAttributes();
95	for (String key : mandatory) {	105	for (String key : mandatory) {
96	if (Constants.BUNDLE_VERSION_ATTRIBUTE.equals(key))	106	if (Constants.BUNDLE_VERSION_ATTRIBUTE.equals(key))
97	continue; // has a default value of 0.0.0	107	continue; // has a default value of 0.0.0
Lines 99-107 Link Here
99	return false;	109	return false;
100	}	110	}
101	}	111	}
102	if (getName() != null && getName().equals(candidate.getSymbolicName()) && (getVersionRange() == null \|\| getVersionRange().isIncluded(candidate.getVersion())))	112	return true;
103	return true;
104	return false;
105	}	113	}
106		114
107	public String toString() {	115	public String toString() {

Lines 149-158 Link Here

(-)resolver/src/org/eclipse/osgi/internal/resolver/ImportPackageSpecificationImpl.java (-6 / +14 lines)
149	}	149	}
150	}	150	}
151	String[] mandatory = (String[]) pkgDes.getDirective(Constants.MANDATORY_DIRECTIVE);	151	String[] mandatory = (String[]) pkgDes.getDirective(Constants.MANDATORY_DIRECTIVE);
		152	if (!hasMandatoryAttributes(mandatory))
		153	return false;
		154	// finally check the ee index
		155	if (((BundleDescriptionImpl) getBundle()).getEquinoxEE() < 0)
		156	return true;
		157	int eeIndex = ((Integer) pkgDes.getDirective(ExportPackageDescriptionImpl.EQUINOX_EE)).intValue();
		158	return eeIndex < 0 \|\| eeIndex == ((BundleDescriptionImpl) getBundle()).getEquinoxEE();
		159	}
		160
		161	@Override
		162	protected boolean hasMandatoryAttributes(String[] mandatory) {
152	if (mandatory != null) {	163	if (mandatory != null) {
		164	Map<String, ?> importAttrs = getAttributes();
153	for (int i = 0; i < mandatory.length; i++) {	165	for (int i = 0; i < mandatory.length; i++) {
154	if (Constants.BUNDLE_SYMBOLICNAME_ATTRIBUTE.equals(mandatory[i])) {	166	if (Constants.BUNDLE_SYMBOLICNAME_ATTRIBUTE.equals(mandatory[i])) {
155	if (exporterSymbolicName == null)	167	if (getBundleSymbolicName() == null)
156	return false;	168	return false;
157	} else if (Constants.BUNDLE_VERSION_ATTRIBUTE.equals(mandatory[i])) {	169	} else if (Constants.BUNDLE_VERSION_ATTRIBUTE.equals(mandatory[i])) {
158	if (bundleVersionRange == null)	170	if (bundleVersionRange == null)
Lines 168-178 Link Here
168	}	180	}
169	}	181	}
170	}	182	}
171	// finally check the ee index	183	return true;
172	if (((BundleDescriptionImpl) getBundle()).getEquinoxEE() < 0)
173	return true;
174	int eeIndex = ((Integer) pkgDes.getDirective(ExportPackageDescriptionImpl.EQUINOX_EE)).intValue();
175	return eeIndex < 0 \|\| eeIndex == ((BundleDescriptionImpl) getBundle()).getEquinoxEE();
176	}	184	}
177		185
178	protected void setBundleSymbolicName(String symbolicName) {	186	protected void setBundleSymbolicName(String symbolicName) {

Added Link Here

(-)src/org/eclipse/osgi/tests/resource/AbstractResourceTest.java (+42 lines)
1	/*******************************************************************************
2	* Copyright (c) 2011 IBM Corporation and others.
3	* All rights reserved. This program and the accompanying materials
4	* are made available under the terms of the Eclipse Public License v1.0
5	* which accompanies this distribution, and is available at
6	* http://www.eclipse.org/legal/epl-v10.html
7	*
8	* Contributors:
9	* IBM Corporation - initial API and implementation
10	*******************************************************************************/
11	package org.eclipse.osgi.tests.resource;
12
13	import org.eclipse.osgi.tests.OSGiTest;
14	import org.eclipse.osgi.tests.OSGiTestsActivator;
15	import org.eclipse.osgi.tests.bundles.BundleInstaller;
16	import org.osgi.framework.InvalidSyntaxException;
17
18	public abstract class AbstractResourceTest extends OSGiTest {
19	protected BundleInstaller installer;
20
21	public AbstractResourceTest() {
22	super();
23	}
24
25	public AbstractResourceTest(String name) {
26	super(name);
27	}
28
29	protected void setUp() throws Exception {
30	super.setUp();
31	try {
32	installer = new BundleInstaller("bundle_tests", OSGiTestsActivator.getContext()); //$NON-NLS-1$
33	} catch (InvalidSyntaxException e) {
34	fail("Failed to create bundle installer", e); //$NON-NLS-1$
35	}
36	}
37
38	protected void tearDown() throws Exception {
39	installer.shutdown();
40	super.tearDown();
41	}
42	}

Added Link Here

(-)src/org/eclipse/osgi/tests/resource/IdentityTest.java (+384 lines)
1	/*******************************************************************************
2	* Copyright (c) 2011 IBM Corporation and others.
3	* All rights reserved. This program and the accompanying materials
4	* are made available under the terms of the Eclipse Public License v1.0
5	* which accompanies this distribution, and is available at
6	* http://www.eclipse.org/legal/epl-v10.html
7	*
8	* Contributors:
9	* IBM Corporation - initial API and implementation
10	*******************************************************************************/
11	package org.eclipse.osgi.tests.resource;
12
13	import java.util.List;
14	import junit.framework.*;
15	import org.osgi.framework.Bundle;
16	import org.osgi.framework.Version;
17	import org.osgi.framework.wiring.*;
18
19	/*
20	* Currently not tested:
21	*
22	* IDENTITY_TYPE_UNKNOWN
23	*/
24	public class IdentityTest extends AbstractResourceTest {
25	private interface CapabilityProvider {
26	List getCapabilities(String namespace);
27	}
28
29	private Bundle tb1;
30	private Bundle tb2;
31	private Bundle tb3;
32	private Bundle tb4;
33	private Bundle tf1;
34	private Bundle tf2;
35
36	public static Test suite() {
37	return new TestSuite(IdentityTest.class);
38	}
39
40	public IdentityTest(String name) {
41	super(name);
42	}
43
44	public void testIdentityNamespace() throws Exception {
45	assertTb1();
46	assertTb2();
47	assertTb3();
48	assertTb4();
49	assertTf1();
50	assertTf2();
51	}
52
53	protected void setUp() throws Exception {
54	super.setUp();
55	tb1 = installer.installBundle("resource.tb1");
56	tb2 = installer.installBundle("resource.tb2");
57	tb3 = installer.installBundle("resource.tb3");
58	tb4 = installer.installBundle("resource.tb4");
59	tf1 = installer.installBundle("resource.tf1");
60	tf2 = installer.installBundle("resource.tf2");
61	tb1.start();
62	tb2.start();
63	tb3.start();
64	tb4.start();
65	}
66
67	/*
68	* TB1
69	* Requirements:
70	* osgi.identity;osgi.identity=resource.tb4;version=1.0.0;type=osgi.bundle (via TF1)
71	* Capabilities:
72	* osgi.identity;osgi.identity=resource.tb1;version=1.0.0;type=osgi.bundle
73	* osgi.wiring.host;osgi.wiring.host=resource.tb1;version=1.0.0
74	* Wires:
75	* osgi.identity <-> TB3
76	* osgi.wiring.host <-> TF1
77	* TB4 <-> osgi.identity
78	*/
79	private void assertTb1() {
80	BundleRevision revision = (BundleRevision) tb1.adapt(BundleRevision.class);
81	String symbolicName = revision.getSymbolicName();
82	assertSymbolicName("resource.tb1", symbolicName);
83	Version version = revision.getVersion();
84	assertVersion("1.0.0", version);
85	String type = getType(revision);
86	assertType(ResourceConstants.IDENTITY_TYPE_BUNDLE, type);
87	Capability capability = getIdentityCapability(revision);
88	assertIdentityCapability(capability, symbolicName, version, type);
89	Resource resource = revision;
90	capability = getIdentityCapability(resource);
91	assertIdentityCapability(capability, symbolicName, version, type);
92	BundleWiring wiring = (BundleWiring) tb1.adapt(BundleWiring.class);
93	capability = getIdentityCapability(wiring);
94	assertIdentityCapability(capability, symbolicName, version, type);
95	List wires = wiring.getProvidedWires(ResourceConstants.IDENTITY_NAMESPACE);
96	assertWires(wires, 1);
97	Wire wire = (Wire) wires.get(0);
98	BundleRevision requirer = (BundleRevision) tb3.adapt(BundleRevision.class);
99	Requirement requirement = getIdentityRequirement(requirer, 0);
100	assertIdentityWire(wire, capability, revision, requirement, requirer);
101	BundleRevision provider = (BundleRevision) tb4.adapt(BundleRevision.class);
102	capability = getIdentityCapability(provider);
103	wires = wiring.getRequiredWires(ResourceConstants.IDENTITY_NAMESPACE);
104	assertWires(wires, 1);
105	wire = (Wire) wires.get(0);
106	// TODO Commented out because failing.
107	// requirement = getIdentityRequirement(revision, 0);
108	// assertIdentityWire(wire, capability, revision, requirement, requirer);
109	}
110
111	/*
112	* TB2
113	* Requirements:
114	* None
115	* Capabilities:
116	* None
117	* Wires:
118	* None
119	*/
120	private void assertTb2() {
121	final BundleRevision revision = (BundleRevision) tb2.adapt(BundleRevision.class);
122	assertNotIdentityCapability(new CapabilityProvider() {
123	public List getCapabilities(String namespace) {
124	return revision.getCapabilities(namespace);
125	}
126	});
127	final Resource resource = revision;
128	assertNotIdentityCapability(new CapabilityProvider() {
129	public List getCapabilities(String namespace) {
130	return resource.getCapabilities(namespace);
131	}
132	});
133	final BundleWiring wiring = (BundleWiring) tb2.adapt(BundleWiring.class);
134	assertNotIdentityCapability(new CapabilityProvider() {
135	public List getCapabilities(String namespace) {
136	return wiring.getCapabilities(namespace);
137	}
138	});
139	}
140
141	/*
142	* TB3
143	* Requirements:
144	* osgi.identity;osgi.identity=resource.tb1;version=1.0.0;type=osgi.bundle
145	* osgi.identity;osgi.identity=resource.tf1;version=1.0.0;type=osgi.fragment
146	* Capabilities:
147	* osgi.identity;osgi.identity=resource.tb3;version=1.0.0;type=osgi.bundle
148	* osgi.wiring.host;osgi.wiring.host=resource.tb3;version=1.0.0
149	* Wires:
150	* TB1 <-> osgi.identity
151	* TF1 <-> osgi.identity
152	*/
153	private void assertTb3() {
154	BundleRevision revision = (BundleRevision) tb3.adapt(BundleRevision.class);
155	String symbolicName = revision.getSymbolicName();
156	assertSymbolicName("resource.tb3", symbolicName);
157	Version version = revision.getVersion();
158	assertVersion("1.0.0", version);
159	String type = getType(revision);
160	assertType(ResourceConstants.IDENTITY_TYPE_BUNDLE, type);
161	Capability capability = getIdentityCapability(revision);
162	assertIdentityCapability(capability, symbolicName, version, type);
163	Resource resource = revision;
164	capability = getIdentityCapability(resource);
165	assertIdentityCapability(capability, symbolicName, version, type);
166	BundleWiring wiring = (BundleWiring) tb3.adapt(BundleWiring.class);
167	capability = getIdentityCapability(wiring);
168	assertIdentityCapability(capability, symbolicName, version, type);
169	List wires = wiring.getRequiredWires(ResourceConstants.IDENTITY_NAMESPACE);
170	assertWires(wires, 2);
171	Requirement requirement = getIdentityRequirement(revision, 0);
172	BundleRevision provider = (BundleRevision) tb1.adapt(BundleRevision.class);
173	capability = getIdentityCapability(provider);
174	Wire wire = (Wire) wires.get(0);
175	assertIdentityWire(wire, capability, provider, requirement, revision);
176	requirement = getIdentityRequirement(revision, 1);
177	provider = (BundleRevision) tf1.adapt(BundleRevision.class);
178	capability = getIdentityCapability(provider);
179	wire = (Wire) wires.get(1);
180	assertIdentityWire(wire, capability, provider, requirement, revision);
181	}
182
183	/*
184	* TB4
185	* Requirements:
186	* None
187	* Capabilities:
188	* osgi.identity;osgi.identity=resource.tb4;version=1.0.0;type=osgi.bundle
189	* osgi.wiring.host;osgi.wiring.host=resource.tb4;version=1.0.0
190	* Wires:
191	* osgi.identity <-> TB1 (via TF1)
192	*/
193	private void assertTb4() {
194	BundleRevision revision = (BundleRevision) tb4.adapt(BundleRevision.class);
195	String symbolicName = revision.getSymbolicName();
196	assertSymbolicName("resource.tb4", symbolicName);
197	Version version = revision.getVersion();
198	assertVersion("1.0.0", version);
199	String type = getType(revision);
200	assertType(ResourceConstants.IDENTITY_TYPE_BUNDLE, type);
201	Capability capability = getIdentityCapability(revision);
202	assertIdentityCapability(capability, symbolicName, version, type);
203	Resource resource = revision;
204	capability = getIdentityCapability(resource);
205	assertIdentityCapability(capability, symbolicName, version, type);
206	BundleWiring wiring = (BundleWiring) tb4.adapt(BundleWiring.class);
207	capability = getIdentityCapability(wiring);
208	assertIdentityCapability(capability, symbolicName, version, type);
209	List wires = wiring.getProvidedWires(ResourceConstants.IDENTITY_NAMESPACE);
210	assertWires(wires, 1);
211	Wire wire = (Wire) wires.get(0);
212	BundleRevision requirer = (BundleRevision) tb1.adapt(BundleRevision.class);
213	// TODO Commented out because failing.
214	// Requirement requirement = getIdentityRequirement(requirer, 0);
215	// assertIdentityWire(wire, capability, revision, requirement, requirer);
216	}
217
218	/*
219	* TF1
220	* Requirements:
221	* osgi.wiring.host;osgi.wiring.host=resource.tb1;version=1.0.0
222	* Capabilities:
223	* osgi.identity;osgi.identity=resource.tf1;version=1.0.0;type=osgi.fragment
224	* Wires:
225	* TB1 <-> osgi.wiring.host
226	* osgi.identity <-> TB3
227	*/
228	private void assertTf1() {
229	BundleRevision revision = (BundleRevision) tf1.adapt(BundleRevision.class);
230	String symbolicName = revision.getSymbolicName();
231	assertSymbolicName("resource.tf1", symbolicName);
232	Version version = revision.getVersion();
233	assertVersion("1.0.0", version);
234	String type = getType(revision);
235	assertType(ResourceConstants.IDENTITY_TYPE_FRAGMENT, type);
236	Capability capability = getIdentityCapability(revision);
237	assertIdentityCapability(capability, symbolicName, version, type);
238	Resource resource = revision;
239	capability = getIdentityCapability(resource);
240	assertIdentityCapability(capability, symbolicName, version, type);
241	BundleWiring wiring = (BundleWiring) tf1.adapt(BundleWiring.class);
242	// TODO Commented out because failing.
243	// capability = getIdentityCapability(wiring);
244	// assertIdentityCapability(capability, symbolicName, version, type);
245	BundleRevision requirer = (BundleRevision) tb3.adapt(BundleRevision.class);
246	Requirement requirement = getIdentityRequirement(requirer, 1);
247	List wires = wiring.getProvidedWires(ResourceConstants.IDENTITY_NAMESPACE);
248	// TODO Commented out because failing.
249	// assertWires(wires, 1);
250	// Wire wire = (Wire) wires.get(0);
251	// assertIdentityWire(wire, capability, revision, requirement, requirer);
252	}
253
254	/*
255	* TF2
256	* Requirements:
257	* osgi.wiring.host;osgi.wiring.host=resource.tb1;version=1.0.0
258	* Capabilities:
259	* None
260	* Wires:
261	* TB1 <-> osgi.wiring.host
262	*/
263	private void assertTf2() {
264	final BundleRevision revision = (BundleRevision) tf2.adapt(BundleRevision.class);
265	assertNotIdentityCapability(new CapabilityProvider() {
266	public List getCapabilities(String namespace) {
267	return revision.getDeclaredCapabilities(namespace);
268	}
269	});
270	final Resource resource = revision;
271	assertNotIdentityCapability(new CapabilityProvider() {
272	public List getCapabilities(String namespace) {
273	return resource.getCapabilities(namespace);
274	}
275	});
276	final BundleWiring wiring = (BundleWiring) tf2.adapt(BundleWiring.class);
277	assertNotIdentityCapability(new CapabilityProvider() {
278	public List getCapabilities(String namespace) {
279	return wiring.getCapabilities(namespace);
280	}
281	});
282	}
283
284	private void assertCapabilities(List capabilities, int size) {
285	assertNotNull("Null capabilities", capabilities);
286	assertEquals("Wrong number of capabilities", size, capabilities.size());
287	}
288
289	private void assertIdentityCapability(Capability capability, String symbolicName, Version version, String type) {
290	assertEquals("Wrong namespace", ResourceConstants.IDENTITY_NAMESPACE, capability.getNamespace());
291	assertEquals("Wrong number of attributes", 3, capability.getAttributes().size());
292	// The osgi.identity attribute contains the symbolic name of the resource.
293	assertSymbolicName(symbolicName, (String) capability.getAttributes().get(ResourceConstants.IDENTITY_NAMESPACE));
294	// The version attribute must be of type Version.
295	// The version attribute contains the version of the resource.
296	assertVersion(version, (Version) capability.getAttributes().get(ResourceConstants.IDENTITY_VERSION_ATTRIBUTE));
297	// The type attribute must be of type String.
298	// The type attribute contains the resource type.
299	assertType(type, (String) capability.getAttributes().get(ResourceConstants.IDENTITY_TYPE_ATTRIBUTE));
300	}
301
302	private void assertIdentityWire(Wire wire, Capability capability, Resource provider, Requirement requirement, Resource requirer) {
303	assertEquals("Wrong capability", capability, wire.getCapability());
304	assertEquals("Wrong provider", provider, wire.getProvider());
305	assertEquals("Wrong requirement", requirement, wire.getRequirement());
306	assertEquals("Wrong requirer", requirer, wire.getRequirer());
307	}
308
309	private void assertNotIdentityCapability(CapabilityProvider provider) {
310	List capabilities = provider.getCapabilities(ResourceConstants.IDENTITY_NAMESPACE);
311	// A resource with no symbolic name must not provide an identity capability.
312	assertCapabilities(capabilities, 0);
313	}
314
315	private void assertNotNull(Capability capability) {
316	Assert.assertNotNull("Null capability", capability);
317	}
318
319	private void assertNotNull(Requirement requirement) {
320	Assert.assertNotNull("Null requirement", requirement);
321	}
322
323	private void assertRequirements(List requirements, int index) {
324	assertNotNull("Null requirements", requirements);
325	assertTrue("Wrong number of requirements", requirements.size() > index);
326	}
327
328	private void assertSymbolicName(String expected, String actual) {
329	assertEquals("Wrong symbolic name", expected, actual);
330	}
331
332	private void assertType(String expected, String actual) {
333	assertEquals("Wrong type", expected, actual);
334	}
335
336	private void assertVersion(String expected, Version actual) {
337	assertVersion(Version.parseVersion(expected), actual);
338	}
339
340	private void assertVersion(Version expected, Version actual) {
341	assertEquals("Wrong version", expected, actual);
342	}
343
344	private void assertWires(List wires, int size) {
345	assertNotNull("Null wires", wires);
346	assertEquals("Wrong number of wires", size, wires.size());
347	}
348
349	private Capability getIdentityCapability(BundleRevision revision) {
350	List capabilities = revision.getDeclaredCapabilities(ResourceConstants.IDENTITY_NAMESPACE);
351	assertCapabilities(capabilities, 1);
352	Capability capability = (Capability) capabilities.get(0);
353	assertNotNull(capability);
354	return capability;
355	}
356
357	private Capability getIdentityCapability(BundleWiring wiring) {
358	List capabilities = wiring.getCapabilities(ResourceConstants.IDENTITY_NAMESPACE);
359	assertCapabilities(capabilities, 1);
360	Capability capability = (Capability) capabilities.get(0);
361	assertNotNull(capability);
362	return capability;
363	}
364
365	private Capability getIdentityCapability(Resource resource) {
366	List capabilities = resource.getCapabilities(ResourceConstants.IDENTITY_NAMESPACE);
367	assertCapabilities(capabilities, 1);
368	Capability capability = (Capability) capabilities.get(0);
369	assertNotNull(capability);
370	return capability;
371	}
372
373	private Requirement getIdentityRequirement(BundleRevision revision, int index) {
374	List requirements = revision.getDeclaredRequirements(ResourceConstants.IDENTITY_NAMESPACE);
375	assertRequirements(requirements, index);
376	Requirement requirement = (Requirement) requirements.get(index);
377	assertNotNull(requirement);
378	return requirement;
379	}
380
381	private String getType(BundleRevision revision) {
382	return (revision.getTypes() & BundleRevision.TYPE_FRAGMENT) == 0 ? ResourceConstants.IDENTITY_TYPE_BUNDLE : ResourceConstants.IDENTITY_TYPE_FRAGMENT;
383	}
384	}