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