commit 3fffd04fd85ba9b32b7ec1158653bf052d89f4cb
author Pierre De Rop <pderop@apache.org> Fri Jun 11 07:18:23 2010 +0000
committer Pierre De Rop <pderop@apache.org> Fri Jun 11 07:18:23 2010 +0000
tree 9a989c73cc12c705b005e5ed9e7e0bab02e00092
parent 5d7d0e890c03b8c780b11e3e0f025ef3ea9945aa

fixed javadoc

git-svn-id: https://svn.apache.org/repos/asf/felix/trunk@953586 13f79535-47bb-0310-9956-ffa450edef68

dependencymanager/annotation/src/main/java/org/apache/felix/dm/annotation/api/ServiceDependency.java

diff --git a/dependencymanager/annotation/src/main/java/org/apache/felix/dm/annotation/api/ServiceDependency.java b/dependencymanager/annotation/src/main/java/org/apache/felix/dm/annotation/api/ServiceDependency.java
index 602eb71..776a0cf 100644
--- a/dependencymanager/annotation/src/main/java/org/apache/felix/dm/annotation/api/ServiceDependency.java
+++ b/dependencymanager/annotation/src/main/java/org/apache/felix/dm/annotation/api/ServiceDependency.java
@@ -108,6 +108,40 @@
     /**
      * Sets the dependency name. This attribute is only meaningful when dynamically configuring the dependency 
      * <code>filter</code> and <code>required</code> flag from the Service's init method.
+     * 
+     * Usage Example of a Service whose dependency filter is configured from ConfigAdmin:
+     * 
+     * <blockquote><pre>
+     *  &#47;**
+     *    * A Service whose service dependency filter/require attribute may be configured from ConfigAdmin
+     *    *&#47;
+     *  &#64;Service
+     *  class X {
+     *      private Dictionary m_config;
+     *      
+     *      &#64;ConfigurationDependency(pid="MyPid")
+     *      void configure(Dictionary conf) {
+     *           // Initialize our service from config ...
+     *           
+     *           // And store the config for later usage (from our init method)
+     *           m_config = config;
+     *      }
+     * 
+     *      // The returned Map will be used to configure our "dependency1" Dependency.
+     *      &#64;Init
+     *      Map init() {
+     *          return new HashMap() {{
+     *              put("dependency1.filter", m_config.get("filter"));
+     *              put("dependency1.required", m_config.get("required"));
+     *          }};
+     *      } 
+     *      
+     *      &#64;ServiceDependency(name="dependency1") 
+     *      void bindOtherService(OtherService other) {
+     *         // the filter and required flag will be configured from our init method.
+     *      }
+     *  }
+     *  </pre></blockquote>
      */
     String name() default "";
 }

dependencymanager/runtime/src/main/java/org/apache/felix/dm/runtime/ServiceLifecycleHandler.java

diff --git a/dependencymanager/runtime/src/main/java/org/apache/felix/dm/runtime/ServiceLifecycleHandler.java b/dependencymanager/runtime/src/main/java/org/apache/felix/dm/runtime/ServiceLifecycleHandler.java
index 7f79a26..a5e6395 100644
--- a/dependencymanager/runtime/src/main/java/org/apache/felix/dm/runtime/ServiceLifecycleHandler.java
+++ b/dependencymanager/runtime/src/main/java/org/apache/felix/dm/runtime/ServiceLifecycleHandler.java
@@ -52,24 +52,23 @@
  * 
  * Example of a Service whose dependency filter is configured from ConfigAdmin:
  * 
- * <blockquote>
- * 
- * <pre>
+ * <blockquote><pre>
  *  &#47;**
- *    * All Service whose service dependency filter/require attribute may be configured from ConfigAdmin
+ *    * A Service whose service dependency filter/require attribute may be configured from ConfigAdmin
  *    *&#47;
  *  &#64;Service
  *  class X {
  *      private Dictionary m_config;
  *      
- *      @ConfigurationDependency(pid="MyPid")
+ *      &#64;ConfigurationDependency(pid="MyPid")
  *      void configure(Dictionary conf) {
  *           // Initialize our service from config ...
  *           
- *           // And store the config for late usage (from our init method)
+ *           // And store the config for later usage (from our init method)
  *           m_config = config;
  *      }
- * 
+ *
+ *      // The returned Map will be used to configure our "dependency1" Dependency.
  *      &#64;Init
  *      Map init() {
  *          return new HashMap() {{
@@ -83,6 +82,7 @@
  *         // the filter and required flag will be configured from our init method.
  *      }
  *  }
+ *  </pre></blockquote>
  */
 public class ServiceLifecycleHandler
 {