Bug 501950 - [ds] replace Equinox DS implementation with Felix SCR (DS)I20170112-0245I20170112-0200I20170111-2000

implementation

Update the DS API for R6

Change-Id: I49f46a8474a4b434ad20fe54f2ad8f0f4d649e99
Signed-off-by: Thomas Watson <tjwatson@us.ibm.com>

30 files changed, 1547 insertions, 160 deletions

diff --git a/bundles/org.eclipse.osgi.services/.settings/.api_filters b/bundles/org.eclipse.osgi.services/.settings/.api_filters
new file mode 100644
index 000000000..ab34f1b57
--- /dev/null
+++ b/bundles/org.eclipse.osgi.services/.settings/.api_filters
@@ -0,0 +1,49 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>

+<component id="org.eclipse.osgi.services" version="2">

+    <resource path="META-INF/MANIFEST.MF">

+        <filter id="923795461">

+            <message_arguments>

+                <message_argument value="3.6.0"/>

+                <message_argument value="3.5.100"/>

+            </message_arguments>

+        </filter>

+    </resource>

+    <resource path="META-INF/MANIFEST.MF" type="org.osgi.service.component.annotations.Component">

+        <filter id="286375965">

+            <message_arguments>

+                <message_argument value="org.osgi.service.component.annotations.Component"/>

+                <message_argument value="reference()"/>

+            </message_arguments>

+        </filter>

+        <filter id="288469092">

+            <message_arguments>

+                <message_argument value="org.osgi.service.component.annotations.Component"/>

+                <message_argument value="configurationPid()"/>

+            </message_arguments>

+        </filter>

+    </resource>

+    <resource path="src/org/osgi/service/component/ComponentConstants.java" type="org.osgi.service.component.ComponentConstants">

+        <filter id="403767336">

+            <message_arguments>

+                <message_argument value="org.osgi.service.component.ComponentConstants"/>

+                <message_argument value="COMPONENT_CAPABILITY_NAME"/>

+            </message_arguments>

+        </filter>

+        <filter id="1209008130">

+            <message_arguments>

+                <message_argument value="1.3"/>

+                <message_argument value="3.6"/>

+                <message_argument value="COMPONENT_CAPABILITY_NAME"/>

+            </message_arguments>

+        </filter>

+    </resource>

+    <resource path="src/org/osgi/service/component/ComponentServiceObjects.java" type="org.osgi.service.component.ComponentServiceObjects">

+        <filter id="1108344834">

+            <message_arguments>

+                <message_argument value="1.3"/>

+                <message_argument value="3.6"/>

+                <message_argument value="org.osgi.service.component.ComponentServiceObjects"/>

+            </message_arguments>

+        </filter>

+    </resource>

+</component>

diff --git a/bundles/org.eclipse.osgi.services/META-INF/MANIFEST.MF b/bundles/org.eclipse.osgi.services/META-INF/MANIFEST.MF
index b71f95ab0..6527349a5 100644
--- a/bundles/org.eclipse.osgi.services/META-INF/MANIFEST.MF
+++ b/bundles/org.eclipse.osgi.services/META-INF/MANIFEST.MF
@@ -2,36 +2,40 @@ Manifest-Version: 1.0
 Bundle-ManifestVersion: 2
 Bundle-Name: %osgiServices
 Bundle-SymbolicName: org.eclipse.osgi.services
-Bundle-Version: 3.5.100.qualifier
+Bundle-Version: 3.6.0.qualifier
 Bundle-Description: %osgiServicesDes
 Bundle-Localization: plugin
 Bundle-Vendor: %eclipse.org
 Bundle-DocUrl: http://www.eclipse.org
 Bundle-ContactAddress: www.eclipse.org
-Export-Package: org.osgi.service.cm; version="1.5",
- org.osgi.service.component; version="1.2.2",
- org.osgi.service.component.annotations; version="1.2",
- org.osgi.service.device; version="1.1",
- org.osgi.service.event; version="1.3.1",
- org.osgi.service.http;version="1.2.1",
- org.osgi.service.http.context;version="1.0",
- org.osgi.service.http.runtime;version="1.0",
- org.osgi.service.http.runtime.dto;version="1.0",
+Export-Package: org.osgi.service.cm;version="1.5";uses:="org.osgi.framework",
+ org.osgi.service.component;version="1.3";uses:="org.osgi.framework",
+ org.osgi.service.component.annotations;version="1.3",
+ org.osgi.service.component.runtime;version="1.3";uses:="org.osgi.framework,org.osgi.util.promise,org.osgi.service.component.runtime.dto",
+ org.osgi.service.component.runtime.dto;version="1.3";uses:="org.osgi.dto,org.osgi.framework.dto",
+ org.osgi.service.device;version="1.1";uses:="org.osgi.framework",
+ org.osgi.service.event;version="1.3.1";uses:="org.osgi.framework",
+ org.osgi.service.http;version="1.2.1";uses:="javax.servlet,javax.servlet.http",
+ org.osgi.service.http.context;version="1.0";uses:="org.osgi.framework,javax.servlet.http",
+ org.osgi.service.http.runtime;version="1.0";uses:="org.osgi.service.http.runtime.dto",
+ org.osgi.service.http.runtime.dto;version="1.0";uses:="org.osgi.dto,org.osgi.framework.dto",
  org.osgi.service.http.whiteboard;version="1.0",
- org.osgi.service.log; version="1.3",
- org.osgi.service.metatype; version="1.3",
- org.osgi.service.provisioning; version="1.2",
- org.osgi.service.upnp; version="1.2",
- org.osgi.service.useradmin; version="1.1",
- org.osgi.service.wireadmin; version="1.0.1"
+ org.osgi.service.log;version="1.3";uses:="org.osgi.framework",
+ org.osgi.service.metatype;version="1.3";uses:="org.osgi.framework",
+ org.osgi.service.provisioning;version="1.2",
+ org.osgi.service.upnp;version="1.2",
+ org.osgi.service.useradmin;version="1.1";uses:="org.osgi.framework",
+ org.osgi.service.wireadmin;version="1.0.1";uses:="org.osgi.framework"
 Import-Package: javax.servlet;resolution:=optional,
  javax.servlet.http;resolution:=optional,
  org.osgi.dto;version="1.0",
  org.osgi.framework;version="1.6",
  org.osgi.framework.dto;version="1.8.0",
  org.osgi.service.cm;version="[1.5,1.6)",
- org.osgi.service.component;version="[1.2,1.3)",
- org.osgi.service.component.annotations;version="[1.2,1.3)",
+ org.osgi.service.component;version="[1.3,1.4)",
+ org.osgi.service.component.annotations;version="[1.3,1.4)",
+ org.osgi.service.component.runtime; version="[1.3,1.4)",
+ org.osgi.service.component.runtime.dto; version="[1.3,1.4)",
  org.osgi.service.device;version="[1.1,1.2)",
  org.osgi.service.event;version="[1.3,1.4)",
  org.osgi.service.http;version="[1.2,1.3)",
@@ -40,7 +44,9 @@ Import-Package: javax.servlet;resolution:=optional,
  org.osgi.service.provisioning;version="[1.2,1.3)",
  org.osgi.service.upnp;version="[1.2,1.3)",
  org.osgi.service.useradmin;version="[1.1,1.2)",
- org.osgi.service.wireadmin;version="[1.0,1.1)"
+ org.osgi.service.wireadmin;version="[1.0,1.1)",
+ org.osgi.util.function;version="[1.0,2.0)",
+ org.osgi.util.promise;version="[1.0,2.0)"
 DynamicImport-Package: javax.servlet,
  javax.servlet.http
 Bundle-RequiredExecutionEnvironment: J2SE-1.5
diff --git a/bundles/org.eclipse.osgi.services/pom.xml b/bundles/org.eclipse.osgi.services/pom.xml
index bead54ccb..167274b43 100644
--- a/bundles/org.eclipse.osgi.services/pom.xml
+++ b/bundles/org.eclipse.osgi.services/pom.xml
@@ -19,7 +19,7 @@
   </parent>
   <groupId>org.eclipse.osgi</groupId>
   <artifactId>org.eclipse.osgi.services</artifactId>
-  <version>3.5.100-SNAPSHOT</version>
+  <version>3.6.0-SNAPSHOT</version>
   <packaging>eclipse-plugin</packaging>
   <build>
     <plugins>
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentConstants.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentConstants.java
index ac753054f..624eb5610 100644
--- a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentConstants.java
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentConstants.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) OSGi Alliance (2004, 2013). All Rights Reserved.
+ * Copyright (c) OSGi Alliance (2004, 2015). 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.
@@ -47,11 +47,11 @@ public interface ComponentConstants {
 	 * configuration. The value of this property must be of type {@code Long}.
 	 * 
 	 * <p>
-	 * The value of this property is assigned by the Service Component Runtime
-	 * when a component configuration is created. The Service Component Runtime
-	 * assigns a unique value that is larger than all previously assigned values
-	 * since the Service Component Runtime was started. These values are NOT
-	 * persistent across restarts of the Service Component Runtime.
+	 * The value of this property is assigned by Service Component Runtime when
+	 * a component configuration is created. Service Component Runtime assigns a
+	 * unique value that is larger than all previously assigned values since
+	 * Service Component Runtime was started. These values are NOT persistent
+	 * across restarts of Service Component Runtime.
 	 */
 	public final static String	COMPONENT_ID								= "component.id";
 
@@ -123,4 +123,20 @@ public interface ComponentConstants {
 	 * @since 1.1
 	 */
 	public static final int		DEACTIVATION_REASON_BUNDLE_STOPPED			= 6;
+
+	/**
+	 * Capability name for Service Component Runtime.
+	 * 
+	 * <p>
+	 * Used in {@code Provide-Capability} and {@code Require-Capability}
+	 * manifest headers with the {@code osgi.extender} namespace. For example:
+	 * 
+	 * <pre>
+	 * Require-Capability: osgi.extender;
+	 *  filter:="(&amp;(osgi.extender=osgi.component)(version&gt;=1.3)(!(version&gt;=2.0)))"
+	 * </pre>
+	 * 
+	 * @since 1.3
+	 */
+	public static final String	COMPONENT_CAPABILITY_NAME					= "osgi.component";
 }
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentContext.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentContext.java
index 9855c2af8..549969184 100644
--- a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentContext.java
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentContext.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) OSGi Alliance (2004, 2013). All Rights Reserved.
+ * Copyright (c) OSGi Alliance (2004, 2014). 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.
@@ -28,26 +28,8 @@ import org.osgi.framework.ServiceReference;
  * component instance has a unique Component Context.
  * 
  * <p>
- * A component instance may have an activate method. If a component instance has
- * a suitable and accessible activate method, this method will be called when a
- * component configuration is activated. If the activate method takes a
- * {@code ComponentContext} argument, it will be passed the component instance's
- * Component Context object. If the activate method takes a
- * {@code BundleContext} argument, it will be passed the component instance's
- * Bundle Context object. If the activate method takes a {@code Map} argument,
- * it will be passed an unmodifiable Map containing the component properties.
- * 
- * <p>
- * A component instance may have a deactivate method. If a component instance
- * has a suitable and accessible deactivate method, this method will be called
- * when the component configuration is deactivated. If the deactivate method
- * takes a {@code ComponentContext} argument, it will be passed the component
- * instance's Component Context object. If the deactivate method takes a
- * {@code BundleContext} argument, it will be passed the component instance's
- * Bundle Context object. If the deactivate method takes a {@code Map} argument,
- * it will be passed an unmodifiable Map containing the component properties. If
- * the deactivate method takes an {@code int} or {@code Integer} argument, it
- * will be passed the reason code for the component instance's deactivation.
+ * A component instance may obtain its Component Context object through its
+ * activate, modified, and deactivate methods.
  * 
  * @ThreadSafe
  * @author $Id$
@@ -70,7 +52,7 @@ public interface ComponentContext {
 	 * multiple services are bound to the reference, the service with the
 	 * highest ranking (as specified in its {@code Constants.SERVICE_RANKING}
 	 * property) is returned. If there is a tie in ranking, the service with the
-	 * lowest service ID (as specified in its {@code Constants.SERVICE_ID}
+	 * lowest service id (as specified in its {@code Constants.SERVICE_ID}
 	 * property); that is, the service that was registered first is returned.
 	 * 
 	 * @param name The name of a reference as specified in a {@code reference}
@@ -78,7 +60,7 @@ public interface ComponentContext {
 	 * @return A service object for the referenced service or {@code null} if
 	 *         the reference cardinality is {@code 0..1} or {@code 0..n} and no
 	 *         bound service is available.
-	 * @throws ComponentException If the Service Component Runtime catches an
+	 * @throws ComponentException If Service Component Runtime catches an
 	 *         exception while activating the bound service.
 	 */
 	public Object locateService(String name);
@@ -87,6 +69,7 @@ public interface ComponentContext {
 	 * Returns the service object for the specified reference name and
 	 * {@code ServiceReference}.
 	 * 
+	 * @param <S> Type of Service.
 	 * @param name The name of a reference as specified in a {@code reference}
 	 *        element in this component's description.
 	 * @param reference The {@code ServiceReference} to a bound service. This
@@ -95,10 +78,10 @@ public interface ComponentContext {
 	 * @return A service object for the referenced service or {@code null} if
 	 *         the specified {@code ServiceReference} is not a bound service for
 	 *         the specified reference name.
-	 * @throws ComponentException If the Service Component Runtime catches an
+	 * @throws ComponentException If Service Component Runtime catches an
 	 *         exception while activating the bound service.
 	 */
-	public Object locateService(String name, ServiceReference<?> reference);
+	public <S> S locateService(String name, ServiceReference<S> reference);
 
 	/**
 	 * Returns the service objects for the specified reference name.
@@ -110,7 +93,7 @@ public interface ComponentContext {
 	 *         {@code 0..n} and no bound service is available. If the reference
 	 *         cardinality is {@code 0..1} or {@code 1..1} and a bound service
 	 *         is available, the array will have exactly one element.
-	 * @throws ComponentException If the Service Component Runtime catches an
+	 * @throws ComponentException If Service Component Runtime catches an
 	 *         exception while activating a bound service.
 	 */
 	public Object[] locateServices(String name);
@@ -126,17 +109,18 @@ public interface ComponentContext {
 
 	/**
 	 * If the component instance is registered as a service using the
-	 * {@code servicefactory="true"} attribute, then this method returns the
-	 * bundle using the service provided by the component instance.
+	 * {@code servicescope="bundle"} or {@code servicescope="prototype"}
+	 * attribute, then this method returns the bundle using the service provided
+	 * by the component instance.
 	 * <p>
 	 * This method will return {@code null} if:
 	 * <ul>
 	 * <li>The component instance is not a service, then no bundle can be using
 	 * it as a service.</li>
 	 * <li>The component instance is a service but did not specify the
-	 * {@code servicefactory="true"} attribute, then all bundles using the
-	 * service provided by the component instance will share the same component
-	 * instance.</li>
+	 * {@code servicescope="bundle"} or {@code servicescope="prototype"}
+	 * attribute, then all bundles using the service provided by the component
+	 * instance will share the same component instance.</li>
 	 * <li>The service provided by the component instance is not currently being
 	 * used by any bundle.</li>
 	 * </ul>
@@ -158,6 +142,12 @@ public interface ComponentContext {
 	 * Enables the specified component name. The specified component name must
 	 * be in the same bundle as this component.
 	 * 
+	 * <p>
+	 * This method must return after changing the enabled state of the specified
+	 * component name. Any actions that result from this, such as activating or
+	 * deactivating a component configuration, must occur asynchronously to this
+	 * method call.
+	 * 
 	 * @param name The name of a component or {@code null} to indicate all
 	 *        components in the bundle.
 	 */
@@ -167,6 +157,12 @@ public interface ComponentContext {
 	 * Disables the specified component name. The specified component name must
 	 * be in the same bundle as this component.
 	 * 
+	 * <p>
+	 * This method must return after changing the enabled state of the specified
+	 * component name. Any actions that result from this, such as activating or
+	 * deactivating a component configuration, must occur asynchronously to this
+	 * method call.
+	 * 
 	 * @param name The name of a component.
 	 */
 	public void disableComponent(String name);
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentException.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentException.java
index 9ec6a42f2..6b4777460 100644
--- a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentException.java
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentException.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) OSGi Alliance (2004, 2013). All Rights Reserved.
+ * Copyright (c) OSGi Alliance (2004, 2014). 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.
@@ -17,7 +17,7 @@
 package org.osgi.service.component;
 
 /**
- * Unchecked exception which may be thrown by the Service Component Runtime.
+ * Unchecked exception which may be thrown by Service Component Runtime.
  * 
  * @author $Id$
  */
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentFactory.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentFactory.java
index efb1e1695..a6422fc51 100644
--- a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentFactory.java
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentFactory.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) OSGi Alliance (2004, 2013). All Rights Reserved.
+ * Copyright (c) OSGi Alliance (2004, 2014). 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.
@@ -21,7 +21,7 @@ import org.osgi.annotation.versioning.ProviderType;
 
 /**
  * When a component is declared with the {@code factory} attribute on its
- * {@code component} element, the Service Component Runtime will register a
+ * {@code component} element, Service Component Runtime will register a
  * Component Factory service to allow new component configurations to be created
  * and activated rather than automatically creating and activating component
  * configuration as necessary.
@@ -42,7 +42,7 @@ public interface ComponentFactory {
 	 *         configuration has been activated and, if the component specifies
 	 *         a {@code service} element, the component instance has been
 	 *         registered as a service.
-	 * @throws ComponentException If the Service Component Runtime is unable to
+	 * @throws ComponentException If Service Component Runtime is unable to
 	 *         activate the component configuration.
 	 */
 	public ComponentInstance newInstance(Dictionary<String, ?> properties);
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentServiceObjects.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentServiceObjects.java
new file mode 100644
index 000000000..49fc5e863
--- /dev/null
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/ComponentServiceObjects.java
@@ -0,0 +1,95 @@
+/*
+ * Copyright (c) OSGi Alliance (2012, 2014). 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.service.component;
+
+import org.osgi.annotation.versioning.ProviderType;
+import org.osgi.framework.Constants;
+import org.osgi.framework.ServiceObjects;
+import org.osgi.framework.ServiceReference;
+
+/**
+ * Allows multiple service objects for a service to be obtained.
+ * 
+ * <p>
+ * A component instance can receive a {@code ComponentServiceObjects} object via
+ * a reference that is typed {@code ComponentServiceObjects}.
+ * 
+ * <p>
+ * For services with {@link Constants#SCOPE_PROTOTYPE prototype} scope, multiple
+ * service objects for the service can be obtained. For services with
+ * {@link Constants#SCOPE_SINGLETON singleton} or {@link Constants#SCOPE_BUNDLE
+ * bundle} scope, only one, use-counted service object is available.
+ * 
+ * <p>
+ * Any unreleased service objects obtained from this
+ * {@code ComponentServiceObjects} object are automatically released by Service
+ * Component Runtime when the service becomes unbound.
+ * 
+ * @param <S> Type of Service
+ * @ThreadSafe
+ * @since 1.3
+ * @see ServiceObjects
+ * @author $Id$
+ */
+@ProviderType
+public interface ComponentServiceObjects<S> {
+	/**
+	 * Returns a service object for the {@link #getServiceReference()
+	 * associated} service.
+	 * 
+	 * <p>
+	 * This method will always return {@code null} when the associated service
+	 * has been become unbound.
+	 * 
+	 * @return A service object for the associated service or {@code null} if
+	 *         the service is unbound, the customized service object returned by
+	 *         a {@code ServiceFactory} does not implement the classes under
+	 *         which it was registered or the {@code ServiceFactory} threw an
+	 *         exception.
+	 * @throws IllegalStateException If the associated service has been become
+	 *         unbound.
+	 * @see #ungetService(Object)
+	 */
+	public S getService();
+
+	/**
+	 * Releases a service object for the {@link #getServiceReference()
+	 * associated} service.
+	 * 
+	 * <p>
+	 * The specified service object must no longer be used and all references to
+	 * it should be destroyed after calling this method.
+	 * 
+	 * @param service A service object previously provided by this
+	 *        {@code ComponentServiceObjects} object.
+	 * @throws IllegalStateException If the associated service has been become
+	 *         unbound.
+	 * @throws IllegalArgumentException If the specified service object was not
+	 *         provided by this {@code ComponentServiceObjects} object.
+	 * @see #getService()
+	 */
+	public void ungetService(S service);
+
+	/**
+	 * Returns the {@link ServiceReference} for the service associated with this
+	 * {@code ComponentServiceObjects} object.
+	 * 
+	 * @return The {@link ServiceReference} for the service associated with this
+	 *         {@code ComponentServiceObjects} object.
+	 */
+	public ServiceReference<S> getServiceReference();
+}
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Activate.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Activate.java
index e24a899f7..6e320f371 100644
--- a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Activate.java
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Activate.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) OSGi Alliance (2011, 2013). All Rights Reserved.
+ * Copyright (c) OSGi Alliance (2011, 2014). 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.
@@ -29,9 +29,9 @@ import java.lang.annotation.Target;
  * The annotated method is the activate method of the Component.
  * 
  * <p>
- * This annotation is not processed at runtime by a Service Component Runtime
- * implementation. It must be processed by tools and used to add a Component
- * Description to the bundle.
+ * This annotation is not processed at runtime by Service Component Runtime. It
+ * must be processed by tools and used to add a Component Description to the
+ * bundle.
  * 
  * @see "The activate attribute of the component element of a Component Description."
  * @author $Id$
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Component.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Component.java
index e7f072364..d44af93dc 100644
--- a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Component.java
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Component.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) OSGi Alliance (2011, 2013). All Rights Reserved.
+ * Copyright (c) OSGi Alliance (2011, 2015). 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.
@@ -28,9 +28,9 @@ import java.lang.annotation.Target;
  * The annotated class is the implementation class of the Component.
  * 
  * <p>
- * This annotation is not processed at runtime by a Service Component Runtime
- * implementation. It must be processed by tools and used to add a Component
- * Description to the bundle.
+ * This annotation is not processed at runtime by Service Component Runtime. It
+ * must be processed by tools and used to add a Component Description to the
+ * bundle.
  * 
  * @see "The component element of a Component Description."
  * @author $Id$
@@ -82,11 +82,16 @@ public @interface Component {
 	 * component instance.
 	 * 
 	 * <p>
-	 * If {@code true}, this Component uses the OSGi ServiceFactory concept. If
-	 * {@code false} or not specified, this Component does not use the OSGi
-	 * ServiceFactory concept.
+	 * This element is ignored when the {@link #scope()} element does not have
+	 * the default value. If {@code true}, this Component uses
+	 * {@link ServiceScope#BUNDLE bundle} service scope. If {@code false} or not
+	 * specified, this Component uses {@link ServiceScope#SINGLETON singleton}
+	 * service scope. If the {@link #factory()} element is specified or the
+	 * {@link #immediate()} element is specified with {@code true}, this element
+	 * can only be specified with {@code false}.
 	 * 
-	 * @see "The servicefactory attribute of the service element of a Component Description."
+	 * @see "The scope attribute of the service element of a Component Description."
+	 * @deprecated Since 1.3. Replaced by {@link #scope()}.
 	 */
 	boolean servicefactory() default false;
 
@@ -95,8 +100,8 @@ public @interface Component {
 	 * is started.
 	 * 
 	 * <p>
-	 * If {@code true}, this Component is enabled. If {@code false} or not
-	 * specified, this Component is disabled.
+	 * If {@code true} or not specified, this Component is enabled. If
+	 * {@code false}, this Component is disabled.
 	 * 
 	 * @see "The enabled attribute of the component element of a Component Description."
 	 */
@@ -110,13 +115,13 @@ public @interface Component {
 	 * If {@code true}, this Component must be immediately activated upon
 	 * becoming satisfied. If {@code false}, activation of this Component is
 	 * delayed. If this property is specified, its value must be {@code false}
-	 * if the {@link #factory} property is also specified or must be
-	 * {@code true} if the {@link #service} property is specified with an empty
-	 * value.
+	 * if the {@link #factory()} property is also specified or must be
+	 * {@code true} if the {@link #service()} property is specified with an
+	 * empty value.
 	 * 
 	 * <p>
-	 * If not specified, the default is {@code false} if the {@link #factory}
-	 * property is specified or the {@link #service} property is not specified
+	 * If not specified, the default is {@code false} if the {@link #factory()}
+	 * property is specified or the {@link #service()} property is not specified
 	 * or specified with a non-empty value and {@code true} otherwise.
 	 * 
 	 * @see "The immediate attribute of the component element of a Component Description."
@@ -127,13 +132,14 @@ public @interface Component {
 	 * Properties for this Component.
 	 * 
 	 * <p>
-	 * Each property string is specified as {@code "key=value"}. The type of the
-	 * property value can be specified in the key as {@code key:type=value}. The
-	 * type must be one of the property types supported by the type attribute of
-	 * the property element of a Component Description.
+	 * Each property string is specified as {@code "name=value"}. The type of
+	 * the property value can be specified in the name as
+	 * {@code name:type=value}. The type must be one of the property types
+	 * supported by the type attribute of the property element of a Component
+	 * Description.
 	 * 
 	 * <p>
-	 * To specify a property with multiple values, use multiple key, value
+	 * To specify a property with multiple values, use multiple name, value
 	 * pairs. For example, {@code "foo=bar", "foo=baz"}.
 	 * 
 	 * @see "The property element of a Component Description."
@@ -174,8 +180,18 @@ public @interface Component {
 	 * Configuration object where the PID equals the name of the component.
 	 * 
 	 * <p>
-	 * If not specified, the {@link ConfigurationPolicy#OPTIONAL OPTIONAL}
-	 * configuration policy is used.
+	 * If not specified, the configuration policy is based upon whether the
+	 * component is also annotated with the Meta Type
+	 * {@link org.osgi.service.metatype.annotations.Designate Designate}
+	 * annotation.
+	 * <ul>
+	 * <li>Not annotated with {@code Designate} - The configuration policy is
+	 * {@link ConfigurationPolicy#OPTIONAL OPTIONAL}.</li>
+	 * <li>Annotated with {@code Designate(factory=false)} - The configuration
+	 * policy is {@link ConfigurationPolicy#OPTIONAL OPTIONAL}.</li>
+	 * <li>Annotated with {@code Designate(factory=true)} - The configuration
+	 * policy is {@link ConfigurationPolicy#REQUIRE REQUIRE}.</li>
+	 * </ul>
 	 * 
 	 * @see "The configuration-policy attribute of the component element of a Component Description."
 	 * @since 1.1
@@ -183,18 +199,82 @@ public @interface Component {
 	ConfigurationPolicy configurationPolicy() default ConfigurationPolicy.OPTIONAL;
 
 	/**
-	 * The configuration PID for the configuration of this Component.
+	 * The configuration PIDs for the configuration of this Component.
 	 * 
 	 * <p>
-	 * Allows the configuration PID for this Component to be different than the
-	 * name of this Component.
+	 * Each value specifies a configuration PID for this Component.
 	 * 
 	 * <p>
-	 * If not specified, the name of this Component is used as the configuration
-	 * PID of this Component.
+	 * If no value is specified, the name of this Component is used as the
+	 * configuration PID of this Component.
+	 * 
+	 * <p>
+	 * A special string (<code>{@value #NAME}</code>) can be used to specify the
+	 * name of the component as a configuration PID. The {@code NAME} constant
+	 * holds this special string. For example:
+	 * 
+	 * <pre>
+	 * &#64;Component(configurationPid={"com.acme.system", Component.NAME})
+	 * </pre>
+	 * 
+	 * Tools creating a Component Description from this annotation must replace
+	 * the special string with the actual name of this Component.
 	 * 
 	 * @see "The configuration-pid attribute of the component element of a Component Description."
 	 * @since 1.2
 	 */
-	String configurationPid() default "";
+	String[] configurationPid() default NAME;
+
+	/**
+	 * Special string representing the name of this Component.
+	 * 
+	 * <p>
+	 * This string can be used in {@link #configurationPid()} to specify the
+	 * name of the component as a configuration PID. For example:
+	 * 
+	 * <pre>
+	 * &#64;Component(configurationPid={"com.acme.system", Component.NAME})
+	 * </pre>
+	 * 
+	 * Tools creating a Component Description from this annotation must replace
+	 * the special string with the actual name of this Component.
+	 * 
+	 * @since 1.3
+	 */
+	String	NAME	= "$";
+
+	/**
+	 * The service scope for the service of this Component.
+	 * 
+	 * <p>
+	 * If not specified (and the deprecated {@link #servicefactory()} element is
+	 * not specified), the {@link ServiceScope#SINGLETON singleton} service
+	 * scope is used. If the {@link #factory()} element is specified or the
+	 * {@link #immediate()} element is specified with {@code true}, this element
+	 * can only be specified with the {@link ServiceScope#SINGLETON singleton}
+	 * service scope.
+	 * 
+	 * @see "The scope attribute of the service element of a Component Description."
+	 * @since 1.3
+	 */
+	ServiceScope scope() default ServiceScope.DEFAULT;
+
+	/**
+	 * The lookup strategy references of this Component.
+	 * 
+	 * <p>
+	 * To access references using the lookup strategy, {@link Reference}
+	 * annotations are specified naming the reference and declaring the type of
+	 * the referenced service. The referenced service can be accessed using one
+	 * of the {@code locateService} methods of {@code ComponentContext}.
+	 * 
+	 * <p>
+	 * To access references using the event strategy, bind methods are annotated
+	 * with {@link Reference}. To access references using the field strategy,
+	 * fields are annotated with {@link Reference}.
+	 * 
+	 * @see "The reference element of a Component Description."
+	 * @since 1.3
+	 */
+	Reference[] reference() default {};
 }
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Deactivate.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Deactivate.java
index 1809c70eb..78bb6b4fe 100644
--- a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Deactivate.java
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Deactivate.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) OSGi Alliance (2011, 2013). All Rights Reserved.
+ * Copyright (c) OSGi Alliance (2011, 2014). 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.
@@ -29,9 +29,9 @@ import java.lang.annotation.Target;
  * The annotated method is the deactivate method of the Component.
  * 
  * <p>
- * This annotation is not processed at runtime by a Service Component Runtime
- * implementation. It must be processed by tools and used to add a Component
- * Description to the bundle.
+ * This annotation is not processed at runtime by Service Component Runtime. It
+ * must be processed by tools and used to add a Component Description to the
+ * bundle.
  * 
  * @see "The deactivate attribute of the component element of a Component Description."
  * @author $Id$
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/FieldOption.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/FieldOption.java
new file mode 100644
index 000000000..35bfd6c67
--- /dev/null
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/FieldOption.java
@@ -0,0 +1,53 @@
+/*
+ * Copyright (c) OSGi Alliance (2014, 2015). 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.service.component.annotations;
+
+/**
+ * Field options for the {@link Reference} annotation.
+ * 
+ * @since 1.3
+ * @author $Id$
+ */
+public enum FieldOption {
+	
+	/**
+	 * The update field option is used to update the collection referenced by
+	 * the field when there are changes to the bound services.
+	 * 
+	 * <p>
+	 * This field option can only be used when the field reference has dynamic
+	 * policy and multiple cardinality.
+	 */
+	UPDATE("update"),
+	
+	/**
+	 * The replace field option is used to replace the field value with a new
+	 * value when there are changes to the bound services.
+	 */
+	REPLACE("replace");
+
+	private final String	value;
+
+	FieldOption(String value) {
+		this.value = value;
+	}
+
+	@Override
+	public String toString() {
+		return value;
+	}
+}
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Modified.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Modified.java
index fd9f97d2f..c4d0c68f2 100644
--- a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Modified.java
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Modified.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) OSGi Alliance (2011, 2013). All Rights Reserved.
+ * Copyright (c) OSGi Alliance (2011, 2014). 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.
@@ -29,9 +29,9 @@ import java.lang.annotation.Target;
  * The annotated method is the modified method of the Component.
  * 
  * <p>
- * This annotation is not processed at runtime by a Service Component Runtime
- * implementation. It must be processed by tools and used to add a Component
- * Description to the bundle.
+ * This annotation is not processed at runtime by Service Component Runtime. It
+ * must be processed by tools and used to add a Component Description to the
+ * bundle.
  * 
  * @see "The modified attribute of the component element of a Component Description."
  * @author $Id$
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Reference.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Reference.java
index 9887c51c7..b13bbef27 100644
--- a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Reference.java
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/Reference.java
@@ -1,5 +1,5 @@
 /*
- * Copyright (c) OSGi Alliance (2011, 2013). All Rights Reserved.
+ * Copyright (c) OSGi Alliance (2011, 2014). 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.
@@ -22,16 +22,17 @@ import java.lang.annotation.RetentionPolicy;
 import java.lang.annotation.Target;
 
 /**
- * Identify the annotated method as a {@code bind} method of a Service
- * Component.
+ * Identify the annotated member as a reference of a Service Component.
  * 
  * <p>
- * The annotated method is a bind method of the Component.
+ * When the annotation is applied to a method, the method is the bind method of
+ * the reference. When the annotation is applied to a field, the field will
+ * contain the bound service(s) of the reference.
  * 
  * <p>
- * This annotation is not processed at runtime by a Service Component Runtime
- * implementation. It must be processed by tools and used to add a Component
- * Description to the bundle.
+ * This annotation is not processed at runtime by Service Component Runtime. It
+ * must be processed by tools and used to add a Component Description to the
+ * bundle.
  * 
  * <p>
  * In the generated Component Description for a component, the references must
@@ -42,111 +43,273 @@ import java.lang.annotation.Target;
  * @author $Id$
  */
 @Retention(RetentionPolicy.CLASS)
-@Target(ElementType.METHOD)
+@Target({ElementType.METHOD, ElementType.FIELD})
 public @interface Reference {
 	/**
 	 * The name of this reference.
 	 * 
 	 * <p>
-	 * If not specified, the name of this reference is based upon the name of
-	 * the method being annotated. If the method name begins with {@code bind},
-	 * {@code set} or {@code add}, that is removed.
+	 * The name of this reference must be specified when using this annotation
+	 * in the {@link Component#reference()} element since there is no annotated
+	 * member from which the name can be determined.
+	 * 
+	 * If not specified, the name of this reference is based upon how this
+	 * annotation is used:
+	 * <ul>
+	 * <li>Annotated method - If the method name begins with {@code bind},
+	 * {@code set} or {@code add}, that prefix is removed to create the name of
+	 * the reference. Otherwise, the name of the reference is the method name.</li>
+	 * <li>Annotated field - The name of the reference is the field name.</li>
+	 * </ul>
 	 * 
 	 * @see "The name attribute of the reference element of a Component Description."
 	 */
 	String name() default "";
 
 	/**
-	 * The type of the service to bind to this reference.
+	 * The type of the service for this reference.
+	 * 
+	 * <p>
+	 * The type of the service for this reference must be specified when using
+	 * this annotation in the {@link Component#reference()} element since there
+	 * is no annotated member from which the type of the service can be
+	 * determined.
 	 * 
 	 * <p>
-	 * If not specified, the type of the service to bind is based upon the type
-	 * of the first argument of the method being annotated.
+	 * If not specified, the type of the service for this reference is based
+	 * upon how this annotation is used:
+	 * <ul>
+	 * <li>Annotated method - The type of the service is the type of the first
+	 * argument of the method.</li>
+	 * <li>Annotated field - The type of the service is based upon the type of
+	 * the field being annotated and the cardinality of the reference. If the
+	 * cardinality is either {@link ReferenceCardinality#MULTIPLE 0..n}, or
+	 * {@link ReferenceCardinality#AT_LEAST_ONE 1..n}, the type of the field
+	 * must be one of {@code java.util.Collection}, {@code java.util.List}, or a
+	 * subtype of {@code java.util.Collection} so the type of the service is the
+	 * generic type of the collection. Otherwise, the type of the service is the
+	 * type of the field.</li>
+	 * </ul>
 	 * 
 	 * @see "The interface attribute of the reference element of a Component Description."
 	 */
 	Class<?> service() default Object.class;
 
 	/**
-	 * The cardinality of the reference.
+	 * The cardinality of this reference.
 	 * 
 	 * <p>
-	 * If not specified, the reference has a
-	 * {@link ReferenceCardinality#MANDATORY 1..1} cardinality.
+	 * If not specified, the cardinality of this reference is based upon how
+	 * this annotation is used:
+	 * <ul>
+	 * <li>Annotated method - The cardinality is
+	 * {@link ReferenceCardinality#MANDATORY 1..1}.</li>
+	 * <li>Annotated field - The cardinality is based on the type of the field.
+	 * If the type is either {@code java.util.Collection},
+	 * {@code java.util.List}, or a subtype of {@code java.util.Collection}, the
+	 * cardinality is {@link ReferenceCardinality#MULTIPLE 0..n}. Otherwise the
+	 * cardinality is {@link ReferenceCardinality#MANDATORY 1..1}.</li>
+	 * <li>{@link Component#reference()} element - The cardinality is
+	 * {@link ReferenceCardinality#MANDATORY 1..1}.</li>
+	 * </ul>
 	 * 
 	 * @see "The cardinality attribute of the reference element of a Component Description."
 	 */
 	ReferenceCardinality cardinality() default ReferenceCardinality.MANDATORY;
 
 	/**
-	 * The policy for the reference.
+	 * The policy for this reference.
 	 * 
 	 * <p>
-	 * If not specified, the {@link ReferencePolicy#STATIC STATIC} reference
-	 * policy is used.
+	 * If not specified, the policy of this reference is based upon how this
+	 * annotation is used:
+	 * <ul>
+	 * <li>Annotated method - The policy is {@link ReferencePolicy#STATIC
+	 * STATIC}.</li>
+	 * <li>Annotated field - The policy is based on the modifiers of the field.
+	 * If the field is declared {@code volatile}, the policy is
+	 * {@link ReferencePolicy#DYNAMIC}. Otherwise the policy is
+	 * {@link ReferencePolicy#STATIC STATIC}.</li>
+	 * <li>{@link Component#reference()} element - The policy is
+	 * {@link ReferencePolicy#STATIC STATIC}.</li>
+	 * </ul>
 	 * 
 	 * @see "The policy attribute of the reference element of a Component Description."
 	 */
 	ReferencePolicy policy() default ReferencePolicy.STATIC;
 
 	/**
-	 * The target filter for the reference.
+	 * The target property for this reference.
+	 * 
+	 * <p>
+	 * If not specified, no target property is set.
 	 * 
 	 * @see "The target attribute of the reference element of a Component Description."
 	 */
 	String target() default "";
 
 	/**
-	 * The name of the unbind method which is associated with the annotated bind
-	 * method.
+	 * The policy option for this reference.
 	 * 
 	 * <p>
-	 * To declare no unbind method, the value {@code "-"} must be used.
+	 * If not specified, the {@link ReferencePolicyOption#RELUCTANT RELUCTANT}
+	 * reference policy option is used.
+	 * 
+	 * @see "The policy-option attribute of the reference element of a Component Description."
+	 * @since 1.2
+	 */
+	ReferencePolicyOption policyOption() default ReferencePolicyOption.RELUCTANT;
+
+	/**
+	 * The reference scope for this reference.
 	 * 
 	 * <p>
-	 * If not specified, the name of the unbind method is derived from the name
-	 * of the annotated bind method. If the annotated method name begins with
-	 * {@code bind}, {@code set} or {@code add}, that is replaced with
-	 * {@code unbind}, {@code unset} or {@code remove}, respectively, to derive
-	 * the unbind method name. Otherwise, {@code un} is prefixed to the
-	 * annotated method name to derive the unbind method name. The unbind method
-	 * is only set if the component type contains a method with the derived
-	 * name.
+	 * If not specified, the {@link ReferenceScope#BUNDLE bundle} reference
+	 * scope is used.
 	 * 
-	 * @see "The unbind attribute of the reference element of a Component Description."
+	 * @see "The scope attribute of the reference element of a Component Description."
+	 * @since 1.3
 	 */
-	String unbind() default "";
+	ReferenceScope scope() default ReferenceScope.BUNDLE;
+
+	/* Method injection elements */
 
 	/**
-	 * The policy option for the reference.
+	 * The name of the bind method for this reference.
 	 * 
 	 * <p>
-	 * If not specified, the {@link ReferencePolicyOption#RELUCTANT RELUCTANT}
-	 * reference policy option is used.
+	 * If specified and this reference annotates a method, the specified name
+	 * must match the name of the annotated method.
 	 * 
-	 * @see "The policy-option attribute of the reference element of a Component Description."
-	 * @since 1.2
+	 * <p>
+	 * If not specified, the name of the bind method is based upon how this
+	 * annotation is used:
+	 * <ul>
+	 * <li>Annotated method - The name of the annotated method is the name of
+	 * the bind method.</li>
+	 * <li>Annotated field - There is no bind method name.</li>
+	 * <li>{@link Component#reference()} element - There is no bind method name.
+	 * </li>
+	 * </ul>
+	 * 
+	 * <p>
+	 * If there is a bind method name, the component must contain a method with
+	 * that name.
+	 * 
+	 * @see "The bind attribute of the reference element of a Component Description."
+	 * @since 1.3
 	 */
-	ReferencePolicyOption policyOption() default ReferencePolicyOption.RELUCTANT;
+	String bind() default "";
 
 	/**
-	 * The name of the updated method which is associated with the annotated
-	 * bind method.
+	 * The name of the updated method for this reference.
 	 * 
 	 * <p>
-	 * To declare no updated method, the value {@code "-"} must be used.
+	 * If not specified, the name of the updated method is based upon how this
+	 * annotation is used:
+	 * <ul>
+	 * <li>Annotated method - The name of the updated method is created from the
+	 * name of the annotated method. If the name of the annotated method begins
+	 * with {@code bind}, {@code set} or {@code add}, that prefix is replaced
+	 * with {@code updated} to create the name candidate for the updated method.
+	 * Otherwise, {@code updated} is prefixed to the name of the annotated
+	 * method to create the name candidate for the updated method. If the
+	 * component type contains a method with the candidate name, the candidate
+	 * name is used as the name of the updated method. To declare no updated
+	 * method when the component type contains a method with the candidate name,
+	 * the value {@code "-"} must be used.</li>
+	 * <li>Annotated field - There is no updated method name.</li>
+	 * <li>{@link Component#reference()} element - There is no updated method
+	 * name.</li>
+	 * </ul>
 	 * 
 	 * <p>
-	 * If not specified, the name of the updated method is derived from the name
-	 * of the annotated bind method. If the annotated method name begins with
-	 * {@code bind}, {@code set} or {@code add}, that is replaced with
-	 * {@code updated} to derive the updated method name. Otherwise,
-	 * {@code updated} is prefixed to the annotated method name to derive the
-	 * updated method name. The updated method is only set if the component type
-	 * contains a method with the derived name.
+	 * If there is an updated method name, the component must contain a method
+	 * with that name.
 	 * 
 	 * @see "The updated attribute of the reference element of a Component Description."
 	 * @since 1.2
 	 */
 	String updated() default "";
+
+	/**
+	 * The name of the unbind method for this reference.
+	 * 
+	 * <p>
+	 * If not specified, the name of the unbind method is based upon how this
+	 * annotation is used:
+	 * <ul>
+	 * <li>Annotated method - The name of the unbind method is created from the
+	 * name of the annotated method. If the name of the annotated method begins
+	 * with {@code bind}, {@code set} or {@code add}, that prefix is replaced
+	 * with {@code unbind}, {@code unset} or {@code remove}, respectively, to
+	 * create the name candidate for the unbind method. Otherwise, {@code un} is
+	 * prefixed to the name of the annotated method to create the name candidate
+	 * for the unbind method. If the component type contains a method with the
+	 * candidate name, the candidate name is used as the name of the unbind
+	 * method. To declare no unbind method when the component type contains a
+	 * method with the candidate name, the value {@code "-"} must be used.</li>
+	 * <li>Annotated field - There is no unbind method name.</li>
+	 * <li>{@link Component#reference()} element - There is no unbind method
+	 * name.</li>
+	 * </ul>
+	 * 
+	 * <p>
+	 * If there is an unbind method name, the component must contain a method
+	 * with that name.
+	 * 
+	 * @see "The unbind attribute of the reference element of a Component Description."
+	 */
+	String unbind() default "";
+
+	/* Field injection elements */
+
+	/**
+	 * The name of the field for this reference.
+	 * 
+	 * <p>
+	 * If specified and this reference annotates a field, the specified name
+	 * must match the name of the annotated field.
+	 * 
+	 * <p>
+	 * If not specified, the name of the field is based upon how this annotation
+	 * is used:
+	 * <ul>
+	 * <li>Annotated method - There is no field name.</li>
+	 * <li>Annotated field - The name of the annotated field is the name of the
+	 * field.</li>
+	 * <li>{@link Component#reference()} element - There is no field name.</li>
+	 * </ul>
+	 * 
+	 * <p>
+	 * If there is a field name, the component must contain a field with that
+	 * name.
+	 * 
+	 * @see "The field attribute of the reference element of a Component Description."
+	 * @since 1.3
+	 */
+	String field() default "";
+
+	/**
+	 * The field option for this reference.
+	 * 
+	 * <p>
+	 * If not specified, the field option is based upon how this annotation is
+	 * used:
+	 * <ul>
+	 * <li>Annotated method - There is no field option.</li>
+	 * <li>Annotated field - The field option is based upon the policy and
+	 * cardinality of the reference and the modifiers of the field. If the
+	 * policy is {@link ReferencePolicy#DYNAMIC}, the cardinality is
+	 * {@link ReferenceCardinality#MULTIPLE 0..n} or
+	 * {@link ReferenceCardinality#AT_LEAST_ONE 1..n}, and the field is declared
+	 * {@code final}, the field option is {@link FieldOption#UPDATE}. Otherwise,
+	 * the field option is {@link FieldOption#REPLACE}</li>
+	 * <li>{@link Component#reference()} element - There is no field option.</li>
+	 * </ul>
+	 * 
+	 * @see "The field-option attribute of the reference element of a Component Description."
+	 * @since 1.3
+	 */
+	FieldOption fieldOption() default FieldOption.REPLACE;
 }
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/ReferenceScope.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/ReferenceScope.java
new file mode 100644
index 000000000..2a61ef265
--- /dev/null
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/ReferenceScope.java
@@ -0,0 +1,57 @@
+/*
+ * Copyright (c) OSGi Alliance (2013, 2014). 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.service.component.annotations;
+
+/**
+ * Reference scope for the {@link Reference} annotation.
+ * 
+ * @author $Id$
+ * @since 1.3
+ */
+public enum ReferenceScope {
+	/**
+	 * A single service object is used for all references to the service in this
+	 * bundle.
+	 */
+	BUNDLE("bundle"),
+
+	/**
+	 * If the bound service has prototype service scope, then each instance of
+	 * the component with this reference can receive a unique instance of the
+	 * service. If the bound service does not have prototype service scope, then
+	 * this reference scope behaves the same as {@link #BUNDLE}.
+	 */
+	PROTOTYPE("prototype"),
+
+	/**
+	 * Bound services must have prototype service scope. Each instance of the
+	 * component with this reference can receive a unique instance of the
+	 * service.
+	 */
+	PROTOTYPE_REQUIRED("prototype_required");
+
+	private final String	value;
+
+	ReferenceScope(String value) {
+		this.value = value;
+	}
+
+	@Override
+	public String toString() {
+		return value;
+	}
+}
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/ServiceScope.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/ServiceScope.java
new file mode 100644
index 000000000..3c43d5fea
--- /dev/null
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/ServiceScope.java
@@ -0,0 +1,63 @@
+/*
+ * Copyright (c) OSGi Alliance (2011, 2014). 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.service.component.annotations;
+
+/**
+ * Service scope for the {@link Component} annotation.
+ * 
+ * @author $Id$
+ * @since 1.3
+ */
+public enum ServiceScope {
+	/**
+	 * When the component is registered as a service, it must be registered as a
+	 * bundle scope service but only a single instance of the component must be
+	 * used for all bundles using the service.
+	 */
+	SINGLETON("singleton"),
+
+	/**
+	 * When the component is registered as a service, it must be registered as a
+	 * bundle scope service and an instance of the component must be created for
+	 * each bundle using the service.
+	 */
+	BUNDLE("bundle"),
+
+	/**
+	 * When the component is registered as a service, it must be registered as a
+	 * prototype scope service and an instance of the component must be created
+	 * for each distinct request for the service.
+	 */
+	PROTOTYPE("prototype"),
+
+	/**
+	 * Default element value for annotation. This is used to distinguish the
+	 * default value for an element and should not otherwise be used.
+	 */
+	DEFAULT("<<default>>");
+
+	private final String	value;
+
+	ServiceScope(String value) {
+		this.value = value;
+	}
+
+	@Override
+	public String toString() {
+		return value;
+	}
+}
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/package-info.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/package-info.java
index dbfa48a1b..bcb93c6d8 100644
--- a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/package-info.java
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/package-info.java
@@ -15,7 +15,7 @@
  */
 
 /**
- * Service Component Annotations Package Version 1.2.
+ * Service Component Annotations Package Version 1.3.
  *
  * <p>
  * This package is not used at runtime. Annotated classes are processed by
@@ -24,7 +24,7 @@
  * @author $Id$
  */
 
-@Version("1.2")
+@Version("1.3")
 package org.osgi.service.component.annotations;
 
 import org.osgi.annotation.versioning.Version;
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/packageinfo b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/packageinfo
index ef7df68cb..0117a56c1 100644
--- a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/packageinfo
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/annotations/packageinfo
@@ -1 +1 @@
-version 1.2
+version 1.3
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/package-info.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/package-info.java
index 4b472f45b..9c158e8fb 100644
--- a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/package-info.java
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/package-info.java
@@ -15,7 +15,7 @@
  */
 
 /**
- * Service Component Package Version 1.2.
+ * Service Component Package Version 1.3.
  *
  * <p>
  * Bundles wishing to use this package must list the package in the
@@ -26,16 +26,16 @@
  * <p>
  * Example import for consumers using the API in this package:
  * <p>
- * {@code  Import-Package: org.osgi.service.component; version="[1.2,2.0)"}
+ * {@code  Import-Package: org.osgi.service.component; version="[1.3,2.0)"}
  * <p>
  * Example import for providers implementing the API in this package:
  * <p>
- * {@code  Import-Package: org.osgi.service.component; version="[1.2,1.3)"}
+ * {@code  Import-Package: org.osgi.service.component; version="[1.3,1.4)"}
  *
  * @author $Id$
  */
 
-@Version("1.2.2")
+@Version("1.3")
 package org.osgi.service.component;
 
 import org.osgi.annotation.versioning.Version;
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/packageinfo b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/packageinfo
index 19727573b..0117a56c1 100644
--- a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/packageinfo
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/packageinfo
@@ -1 +1 @@
-version 1.2.2
+version 1.3
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/ServiceComponentRuntime.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/ServiceComponentRuntime.java
new file mode 100644
index 000000000..59760dcd5
--- /dev/null
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/ServiceComponentRuntime.java
@@ -0,0 +1,165 @@
+/*
+ * Copyright (c) OSGi Alliance (2013, 2014). 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.service.component.runtime;
+
+import java.util.Collection;
+import org.osgi.annotation.versioning.ProviderType;
+import org.osgi.framework.Bundle;
+import org.osgi.service.component.ComponentContext;
+import org.osgi.service.component.runtime.dto.ComponentConfigurationDTO;
+import org.osgi.service.component.runtime.dto.ComponentDescriptionDTO;
+import org.osgi.util.promise.Promise;
+
+/**
+ * The {@code ServiceComponentRuntime} service represents the Declarative
+ * Services actor, known as Service Component Runtime (SCR), that manages the
+ * service components and their life cycle. The {@code ServiceComponentRuntime}
+ * service allows introspection of the components managed by Service Component
+ * Runtime.
+ * 
+ * <p>
+ * This service differentiates between a {@link ComponentDescriptionDTO} and a
+ * {@link ComponentConfigurationDTO}. A {@link ComponentDescriptionDTO} is a
+ * representation of a declared component description. A
+ * {@link ComponentConfigurationDTO} is a representation of an actual instance
+ * of a declared component description parameterized by component properties.
+ * <p>
+ * 
+ * Access to this service requires the
+ * {@code ServicePermission[ServiceComponentRuntime, GET]} permission. It is
+ * intended that only administrative bundles should be granted this permission
+ * to limit access to the potentially intrusive methods provided by this
+ * service.
+ * 
+ * @ThreadSafe
+ * @since 1.3
+ * @author $Id$
+ */
+@ProviderType
+public interface ServiceComponentRuntime {
+
+	/**
+	 * Returns the component descriptions declared by the specified active
+	 * bundles.
+	 * 
+	 * <p>
+	 * Only component descriptions from active bundles are returned. If the
+	 * specified bundles have no declared components or are not active, an empty
+	 * collection is returned.
+	 * 
+	 * @param bundles The bundles whose declared component descriptions are to
+	 *        be returned. Specifying no bundles, or the equivalent of an empty
+	 *        {@code Bundle} array, will return the declared component
+	 *        descriptions from all active bundles.
+	 * @return The declared component descriptions of the specified active
+	 *         {@code bundles}. An empty collection is returned if there are no
+	 *         component descriptions for the specified active bundles.
+	 */
+	Collection<ComponentDescriptionDTO> getComponentDescriptionDTOs(Bundle... bundles);
+
+	/**
+	 * Returns the {@link ComponentDescriptionDTO} declared with the specified name
+	 * by the specified bundle.
+	 * 
+	 * <p>
+	 * Only component descriptions from active bundles are returned.
+	 * {@code null} if no such component is declared by the given {@code bundle}
+	 * or the bundle is not active.
+	 * 
+	 * @param bundle The bundle declaring the component description. Must not be
+	 *        {@code null}.
+	 * @param name The name of the component description. Must not be
+	 *        {@code null}.
+	 * @return The declared component description or {@code null} if the
+	 *         specified bundle is not active or does not declare a component
+	 *         description with the specified name.
+	 */
+	ComponentDescriptionDTO getComponentDescriptionDTO(Bundle bundle, String name);
+
+	/**
+	 * Returns the component configurations for the specified component
+	 * description.
+	 * 
+	 * @param description The component description. Must not be {@code null}.
+	 * @return A collection containing a snapshot of the current component
+	 *         configurations for the specified component description. An empty
+	 *         collection is returned if there are none.
+	 */
+	Collection<ComponentConfigurationDTO> getComponentConfigurationDTOs(ComponentDescriptionDTO description);
+
+	/**
+	 * Returns whether the specified component description is currently enabled.
+	 * 
+	 * <p>
+	 * The enabled state of a component description is initially set by the
+	 * {@link ComponentDescriptionDTO#defaultEnabled enabled} attribute of the
+	 * component description.
+	 * 
+	 * @param description The component description. Must not be {@code null}.
+	 * @return {@code true} if the specified component description is currently
+	 *         enabled. Otherwise, {@code false}.
+	 * @see #enableComponent(ComponentDescriptionDTO)
+	 * @see #disableComponent(ComponentDescriptionDTO)
+	 * @see ComponentContext#disableComponent(String)
+	 * @see ComponentContext#enableComponent(String)
+	 */
+	boolean isComponentEnabled(ComponentDescriptionDTO description);
+
+	/**
+	 * Enables the specified component description.
+	 * 
+	 * <p>
+	 * If the specified component description is currently enabled, this method
+	 * has no effect.
+	 * 
+	 * <p>
+	 * This method must return after changing the enabled state of the specified
+	 * component description. Any actions that result from this, such as
+	 * activating or deactivating a component configuration, must occur
+	 * asynchronously to this method call.
+	 * 
+	 * @param description The component description to enable. Must not be
+	 *        {@code null}.
+	 * @return A promise that will be resolved when the actions that result from
+	 *         changing the enabled state of the specified component have
+	 *         completed.
+	 * @see #isComponentEnabled(ComponentDescriptionDTO)
+	 */
+	Promise<Void> enableComponent(ComponentDescriptionDTO description);
+
+	/**
+	 * Disables the specified component description.
+	 * 
+	 * <p>
+	 * If the specified component description is currently disabled, this method
+	 * has no effect.
+	 * 
+	 * <p>
+	 * This method must return after changing the enabled state of the specified
+	 * component description. Any actions that result from this, such as
+	 * activating or deactivating a component configuration, must occur
+	 * asynchronously to this method call.
+	 * 
+	 * @param description The component description to disable. Must not be
+	 *        {@code null}.
+	 * @return A promise that will be resolved when the actions that result from
+	 *         changing the enabled state of the specified component have
+	 *         completed.
+	 * @see #isComponentEnabled(ComponentDescriptionDTO)
+	 */
+	Promise<Void> disableComponent(ComponentDescriptionDTO description);
+}
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/ComponentConfigurationDTO.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/ComponentConfigurationDTO.java
new file mode 100644
index 000000000..a3e98bbac
--- /dev/null
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/ComponentConfigurationDTO.java
@@ -0,0 +1,113 @@
+/*
+ * Copyright (c) OSGi Alliance (2013, 2014). 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.service.component.runtime.dto;
+
+import java.util.Map;
+import org.osgi.dto.DTO;
+import org.osgi.service.component.ComponentContext;
+
+/**
+ * A representation of an actual instance of a declared component description
+ * parameterized by component properties.
+ * 
+ * @since 1.3
+ * @NotThreadSafe
+ * @author $Id$
+ */
+public class ComponentConfigurationDTO extends DTO {
+	/**
+	 * The component configuration is unsatisfied due to a missing required
+	 * configuration.
+	 */
+	public static final int			UNSATISFIED_CONFIGURATION	= 1;
+
+	/**
+	 * The component configuration is unsatisfied due to an unsatisfied
+	 * reference.
+	 */
+	public static final int			UNSATISFIED_REFERENCE		= 2;
+
+	/**
+	 * The component configuration is satisfied.
+	 * 
+	 * <p>
+	 * Any {@link ComponentDescriptionDTO#serviceInterfaces services} declared
+	 * by the component description are registered.
+	 */
+	public static final int			SATISFIED					= 4;
+
+	/**
+	 * The component configuration is active.
+	 * 
+	 * <p>
+	 * This is the normal operational state of a component configuration.
+	 */
+	public static final int			ACTIVE						= 8;
+
+	/**
+	 * The representation of the component configuration's component
+	 * description.
+	 */
+	public ComponentDescriptionDTO	description;
+
+	/**
+	 * The current state of the component configuration.
+	 * 
+	 * <p>
+	 * This is one of {@link #UNSATISFIED_CONFIGURATION},
+	 * {@link #UNSATISFIED_REFERENCE}, {@link #SATISFIED} or {@link #ACTIVE}.
+	 */
+	public int							state;
+
+	/**
+	 * The id of the component configuration.
+	 * 
+	 * <p>
+	 * The id is a non-persistent, unique value assigned at runtime. The id is
+	 * also available as the {@code component.id} component property. The value
+	 * of this field is unspecified if the state of this component configuration
+	 * is unsatisfied.
+	 */
+	public long							id;
+
+	/**
+	 * The component properties for the component configuration.
+	 * 
+	 * @see ComponentContext#getProperties()
+	 */
+	public Map<String, Object>	properties;
+
+	/**
+	 * The satisfied references.
+	 * 
+	 * <p>
+	 * Each {@link SatisfiedReferenceDTO} in the array represents a satisfied
+	 * reference of the component configuration. The array must be empty if the
+	 * component configuration has no satisfied references.
+	 */
+	public SatisfiedReferenceDTO[]		satisfiedReferences;
+
+	/**
+	 * The unsatisfied references.
+	 * 
+	 * <p>
+	 * Each {@link UnsatisfiedReferenceDTO} in the array represents an
+	 * unsatisfied reference of the component configuration. The array must be
+	 * empty if the component configuration has no unsatisfied references.
+	 */
+	public UnsatisfiedReferenceDTO[]	unsatisfiedReferences;
+}
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/ComponentDescriptionDTO.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/ComponentDescriptionDTO.java
new file mode 100644
index 000000000..9f098a6ed
--- /dev/null
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/ComponentDescriptionDTO.java
@@ -0,0 +1,171 @@
+/*
+ * Copyright (c) OSGi Alliance (2013, 2014). 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.service.component.runtime.dto;
+
+import java.util.Map;
+import org.osgi.dto.DTO;
+import org.osgi.framework.dto.BundleDTO;
+
+/**
+ * A representation of a declared component description.
+ * 
+ * @since 1.3
+ * @NotThreadSafe
+ * @author $Id$
+ */
+public class ComponentDescriptionDTO extends DTO {
+	/**
+	 * The name of the component.
+	 * 
+	 * <p>
+	 * This is declared in the {@code name} attribute of the {@code component}
+	 * element. This must be the default name if the component description does
+	 * not declare a name.
+	 */
+	public String				name;
+
+	/**
+	 * The bundle declaring the component description.
+	 */
+	public BundleDTO			bundle;
+
+	/**
+	 * The component factory name.
+	 * 
+	 * <p>
+	 * This is declared in the {@code factory} attribute of the
+	 * {@code component} element. This must be {@code null} if the component
+	 * description is not declared as a component factory.
+	 */
+	public String				factory;
+
+	/**
+	 * The service scope.
+	 * 
+	 * <p>
+	 * This is declared in the {@code scope} attribute of the {@code service}
+	 * element. This must be {@code null} if the component description does not
+	 * declare any service interfaces.
+	 */
+	public String				scope;
+
+	/**
+	 * The fully qualified name of the implementation class.
+	 * 
+	 * <p>
+	 * This is declared in the {@code class} attribute of the
+	 * {@code implementation} element.
+	 */
+	public String				implementationClass;
+
+	/**
+	 * The initial enabled state.
+	 * 
+	 * <p>
+	 * This is declared in the {@code enabled} attribute of the
+	 * {@code component} element.
+	 */
+	public boolean				defaultEnabled;
+
+	/**
+	 * The immediate state.
+	 * 
+	 * <p>
+	 * This is declared in the {@code immediate} attribute of the
+	 * {@code component} element.
+	 */
+	public boolean				immediate;
+
+	/**
+	 * The fully qualified names of the service interfaces.
+	 * 
+	 * <p>
+	 * These are declared in the {@code interface} attribute of the
+	 * {@code provide} elements. The array must be empty if the component
+	 * description does not declare any service interfaces.
+	 */
+	public String[]				serviceInterfaces;
+
+	/**
+	 * The declared component properties.
+	 * 
+	 * <p>
+	 * These are declared in the {@code property} and {@code properties}
+	 * elements.
+	 */
+	public Map<String, Object>	properties;
+
+	/**
+	 * The referenced services.
+	 * 
+	 * <p>
+	 * These are declared in the {@code reference} elements. The array must be
+	 * empty if the component description does not declare references to any
+	 * services.
+	 */
+	public ReferenceDTO[]			references;
+
+	/**
+	 * The name of the activate method.
+	 * 
+	 * <p>
+	 * This is declared in the {@code activate} attribute of the
+	 * {@code component} element. This must be {@code null} if the component
+	 * description does not declare an activate method name.
+	 */
+	public String				activate;
+
+	/**
+	 * The name of the deactivate method.
+	 * 
+	 * <p>
+	 * This is declared in the {@code deactivate} attribute of the
+	 * {@code component} element. This must be {@code null} if the component
+	 * description does not declare a deactivate method name.
+	 */
+	public String				deactivate;
+
+	/**
+	 * The name of the modified method.
+	 * 
+	 * <p>
+	 * This is declared in the {@code modified} attribute of the
+	 * {@code component} element. This must be {@code null} if the component
+	 * description does not declare a modified method name.
+	 */
+	public String				modified;
+
+	/**
+	 * The configuration policy.
+	 * 
+	 * <p>
+	 * This is declared in the {@code configuration-policy} attribute of the
+	 * {@code component} element. This must be the default configuration policy
+	 * if the component description does not declare a configuration policy.
+	 */
+	public String				configurationPolicy;
+
+	/**
+	 * The configuration pids.
+	 * 
+	 * <p>
+	 * These are declared in the {@code configuration-pid} attribute of the
+	 * {@code component} element. This must contain the default configuration
+	 * pid if the component description does not declare a configuration pid.
+	 */
+	public String[]				configurationPid;
+}
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/ReferenceDTO.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/ReferenceDTO.java
new file mode 100644
index 000000000..fca241327
--- /dev/null
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/ReferenceDTO.java
@@ -0,0 +1,148 @@
+/*
+ * Copyright (c) OSGi Alliance (2013, 2015). 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.service.component.runtime.dto;
+
+import org.osgi.dto.DTO;
+
+/**
+ * A representation of a declared reference to a service.
+ * 
+ * @since 1.3
+ * @NotThreadSafe
+ * @author $Id$
+ */
+public class ReferenceDTO extends DTO {
+
+	/**
+	 * The name of the reference.
+	 * 
+	 * <p>
+	 * This is declared in the {@code name} attribute of the {@code reference}
+	 * element. This must be the default name if the component description does
+	 * not declare a name for the reference.
+	 */
+	public String	name;
+
+	/**
+	 * The service interface of the reference.
+	 * 
+	 * <p>
+	 * This is declared in the {@code interface} attribute of the
+	 * {@code reference} element.
+	 */
+	public String	interfaceName;
+
+	/**
+	 * The cardinality of the reference.
+	 * 
+	 * <p>
+	 * This is declared in the {@code cardinality} attribute of the
+	 * {@code reference} element. This must be the default cardinality if the
+	 * component description does not declare a cardinality for the reference.
+	 */
+	public String	cardinality;
+
+	/**
+	 * The policy of the reference.
+	 * 
+	 * <p>
+	 * This is declared in the {@code policy} attribute of the {@code reference}
+	 * element. This must be the default policy if the component description
+	 * does not declare a policy for the reference.
+	 */
+	public String	policy;
+
+	/**
+	 * The policy option of the reference.
+	 * 
+	 * <p>
+	 * This is declared in the {@code policy-option} attribute of the
+	 * {@code reference} element. This must be the default policy option if the
+	 * component description does not declare a policy option for the reference.
+	 */
+	public String	policyOption;
+
+	/**
+	 * The target of the reference.
+	 * 
+	 * <p>
+	 * This is declared in the {@code target} attribute of the {@code reference}
+	 * element. This must be {@code null} if the component description does not
+	 * declare a target for the reference.
+	 */
+	public String	target;
+
+	/**
+	 * The name of the bind method of the reference.
+	 * 
+	 * <p>
+	 * This is declared in the {@code bind} attribute of the {@code reference}
+	 * element. This must be {@code null} if the component description does not
+	 * declare a bind method for the reference.
+	 */
+	public String	bind;
+
+	/**
+	 * The name of the unbind method of the reference.
+	 * 
+	 * <p>
+	 * This is declared in the {@code unbind} attribute of the {@code reference}
+	 * element. This must be {@code null} if the component description does not
+	 * declare an unbind method for the reference.
+	 */
+	public String	unbind;
+
+	/**
+	 * The name of the updated method of the reference.
+	 * 
+	 * <p>
+	 * This is declared in the {@code updated} attribute of the
+	 * {@code reference} element. This must be {@code null} if the component
+	 * description does not declare an updated method for the reference.
+	 */
+	public String	updated;
+
+	/**
+	 * The name of the field of the reference.
+	 * 
+	 * <p>
+	 * This is declared in the {@code field} attribute of the {@code reference}
+	 * element. This must be {@code null} if the component description does not
+	 * declare a field for the reference.
+	 */
+	public String	field;
+
+	/**
+	 * The field option of the reference.
+	 * 
+	 * <p>
+	 * This is declared in the {@code field-option} attribute of the
+	 * {@code reference} element. This must be {@code null} if the component
+	 * description does not declare a field for the reference.
+	 */
+	public String	fieldOption;
+
+	/**
+	 * The scope of the reference.
+	 * 
+	 * <p>
+	 * This is declared in the {@code scope} attribute of the {@code reference}
+	 * element. This must be the default scope if the component description does
+	 * not declare a scope for the reference.
+	 */
+	public String	scope;
+}
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/SatisfiedReferenceDTO.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/SatisfiedReferenceDTO.java
new file mode 100644
index 000000000..20de229ef
--- /dev/null
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/SatisfiedReferenceDTO.java
@@ -0,0 +1,62 @@
+/*
+ * Copyright (c) OSGi Alliance (2013, 2014). 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.service.component.runtime.dto;
+
+import org.osgi.dto.DTO;
+import org.osgi.framework.dto.ServiceReferenceDTO;
+
+/**
+ * A representation of a satisfied reference.
+ * 
+ * @since 1.3
+ * @NotThreadSafe
+ * @author $Id$
+ */
+public class SatisfiedReferenceDTO extends DTO {
+	/**
+	 * The name of the declared reference.
+	 * 
+	 * <p>
+	 * This is declared in the {@code name} attribute of the {@code reference}
+	 * element of the component description.
+	 * 
+	 * @see ReferenceDTO#name
+	 */
+	public String					name;
+
+	/**
+	 * The target property of the satisfied reference.
+	 * 
+	 * <p>
+	 * This is the value of the {@link ComponentConfigurationDTO#properties
+	 * component property} whose name is the concatenation of the
+	 * {@link ReferenceDTO#name declared reference name} and
+	 * &quot;.target&quot;. This must be {@code null} if no target property is
+	 * set for the reference.
+	 */
+	public String					target;
+
+	/**
+	 * The bound services.
+	 * 
+	 * <p>
+	 * Each {@link ServiceReferenceDTO} in the array represents a service bound
+	 * to the satisfied reference. The array must be empty if there are no bound
+	 * services.
+	 */
+	public ServiceReferenceDTO[]	boundServices;
+}
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/UnsatisfiedReferenceDTO.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/UnsatisfiedReferenceDTO.java
new file mode 100644
index 000000000..20ce77a3d
--- /dev/null
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/UnsatisfiedReferenceDTO.java
@@ -0,0 +1,64 @@
+/*
+ * Copyright (c) OSGi Alliance (2013, 2014). 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.service.component.runtime.dto;
+
+import org.osgi.dto.DTO;
+import org.osgi.framework.dto.ServiceReferenceDTO;
+
+/**
+ * A representation of an unsatisfied reference.
+ * 
+ * @since 1.3
+ * @NotThreadSafe
+ * @author $Id$
+ */
+public class UnsatisfiedReferenceDTO extends DTO {
+	/**
+	 * The name of the declared reference.
+	 * 
+	 * <p>
+	 * This is declared in the {@code name} attribute of the {@code reference}
+	 * element of the component description.
+	 * 
+	 * @see ReferenceDTO#name
+	 */
+	public String					name;
+
+	/**
+	 * The target property of the unsatisfied reference.
+	 * 
+	 * <p>
+	 * This is the value of the {@link ComponentConfigurationDTO#properties
+	 * component property} whose name is the concatenation of the
+	 * {@link ReferenceDTO#name declared reference name} and
+	 * &quot;.target&quot;. This must be {@code null} if no target property is
+	 * set for the reference.
+	 */
+	public String					target;
+
+	/**
+	 * The target services.
+	 * 
+	 * <p>
+	 * Each {@link ServiceReferenceDTO} in the array represents a target service
+	 * for the reference. The array must be empty if there are no target
+	 * services. The upper bound on the number of target services in the array
+	 * is the upper bound on the {@link ReferenceDTO#cardinality cardinality} of
+	 * the reference.
+	 */
+	public ServiceReferenceDTO[]	targetServices;
+}
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/package-info.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/package-info.java
new file mode 100644
index 000000000..d7d82da09
--- /dev/null
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/package-info.java
@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) OSGi Alliance (2014). 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.
+ */
+
+/**
+ * Service Component Runtime Data Transfer Objects Package Version 1.3.
+ *
+ * <p>
+ * Bundles wishing to use this package must list the package in the
+ * Import-Package header of the bundle's manifest. This package has two types of
+ * users: the consumers that use the API in this package and the providers that
+ * implement the API in this package.
+ *
+ * <p>
+ * Example import for consumers using the API in this package:
+ * <p>
+ * {@code  Import-Package: org.osgi.service.component.runtime.dto; version="[1.3,2.0)"}
+ * <p>
+ * Example import for providers implementing the API in this package:
+ * <p>
+ * {@code  Import-Package: org.osgi.service.component.runtime.dto; version="[1.3,1.4)"}
+ *
+ * @author $Id$
+ */
+
+@Version("1.3")
+package org.osgi.service.component.runtime.dto;
+
+import org.osgi.annotation.versioning.Version;
+
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/packageinfo b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/packageinfo
new file mode 100644
index 000000000..0117a56c1
--- /dev/null
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/dto/packageinfo
@@ -0,0 +1 @@
+version 1.3
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/package-info.java b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/package-info.java
new file mode 100644
index 000000000..3d4fa42ce
--- /dev/null
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/package-info.java
@@ -0,0 +1,42 @@
+/*
+ * Copyright (c) OSGi Alliance (2013). 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.
+ */
+
+/**
+ * Service Component Runtime Package Version 1.3.
+ *
+ * <p>
+ * Bundles wishing to use this package must list the package in the
+ * Import-Package header of the bundle's manifest. This package has two types of
+ * users: the consumers that use the API in this package and the providers that
+ * implement the API in this package.
+ *
+ * <p>
+ * Example import for consumers using the API in this package:
+ * <p>
+ * {@code  Import-Package: org.osgi.service.component.runtime; version="[1.3,2.0)"}
+ * <p>
+ * Example import for providers implementing the API in this package:
+ * <p>
+ * {@code  Import-Package: org.osgi.service.component.runtime; version="[1.3,1.4)"}
+ *
+ * @author $Id$
+ */
+
+@Version("1.3")
+package org.osgi.service.component.runtime;
+
+import org.osgi.annotation.versioning.Version;
+
diff --git a/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/packageinfo b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/packageinfo
new file mode 100644
index 000000000..0117a56c1
--- /dev/null
+++ b/bundles/org.eclipse.osgi.services/src/org/osgi/service/component/runtime/packageinfo
@@ -0,0 +1 @@
+version 1.3