JavaDoc and Doc reference
git-svn-id: https://svn.apache.org/repos/asf/felix/trunk@1129533 13f79535-47bb-0310-9956-ffa450edef68
diff --git a/scr/src/main/java/org/apache/felix/scr/impl/config/ScrConfiguration.java b/scr/src/main/java/org/apache/felix/scr/impl/config/ScrConfiguration.java
index 986e687..dec743a 100644
--- a/scr/src/main/java/org/apache/felix/scr/impl/config/ScrConfiguration.java
+++ b/scr/src/main/java/org/apache/felix/scr/impl/config/ScrConfiguration.java
@@ -30,10 +30,25 @@
/**
* The <code>ScrConfiguration</code> class conveys configuration for the
- * Felix DS implementation bundle. The basic configuration is retrieved from
- * bundle context properties. In addition, this class registers a ManagedService
- * service to receive configuration supplied from the Configuration Admin
- * service overlaying the static context properties.
+ * Felix DS implementation bundle.
+ * <p>
+ * <b>Configuration Source</b>
+ * <p>
+ * <ol>
+ * <li>Framework properties: These are read when the Declarative Services
+ * implementation is first started.</li>
+ * <li>Configuration Admin Service: Properties are provided by means of a
+ * <code>ManagedService</code> with Service PID
+ * <code>org.apache.felix.scr.ScrService</code>. This class uses an OSGi
+ * Service Factory ({@link ScrManagedServiceServiceFactory}) to register the
+ * managed service without requiring the Configuration Admin Service API to be
+ * required upfront.
+ * </li>
+ * </ol>
+ * <p>
+ * See the <i>Configuration</i> section of the
+ * <a href="http://felix.apache.org/site/apache-felix-service-component-runtime.html">Apache Felix Service Component Runtime</a>
+ * documentation page for detailed information.
*/
public class ScrConfiguration
{
@@ -83,6 +98,7 @@
props);
}
+ // Called from the ScrManagedService.updated method to reconfigure
void configure( Dictionary config )
{
if ( config == null )
@@ -97,6 +113,10 @@
}
}
+ /**
+ * Returns the current log level.
+ * @return
+ */
public int getLogLevel()
{
return logLevel;
diff --git a/scr/src/main/java/org/apache/felix/scr/impl/config/ScrManagedService.java b/scr/src/main/java/org/apache/felix/scr/impl/config/ScrManagedService.java
index c6b51f7..d64f88c 100644
--- a/scr/src/main/java/org/apache/felix/scr/impl/config/ScrManagedService.java
+++ b/scr/src/main/java/org/apache/felix/scr/impl/config/ScrManagedService.java
@@ -25,9 +25,15 @@
/**
* The <code>ScrManagedService</code> receives configuration for the Declarative
- * Services Runtime itself. This class is instantiated in a ServiceFactory
- * manner by the {@link ScrManagedServiceServiceFactory} when the Configuration
- * Admin service implementation and API is available.
+ * Services Runtime itself.
+ * <p>
+ * This class is instantiated in a ServiceFactory manner by the
+ * {@link ScrManagedServiceServiceFactory} when the Configuration Admin service
+ * implementation and API is available.
+ * <p>
+ * Requires OSGi Configuration Admin Service API available
+ *
+ * @see ScrManagedServiceServiceFactory
*/
public class ScrManagedService implements ManagedService
{
diff --git a/scr/src/main/java/org/apache/felix/scr/impl/config/ScrManagedServiceMetaTypeProvider.java b/scr/src/main/java/org/apache/felix/scr/impl/config/ScrManagedServiceMetaTypeProvider.java
index afbe66d..64300d3 100644
--- a/scr/src/main/java/org/apache/felix/scr/impl/config/ScrManagedServiceMetaTypeProvider.java
+++ b/scr/src/main/java/org/apache/felix/scr/impl/config/ScrManagedServiceMetaTypeProvider.java
@@ -30,6 +30,15 @@
* The <code>ScrManagedServiceMetaTypeProvider</code> receives the Declarative
* Services Runtime configuration (by extending the {@link ScrManagedService}
* class but also provides a MetaType Service ObjectClassDefinition.
+ * <p>
+ * This class is instantiated in a ServiceFactory manner by the
+ * {@link ScrManagedServiceServiceFactory} when the Configuration Admin service
+ * implementation and API is available and if the Metatype Service API is also
+ * available.
+ * <p>
+ * Requires OSGi Metatype Service API available
+ *
+ * @see ScrManagedServiceServiceFactory
*/
class ScrManagedServiceMetaTypeProvider extends ScrManagedService
implements MetaTypeProvider