You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@felix.apache.org by pd...@apache.org on 2018/09/30 22:09:44 UTC
svn commit: r1842415 - in /felix/trunk/dependencymanager:
org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/
org.apache.felix.dependencymanager/src/org/apache/felix/dm/
Author: pderop
Date: Sun Sep 30 22:09:43 2018
New Revision: 1842415
URL: http://svn.apache.org/viewvc?rev=1842415&view=rev
Log:
FELIX-5941: fixed some javadocs
Modified:
felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/AdapterService.java
felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/BundleAdapterService.java
felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/BundleDependency.java
felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/ConfigurationDependency.java
felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/ServiceDependency.java
felix/trunk/dependencymanager/org.apache.felix.dependencymanager/src/org/apache/felix/dm/BundleComponent.java
Modified: felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/AdapterService.java
URL: http://svn.apache.org/viewvc/felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/AdapterService.java?rev=1842415&r1=1842414&r2=1842415&view=diff
==============================================================================
--- felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/AdapterService.java (original)
+++ felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/AdapterService.java Sun Sep 30 22:09:43 2018
@@ -180,6 +180,8 @@ public @interface AdapterService
/**
* Specifies if adaptee service properties should be propagated to the adapter service.
+ * The component provided service properties take precedence over the propagated adaptee service properties, meaning
+ * that a give component service property overrides the same property present in the propagated adaptee service properties.
* @return the service propagation flag
*/
boolean propagate() default true;
Modified: felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/BundleAdapterService.java
URL: http://svn.apache.org/viewvc/felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/BundleAdapterService.java?rev=1842415&r1=1842414&r2=1842415&view=diff
==============================================================================
--- felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/BundleAdapterService.java (original)
+++ felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/BundleAdapterService.java Sun Sep 30 22:09:43 2018
@@ -89,6 +89,8 @@ public @Retention(RetentionPolicy.CLASS)
/**
* Specifies if manifest headers from the bundle should be propagated to the service properties.
+ * The component service properties take precedence over the propagated bundle manifest headers.
+ *
* @return the propagation flag
*/
boolean propagate() default true;
Modified: felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/BundleDependency.java
URL: http://svn.apache.org/viewvc/felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/BundleDependency.java?rev=1842415&r1=1842414&r2=1842415&view=diff
==============================================================================
--- felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/BundleDependency.java (original)
+++ felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/BundleDependency.java Sun Sep 30 22:09:43 2018
@@ -92,8 +92,10 @@ public @interface BundleDependency
int stateMask() default Bundle.INSTALLED | Bundle.RESOLVED | Bundle.ACTIVE;
/**
- * Specifies if the manifest headers from the bundle should be propagated to
- * the service properties.
+ * Specifies if the manifest headers from the bundle should be propagated to the service properties.
+ * The provided service properties take precedence over the propagated bundle manifest headers.
+ * It means a bundle manifest header won't override a component service property having the same name.
+ *
* @return the propagation flag
*/
boolean propagate() default false;
Modified: felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/ConfigurationDependency.java
URL: http://svn.apache.org/viewvc/felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/ConfigurationDependency.java?rev=1842415&r1=1842414&r2=1842415&view=diff
==============================================================================
--- felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/ConfigurationDependency.java (original)
+++ felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/ConfigurationDependency.java Sun Sep 30 22:09:43 2018
@@ -185,7 +185,10 @@ public @interface ConfigurationDependenc
/**
* Returns true if the configuration properties must be published along with the service.
- * Any additional service properties specified directly are merged with these.
+ * Any additional service properties specified directly are merged with these. The configuration
+ * dependency properties take precedence over the component service properties, meaning that a given configuration
+ * property will override the same property that is already present in the component service properties.
+ *
* @return true if configuration must be published along with the service, false if not.
*/
boolean propagate() default false;
Modified: felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/ServiceDependency.java
URL: http://svn.apache.org/viewvc/felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/ServiceDependency.java?rev=1842415&r1=1842414&r2=1842415&view=diff
==============================================================================
--- felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/ServiceDependency.java (original)
+++ felix/trunk/dependencymanager/org.apache.felix.dependencymanager.annotation/src/org/apache/felix/dm/annotation/api/ServiceDependency.java Sun Sep 30 22:09:43 2018
@@ -231,6 +231,8 @@ public @interface ServiceDependency
/**
* Returns true if the dependency service properties must be published along with the service.
* Any additional service properties specified directly are merged with these.
+ * The component provided service properties take precedence over the propagated service dependency properties, meaning
+ * that a give component service property overrides the same property included in the propagated service dependency properties.
* @return true if dependency service properties must be published along with the service, false if not.
*/
boolean propagate() default false;
Modified: felix/trunk/dependencymanager/org.apache.felix.dependencymanager/src/org/apache/felix/dm/BundleComponent.java
URL: http://svn.apache.org/viewvc/felix/trunk/dependencymanager/org.apache.felix.dependencymanager/src/org/apache/felix/dm/BundleComponent.java?rev=1842415&r1=1842414&r2=1842415&view=diff
==============================================================================
--- felix/trunk/dependencymanager/org.apache.felix.dependencymanager/src/org/apache/felix/dm/BundleComponent.java (original)
+++ felix/trunk/dependencymanager/org.apache.felix.dependencymanager/src/org/apache/felix/dm/BundleComponent.java Sun Sep 30 22:09:43 2018
@@ -110,7 +110,8 @@ public interface BundleComponent extends
BundleComponent setBundleCallbackInstance(Object callbackInstance);
/**
- * Sets if the bundle manifest headers should be propagated to the bundle component adapter service consumer (true by default)
+ * Sets if the bundle manifest headers should be propagated to the bundle component adapter service consumer (true by default).
+ * The component service properties take precedence over the propagated bundle manifest headers.
* @param propagate true if the bundle manifest headers should be propagated to the adapter service consumers
* @return this BundleComponent
*/