felix-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From pde...@apache.org
Subject svn commit: r1666326 - /felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/components.mdtext
Date Thu, 12 Mar 2015 22:30:38 GMT
Author: pderop
Date: Thu Mar 12 22:30:38 2015
New Revision: 1666326

URL: http://svn.apache.org/r1666326
Attempt to describe what happens during component instantiation.


Modified: felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/components.mdtext
URL: http://svn.apache.org/viewvc/felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/components.mdtext?rev=1666326&r1=1666325&r2=1666326&view=diff
--- felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/components.mdtext
+++ felix/site/trunk/content/documentation/subprojects/apache-felix-dependency-manager/reference/components.mdtext
Thu Mar 12 22:30:38 2015
@@ -61,7 +61,32 @@ then tracked.
 ## What happens during component instantiation ?
-TBD (in progress).
+1. The service is instantiated.
+2. The following special objects are injected through reflection on class fields, if 
+they exist (but you can deactivate this behavior from the API):
+  * BundleContext
+  * ServiceRegistration
+  * DependencyManager
+  * Component
+3. *autoconfig* dependencies are injected through reflection on class fields, if they exist.
If an *autoconfig*
+optional dependency is unavailable, a NullObject is then injected.
+4. Required dependency callbacks defined from the Activator are called.
+5. The component *init* method is called, and from that method you can then dynamically add

+more dependencies by using the Component parameter passed to the init method, or using 
+a class field of *Component* type (which in this case has been injected during step 2).
+6. When all required dependencies (including dependencies dynamically added from the *init*
+method) are available, they are injected (using callbacks, or autoconfig).
+7. The component *start* callback is invoked.
+8. Optional dependencies (with callbacks) are then tracked.
+9. The component service(s) is then registered in the OSGi service registry
+When using Annotations, there are some specific behaviors:
+* The *@init* method may return a Map that contains filters in order to 
+dynamically configure dependencies annotated with a *name* attribute, and the dependencies
+then be injected after the *@init* method (exactly if you would have added the dependencies
from the init method using the API).
+* The *@start* method may return a Map in order to dynamically add more service properties
(if the component provides some services).
+* The component can be dynamically stopped or restarted using a special *@LifecycleController*
 ## Interfaces and properties

View raw message