blob: 29abfc61723eede54862a2ef1cb9282ef9cfd985 [file] [log] [blame]
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!-- NewPage -->
<html lang="en">
<head>
<!-- Generated by javadoc (version 1.7.0_25) on Sat May 17 12:14:26 CEST 2014 -->
<meta http-equiv="Content-Type" content="text/html" charset="UTF-8">
<title>ConfigurationHandler (Apache Felix iPOJO ~ JavaDoc 1.12.0 API)</title>
<meta name="date" content="2014-05-17">
<link rel="stylesheet" type="text/css" href="../../../../../../stylesheet.css" title="Style">
</head>
<body>
<script type="text/javascript"><!--
if (location.href.indexOf('is-external=true') == -1) {
parent.document.title="ConfigurationHandler (Apache Felix iPOJO ~ JavaDoc 1.12.0 API)";
}
//-->
</script>
<noscript>
<div>JavaScript is disabled on your browser.</div>
</noscript>
<!-- ========= START OF TOP NAVBAR ======= -->
<div class="topNav"><a name="navbar_top">
<!-- -->
</a><a href="#skip-navbar_top" title="Skip navigation links"></a><a name="navbar_top_firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/ConfigurationHandler.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../../../index-all.html">Index</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li>Prev Class</li>
<li><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandlerDescription.html" title="class in org.apache.felix.ipojo.handlers.configuration"><span class="strong">Next Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../../../index.html?org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html" target="_top">Frames</a></li>
<li><a href="ConfigurationHandler.html" target="_top">No Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_top">
<li><a href="../../../../../../allclasses-noframe.html">All Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_top");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li><a href="#field_summary">Field</a>&nbsp;|&nbsp;</li>
<li><a href="#constructor_summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method_summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li><a href="#field_detail">Field</a>&nbsp;|&nbsp;</li>
<li><a href="#constructor_detail">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method_detail">Method</a></li>
</ul>
</div>
<a name="skip-navbar_top">
<!-- -->
</a></div>
<!-- ========= END OF TOP NAVBAR ========= -->
<!-- ======== START OF CLASS DATA ======== -->
<div class="header">
<div class="subTitle">org.apache.felix.ipojo.handlers.configuration</div>
<h2 title="Class ConfigurationHandler" class="title">Class ConfigurationHandler</h2>
</div>
<div class="contentContainer">
<ul class="inheritance">
<li><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../../../../org/apache/felix/ipojo/Handler.html" title="class in org.apache.felix.ipojo">org.apache.felix.ipojo.Handler</a></li>
<li>
<ul class="inheritance">
<li><a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html" title="class in org.apache.felix.ipojo">org.apache.felix.ipojo.PrimitiveHandler</a></li>
<li>
<ul class="inheritance">
<li>org.apache.felix.ipojo.handlers.configuration.ConfigurationHandler</li>
</ul>
</li>
</ul>
</li>
</ul>
</li>
</ul>
<div class="description">
<ul class="blockList">
<li class="blockList">
<dl>
<dt>All Implemented Interfaces:</dt>
<dd><a href="../../../../../../org/apache/felix/ipojo/ConstructorInjector.html" title="interface in org.apache.felix.ipojo">ConstructorInjector</a>, <a href="../../../../../../org/apache/felix/ipojo/FieldInterceptor.html" title="interface in org.apache.felix.ipojo">FieldInterceptor</a>, <a href="../../../../../../org/apache/felix/ipojo/MethodInterceptor.html" title="interface in org.apache.felix.ipojo">MethodInterceptor</a>, <a href="http://www.osgi.org/javadoc/r4v43/cmpn/org/osgi/service/cm/ManagedService.html?is-external=true" title="class or interface in org.osgi.service.cm">ManagedService</a></dd>
</dl>
<hr>
<br>
<pre>public class <a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.46">ConfigurationHandler</a>
extends <a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html" title="class in org.apache.felix.ipojo">PrimitiveHandler</a>
implements <a href="http://www.osgi.org/javadoc/r4v43/cmpn/org/osgi/service/cm/ManagedService.html?is-external=true" title="class or interface in org.osgi.service.cm">ManagedService</a></pre>
<div class="block">Handler managing the Configuration Admin.</div>
<dl><dt><span class="strong">Author:</span></dt>
<dd><a href="mailto:dev@felix.apache.org">Felix Project Team</a></dd></dl>
</li>
</ul>
</div>
<div class="summary">
<ul class="blockList">
<li class="blockList">
<!-- =========== FIELD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="field_summary">
<!-- -->
</a>
<h3>Field Summary</h3>
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Field Summary table, listing fields, and an explanation">
<caption><span>Fields</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Field and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>private <a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../../../../../../org/apache/felix/ipojo/util/Property.html" title="class in org.apache.felix.ipojo.util">Property</a>&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#m_configurableProperties">m_configurableProperties</a></strong></code>
<div class="block">List of the configurable fields.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>private boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#m_configurationAlreadyPushed">m_configurationAlreadyPushed</a></strong></code>
<div class="block">Check if the instance was already reconfigured by the configuration admin.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>private <a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandlerDescription.html" title="class in org.apache.felix.ipojo.handlers.configuration">ConfigurationHandlerDescription</a></code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#m_description">m_description</a></strong></code>
<div class="block">the handler description.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>private <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#m_lastConfiguration">m_lastConfiguration</a></strong></code>
<div class="block">The last configuration sent to listeners.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>private <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a>&lt;<a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationListener.html" title="interface in org.apache.felix.ipojo.handlers.configuration">ConfigurationListener</a>&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#m_listeners">m_listeners</a></strong></code>
<div class="block">The configuration listeners.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>private <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#m_managedServicePID">m_managedServicePID</a></strong></code>
<div class="block">Managed Service PID.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>private boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#m_mustPropagate">m_mustPropagate</a></strong></code>
<div class="block">should the component propagate configuration ?</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>private <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a></code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#m_propagatedFromCA">m_propagatedFromCA</a></strong></code>
<div class="block">Properties propagated from the configuration admin.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>private <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a></code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#m_propagatedFromInstance">m_propagatedFromInstance</a></strong></code>
<div class="block">Properties propagated during the last instance "update".</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>private <a href="../../../../../../org/apache/felix/ipojo/handlers/providedservice/ProvidedServiceHandler.html" title="class in org.apache.felix.ipojo.handlers.providedservice">ProvidedServiceHandler</a></code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#m_providedServiceHandler">m_providedServiceHandler</a></strong></code>
<div class="block">ProvidedServiceHandler of the component.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>private ServiceRegistration</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#m_sr">m_sr</a></strong></code>
<div class="block">Service Registration to publish the service registration.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>private <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a>&lt;<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt;</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#m_toPropagate">m_toPropagate</a></strong></code>
<div class="block">Properties to propagate.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>private <a href="../../../../../../org/apache/felix/ipojo/util/Callback.html" title="class in org.apache.felix.ipojo.util">Callback</a></code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#m_updated">m_updated</a></strong></code>
<div class="block">Updated method.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>static <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a></code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#MANAGED_SERVICE_PID">MANAGED_SERVICE_PID</a></strong></code>&nbsp;</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="fields_inherited_from_class_org.apache.felix.ipojo.PrimitiveHandler">
<!-- -->
</a>
<h3>Fields inherited from class&nbsp;org.apache.felix.ipojo.<a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html" title="class in org.apache.felix.ipojo">PrimitiveHandler</a></h3>
<code><a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#HANDLER_TYPE">HANDLER_TYPE</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="fields_inherited_from_class_org.apache.felix.ipojo.Handler">
<!-- -->
</a>
<h3>Fields inherited from class&nbsp;org.apache.felix.ipojo.<a href="../../../../../../org/apache/felix/ipojo/Handler.html" title="class in org.apache.felix.ipojo">Handler</a></h3>
<code><a href="../../../../../../org/apache/felix/ipojo/Handler.html#HANDLER_LEVEL_PROPERTY">HANDLER_LEVEL_PROPERTY</a>, <a href="../../../../../../org/apache/felix/ipojo/Handler.html#HANDLER_NAME_PROPERTY">HANDLER_NAME_PROPERTY</a>, <a href="../../../../../../org/apache/felix/ipojo/Handler.html#HANDLER_NAMESPACE_PROPERTY">HANDLER_NAMESPACE_PROPERTY</a>, <a href="../../../../../../org/apache/felix/ipojo/Handler.html#HANDLER_TYPE_PROPERTY">HANDLER_TYPE_PROPERTY</a>, <a href="../../../../../../org/apache/felix/ipojo/Handler.html#m_instance">m_instance</a>, <a href="../../../../../../org/apache/felix/ipojo/Handler.html#m_isValid">m_isValid</a></code></li>
</ul>
</li>
</ul>
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor_summary">
<!-- -->
</a>
<h3>Constructor Summary</h3>
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Constructor Summary table, listing constructors, and an explanation">
<caption><span>Constructors</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colOne" scope="col">Constructor and Description</th>
</tr>
<tr class="altColor">
<td class="colOne"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#ConfigurationHandler()">ConfigurationHandler</a></strong>()</code>&nbsp;</td>
</tr>
</table>
</li>
</ul>
<!-- ========== METHOD SUMMARY =========== -->
<ul class="blockList">
<li class="blockList"><a name="method_summary">
<!-- -->
</a>
<h3>Method Summary</h3>
<table class="overviewSummary" border="0" cellpadding="3" cellspacing="0" summary="Method Summary table, listing methods, and an explanation">
<caption><span>Methods</span><span class="tabEnd">&nbsp;</span></caption>
<tr>
<th class="colFirst" scope="col">Modifier and Type</th>
<th class="colLast" scope="col">Method and Description</th>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#addListener(org.apache.felix.ipojo.handlers.configuration.ConfigurationListener)">addListener</a></strong>(<a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationListener.html" title="interface in org.apache.felix.ipojo.handlers.configuration">ConfigurationListener</a>&nbsp;listener)</code>
<div class="block">Add the given listener to the configuration handler's list of listeners.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>protected void</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#addProperty(org.apache.felix.ipojo.util.Property)">addProperty</a></strong>(<a href="../../../../../../org/apache/felix/ipojo/util/Property.html" title="class in org.apache.felix.ipojo.util">Property</a>&nbsp;prop)</code>
<div class="block">Adds the given property metadata to the property metadata list.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#configure(org.apache.felix.ipojo.metadata.Element, java.util.Dictionary)">configure</a></strong>(<a href="../../../../../../org/apache/felix/ipojo/metadata/Element.html" title="class in org.apache.felix.ipojo.metadata">Element</a>&nbsp;metadata,
<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a>&nbsp;configuration)</code>
<div class="block">Configures the handler.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>private boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#detectConfigurationChanges(java.util.Dictionary)">detectConfigurationChanges</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a>&nbsp;configuration)</code>&nbsp;</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>private boolean</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#excluded(java.lang.String)">excluded</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>
<div class="block">Checks whether the property with this given name must not be propagated.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code><a href="../../../../../../org/apache/felix/ipojo/architecture/HandlerDescription.html" title="class in org.apache.felix.ipojo.architecture">HandlerDescription</a></code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#getDescription()">getDescription</a></strong>()</code>
<div class="block">Gets the configuration handler description.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>private <a href="../../../../../../org/apache/felix/ipojo/util/Property.html" title="class in org.apache.felix.ipojo.util">Property</a></code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#getPropertyByName(java.lang.String)">getPropertyByName</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</code>&nbsp;</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#initializeComponentFactory(org.apache.felix.ipojo.architecture.ComponentTypeDescription, org.apache.felix.ipojo.metadata.Element)">initializeComponentFactory</a></strong>(<a href="../../../../../../org/apache/felix/ipojo/architecture/ComponentTypeDescription.html" title="class in org.apache.felix.ipojo.architecture">ComponentTypeDescription</a>&nbsp;desc,
<a href="../../../../../../org/apache/felix/ipojo/metadata/Element.html" title="class in org.apache.felix.ipojo.metadata">Element</a>&nbsp;metadata)</code>
<div class="block">Initialize the component type.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>private void</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#notifyListeners(java.util.Map)">notifyListeners</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt;&nbsp;map)</code>
<div class="block">Notify all listeners that a reconfiguration has occurred.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>private void</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#notifyUpdated(java.lang.Object)">notifyUpdated</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;instance)</code>
<div class="block">Invokes the updated method.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#onCreation(java.lang.Object)">onCreation</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;instance)</code>
<div class="block">Handler createInstance method.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>private void</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#propagate(java.util.Dictionary, java.util.Dictionary)">propagate</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a>&nbsp;newProps,
<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a>&nbsp;oldProps)</code>
<div class="block">Removes the old properties from the provided services and propagate new properties.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#reconfigure(java.util.Dictionary)">reconfigure</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a>&nbsp;configuration)</code>
<div class="block">Reconfigure the component instance.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>private <a href="http://docs.oracle.com/javase/7/docs/api/java/util/Properties.html?is-external=true" title="class or interface in java.util">Properties</a></code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#reconfigureProperties(java.util.Dictionary)">reconfigureProperties</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a>&nbsp;configuration)</code>
<div class="block">Reconfigured configuration properties and returns non matching properties.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#reconfigureProperty(org.apache.felix.ipojo.util.Property, java.lang.Object)">reconfigureProperty</a></strong>(<a href="../../../../../../org/apache/felix/ipojo/util/Property.html" title="class in org.apache.felix.ipojo.util">Property</a>&nbsp;prop,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;value)</code>
<div class="block">Reconfigures the given property with the given value.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#removeListener(org.apache.felix.ipojo.handlers.configuration.ConfigurationListener)">removeListener</a></strong>(<a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationListener.html" title="interface in org.apache.felix.ipojo.handlers.configuration">ConfigurationListener</a>&nbsp;listener)</code>
<div class="block">Remove the given listener from the configuration handler's list of listeners.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#start()">start</a></strong>()</code>
<div class="block">Start method.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#stateChanged(int)">stateChanged</a></strong>(int&nbsp;state)</code>
<div class="block">This method is called when the component state changed.</div>
</td>
</tr>
<tr class="altColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#stop()">stop</a></strong>()</code>
<div class="block">Stop method.</div>
</td>
</tr>
<tr class="rowColor">
<td class="colFirst"><code>void</code></td>
<td class="colLast"><code><strong><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#updated(java.util.Dictionary)">updated</a></strong>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a>&nbsp;conf)</code>
<div class="block">Managed Service method.</div>
</td>
</tr>
</table>
<ul class="blockList">
<li class="blockList"><a name="methods_inherited_from_class_org.apache.felix.ipojo.PrimitiveHandler">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;org.apache.felix.ipojo.<a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html" title="class in org.apache.felix.ipojo">PrimitiveHandler</a></h3>
<code><a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#attach(org.apache.felix.ipojo.ComponentInstance)">attach</a>, <a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#getConstructorParameter(int)">getConstructorParameter</a>, <a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#getConstructorParameterType(int)">getConstructorParameterType</a>, <a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#getFactory()">getFactory</a>, <a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#getHandler(java.lang.String)">getHandler</a>, <a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#getInstanceManager()">getInstanceManager</a>, <a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#getLogger()">getLogger</a>, <a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#getPojoMetadata()">getPojoMetadata</a>, <a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#onEntry(java.lang.Object, java.lang.reflect.Member, java.lang.Object[])">onEntry</a>, <a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#onError(java.lang.Object, java.lang.reflect.Member, java.lang.Throwable)">onError</a>, <a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#onExit(java.lang.Object, java.lang.reflect.Member, java.lang.Object)">onExit</a>, <a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#onFinally(java.lang.Object, java.lang.reflect.Member)">onFinally</a>, <a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#onGet(java.lang.Object, java.lang.String, java.lang.Object)">onGet</a>, <a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#onSet(java.lang.Object, java.lang.String, java.lang.Object)">onSet</a>, <a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#setFactory(org.apache.felix.ipojo.Factory)">setFactory</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods_inherited_from_class_org.apache.felix.ipojo.Handler">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;org.apache.felix.ipojo.<a href="../../../../../../org/apache/felix/ipojo/Handler.html" title="class in org.apache.felix.ipojo">Handler</a></h3>
<code><a href="../../../../../../org/apache/felix/ipojo/Handler.html#debug(java.lang.String)">debug</a>, <a href="../../../../../../org/apache/felix/ipojo/Handler.html#error(java.lang.String)">error</a>, <a href="../../../../../../org/apache/felix/ipojo/Handler.html#error(java.lang.String, java.lang.Throwable)">error</a>, <a href="../../../../../../org/apache/felix/ipojo/Handler.html#getHandlerManager()">getHandlerManager</a>, <a href="../../../../../../org/apache/felix/ipojo/Handler.html#getValidity()">getValidity</a>, <a href="../../../../../../org/apache/felix/ipojo/Handler.html#info(java.lang.String)">info</a>, <a href="../../../../../../org/apache/felix/ipojo/Handler.html#isValid()">isValid</a>, <a href="../../../../../../org/apache/felix/ipojo/Handler.html#setValidity(boolean)">setValidity</a>, <a href="../../../../../../org/apache/felix/ipojo/Handler.html#warn(java.lang.String)">warn</a>, <a href="../../../../../../org/apache/felix/ipojo/Handler.html#warn(java.lang.String, java.lang.Throwable)">warn</a></code></li>
</ul>
<ul class="blockList">
<li class="blockList"><a name="methods_inherited_from_class_java.lang.Object">
<!-- -->
</a>
<h3>Methods inherited from class&nbsp;java.lang.<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a></h3>
<code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</a>, <a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true#wait(long, int)" title="class or interface in java.lang">wait</a></code></li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
<div class="details">
<ul class="blockList">
<li class="blockList">
<!-- ============ FIELD DETAIL =========== -->
<ul class="blockList">
<li class="blockList"><a name="field_detail">
<!-- -->
</a>
<h3>Field Detail</h3>
<a name="MANAGED_SERVICE_PID">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>MANAGED_SERVICE_PID</h4>
<pre>public static final&nbsp;<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.48">MANAGED_SERVICE_PID</a></pre>
<dl><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../constant-values.html#org.apache.felix.ipojo.handlers.configuration.ConfigurationHandler.MANAGED_SERVICE_PID">Constant Field Values</a></dd></dl>
</li>
</ul>
<a name="m_configurableProperties">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>m_configurableProperties</h4>
<pre>private&nbsp;<a href="http://docs.oracle.com/javase/7/docs/api/java/util/List.html?is-external=true" title="class or interface in java.util">List</a>&lt;<a href="../../../../../../org/apache/felix/ipojo/util/Property.html" title="class in org.apache.felix.ipojo.util">Property</a>&gt; <a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.52">m_configurableProperties</a></pre>
<div class="block">List of the configurable fields.</div>
</li>
</ul>
<a name="m_providedServiceHandler">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>m_providedServiceHandler</h4>
<pre>private&nbsp;<a href="../../../../../../org/apache/felix/ipojo/handlers/providedservice/ProvidedServiceHandler.html" title="class in org.apache.felix.ipojo.handlers.providedservice">ProvidedServiceHandler</a> <a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.57">m_providedServiceHandler</a></pre>
<div class="block">ProvidedServiceHandler of the component. It is useful to propagate
properties to service registrations.</div>
</li>
</ul>
<a name="m_propagatedFromInstance">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>m_propagatedFromInstance</h4>
<pre>private&nbsp;<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a> <a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.61">m_propagatedFromInstance</a></pre>
<div class="block">Properties propagated during the last instance "update".</div>
</li>
</ul>
<a name="m_toPropagate">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>m_toPropagate</h4>
<pre>private&nbsp;<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a>&lt;<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt; <a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.65">m_toPropagate</a></pre>
<div class="block">Properties to propagate.</div>
</li>
</ul>
<a name="m_propagatedFromCA">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>m_propagatedFromCA</h4>
<pre>private&nbsp;<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a> <a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.69">m_propagatedFromCA</a></pre>
<div class="block">Properties propagated from the configuration admin.</div>
</li>
</ul>
<a name="m_configurationAlreadyPushed">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>m_configurationAlreadyPushed</h4>
<pre>private&nbsp;boolean <a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.73">m_configurationAlreadyPushed</a></pre>
<div class="block">Check if the instance was already reconfigured by the configuration admin.</div>
</li>
</ul>
<a name="m_mustPropagate">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>m_mustPropagate</h4>
<pre>private&nbsp;boolean <a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.77">m_mustPropagate</a></pre>
<div class="block">should the component propagate configuration ?</div>
</li>
</ul>
<a name="m_sr">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>m_sr</h4>
<pre>private&nbsp;ServiceRegistration <a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.81">m_sr</a></pre>
<div class="block">Service Registration to publish the service registration.</div>
</li>
</ul>
<a name="m_managedServicePID">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>m_managedServicePID</h4>
<pre>private&nbsp;<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a> <a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.87">m_managedServicePID</a></pre>
<div class="block">Managed Service PID.
This PID must be different from the instance name if the instance was created
with the Configuration Admin.</div>
</li>
</ul>
<a name="m_description">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>m_description</h4>
<pre>private&nbsp;<a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandlerDescription.html" title="class in org.apache.felix.ipojo.handlers.configuration">ConfigurationHandlerDescription</a> <a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.91">m_description</a></pre>
<div class="block">the handler description.</div>
</li>
</ul>
<a name="m_updated">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>m_updated</h4>
<pre>private&nbsp;<a href="../../../../../../org/apache/felix/ipojo/util/Callback.html" title="class in org.apache.felix.ipojo.util">Callback</a> <a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.96">m_updated</a></pre>
<div class="block">Updated method.
This method is called when a reconfiguration is completed.</div>
</li>
</ul>
<a name="m_listeners">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>m_listeners</h4>
<pre>private final&nbsp;<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Set.html?is-external=true" title="class or interface in java.util">Set</a>&lt;<a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationListener.html" title="interface in org.apache.felix.ipojo.handlers.configuration">ConfigurationListener</a>&gt; <a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.100">m_listeners</a></pre>
<div class="block">The configuration listeners.</div>
</li>
</ul>
<a name="m_lastConfiguration">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>m_lastConfiguration</h4>
<pre>private&nbsp;<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt; <a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.104">m_lastConfiguration</a></pre>
<div class="block">The last configuration sent to listeners.</div>
</li>
</ul>
</li>
</ul>
<!-- ========= CONSTRUCTOR DETAIL ======== -->
<ul class="blockList">
<li class="blockList"><a name="constructor_detail">
<!-- -->
</a>
<h3>Constructor Detail</h3>
<a name="ConfigurationHandler()">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>ConfigurationHandler</h4>
<pre>public&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.46">ConfigurationHandler</a>()</pre>
</li>
</ul>
</li>
</ul>
<!-- ============ METHOD DETAIL ========== -->
<ul class="blockList">
<li class="blockList"><a name="method_detail">
<!-- -->
</a>
<h3>Method Detail</h3>
<a name="initializeComponentFactory(org.apache.felix.ipojo.architecture.ComponentTypeDescription, org.apache.felix.ipojo.metadata.Element)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>initializeComponentFactory</h4>
<pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.114">initializeComponentFactory</a>(<a href="../../../../../../org/apache/felix/ipojo/architecture/ComponentTypeDescription.html" title="class in org.apache.felix.ipojo.architecture">ComponentTypeDescription</a>&nbsp;desc,
<a href="../../../../../../org/apache/felix/ipojo/metadata/Element.html" title="class in org.apache.felix.ipojo.metadata">Element</a>&nbsp;metadata)
throws <a href="../../../../../../org/apache/felix/ipojo/ConfigurationException.html" title="class in org.apache.felix.ipojo">ConfigurationException</a></pre>
<div class="block">Initialize the component type.</div>
<dl>
<dt><strong>Overrides:</strong></dt>
<dd><code><a href="../../../../../../org/apache/felix/ipojo/Handler.html#initializeComponentFactory(org.apache.felix.ipojo.architecture.ComponentTypeDescription, org.apache.felix.ipojo.metadata.Element)">initializeComponentFactory</a></code>&nbsp;in class&nbsp;<code><a href="../../../../../../org/apache/felix/ipojo/Handler.html" title="class in org.apache.felix.ipojo">Handler</a></code></dd>
<dt><span class="strong">Parameters:</span></dt><dd><code>desc</code> - : component type description to populate.</dd><dd><code>metadata</code> - : component type metadata.</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="../../../../../../org/apache/felix/ipojo/ConfigurationException.html" title="class in org.apache.felix.ipojo">ConfigurationException</a></code> - : metadata are incorrect.</dd><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../org/apache/felix/ipojo/Handler.html#initializeComponentFactory(org.apache.felix.ipojo.architecture.ComponentTypeDescription, org.apache.felix.ipojo.metadata.Element)"><code>Handler.initializeComponentFactory(org.apache.felix.ipojo.architecture.ComponentTypeDescription, org.apache.felix.ipojo.metadata.Element)</code></a></dd></dl>
</li>
</ul>
<a name="configure(org.apache.felix.ipojo.metadata.Element, java.util.Dictionary)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>configure</h4>
<pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.232">configure</a>(<a href="../../../../../../org/apache/felix/ipojo/metadata/Element.html" title="class in org.apache.felix.ipojo.metadata">Element</a>&nbsp;metadata,
<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a>&nbsp;configuration)
throws <a href="../../../../../../org/apache/felix/ipojo/ConfigurationException.html" title="class in org.apache.felix.ipojo">ConfigurationException</a></pre>
<div class="block">Configures the handler.
Access to field does not require synchronization as this method is executed
before any thread access to this object.</div>
<dl>
<dt><strong>Specified by:</strong></dt>
<dd><code><a href="../../../../../../org/apache/felix/ipojo/Handler.html#configure(org.apache.felix.ipojo.metadata.Element, java.util.Dictionary)">configure</a></code>&nbsp;in class&nbsp;<code><a href="../../../../../../org/apache/felix/ipojo/Handler.html" title="class in org.apache.felix.ipojo">Handler</a></code></dd>
<dt><span class="strong">Parameters:</span></dt><dd><code>metadata</code> - the metadata of the component</dd><dd><code>configuration</code> - the instance configuration</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="../../../../../../org/apache/felix/ipojo/ConfigurationException.html" title="class in org.apache.felix.ipojo">ConfigurationException</a></code> - one property metadata is not correct</dd><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../org/apache/felix/ipojo/Handler.html#configure(org.apache.felix.ipojo.metadata.Element, java.util.Dictionary)"><code>Handler.configure(org.apache.felix.ipojo.metadata.Element, java.util.Dictionary)</code></a></dd></dl>
</li>
</ul>
<a name="stop()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>stop</h4>
<pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.336">stop</a>()</pre>
<div class="block">Stop method.
This method is synchronized to avoid the configuration admin pushing a configuration during the un-registration.
Do nothing.</div>
<dl>
<dt><strong>Specified by:</strong></dt>
<dd><code><a href="../../../../../../org/apache/felix/ipojo/Handler.html#stop()">stop</a></code>&nbsp;in class&nbsp;<code><a href="../../../../../../org/apache/felix/ipojo/Handler.html" title="class in org.apache.felix.ipojo">Handler</a></code></dd>
<dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../org/apache/felix/ipojo/Handler.html#stop()"><code>Handler.stop()</code></a></dd></dl>
</li>
</ul>
<a name="start()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>start</h4>
<pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.351">start</a>()</pre>
<div class="block">Start method.
This method is synchronized to avoid the config admin pushing a configuration before ending the method.
Propagate properties if the propagation is activated.</div>
<dl>
<dt><strong>Specified by:</strong></dt>
<dd><code><a href="../../../../../../org/apache/felix/ipojo/Handler.html#start()">start</a></code>&nbsp;in class&nbsp;<code><a href="../../../../../../org/apache/felix/ipojo/Handler.html" title="class in org.apache.felix.ipojo">Handler</a></code></dd>
<dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../org/apache/felix/ipojo/Handler.html#start()"><code>Handler.start()</code></a></dd></dl>
</li>
</ul>
<a name="addProperty(org.apache.felix.ipojo.util.Property)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>addProperty</h4>
<pre>protected&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.411">addProperty</a>(<a href="../../../../../../org/apache/felix/ipojo/util/Property.html" title="class in org.apache.felix.ipojo.util">Property</a>&nbsp;prop)</pre>
<div class="block">Adds the given property metadata to the property metadata list.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>prop</code> - : property metadata to add</dd></dl>
</li>
</ul>
<a name="reconfigure(java.util.Dictionary)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>reconfigure</h4>
<pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.423">reconfigure</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a>&nbsp;configuration)</pre>
<div class="block">Reconfigure the component instance.
Check if the new configuration modifies the current configuration.
Invokes the updated method if needed.</div>
<dl>
<dt><strong>Overrides:</strong></dt>
<dd><code><a href="../../../../../../org/apache/felix/ipojo/Handler.html#reconfigure(java.util.Dictionary)">reconfigure</a></code>&nbsp;in class&nbsp;<code><a href="../../../../../../org/apache/felix/ipojo/Handler.html" title="class in org.apache.felix.ipojo">Handler</a></code></dd>
<dt><span class="strong">Parameters:</span></dt><dd><code>configuration</code> - : the new configuration</dd><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../org/apache/felix/ipojo/Handler.html#reconfigure(java.util.Dictionary)"><code>Handler.reconfigure(java.util.Dictionary)</code></a></dd></dl>
</li>
</ul>
<a name="detectConfigurationChanges(java.util.Dictionary)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>detectConfigurationChanges</h4>
<pre>private&nbsp;boolean&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.455">detectConfigurationChanges</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a>&nbsp;configuration)</pre>
</li>
</ul>
<a name="getPropertyByName(java.lang.String)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getPropertyByName</h4>
<pre>private&nbsp;<a href="../../../../../../org/apache/felix/ipojo/util/Property.html" title="class in org.apache.felix.ipojo.util">Property</a>&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.516">getPropertyByName</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</pre>
</li>
</ul>
<a name="reconfigureProperties(java.util.Dictionary)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>reconfigureProperties</h4>
<pre>private&nbsp;<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Properties.html?is-external=true" title="class or interface in java.util">Properties</a>&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.532">reconfigureProperties</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a>&nbsp;configuration)</pre>
<div class="block">Reconfigured configuration properties and returns non matching properties.
When called, it must hold the monitor lock.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>configuration</code> - : new configuration</dd>
<dt><span class="strong">Returns:</span></dt><dd>the properties that does not match with configuration properties</dd></dl>
</li>
</ul>
<a name="excluded(java.lang.String)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>excluded</h4>
<pre>private&nbsp;boolean&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.571">excluded</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>&nbsp;name)</pre>
<div class="block">Checks whether the property with this given name must not be propagated.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>name</code> - the name of the property</dd>
<dt><span class="strong">Returns:</span></dt><dd><code>true</code> if the property must not be propagated</dd></dl>
</li>
</ul>
<a name="reconfigureProperty(org.apache.felix.ipojo.util.Property, java.lang.Object)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>reconfigureProperty</h4>
<pre>public&nbsp;<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.588">reconfigureProperty</a>(<a href="../../../../../../org/apache/felix/ipojo/util/Property.html" title="class in org.apache.felix.ipojo.util">Property</a>&nbsp;prop,
<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;value)</pre>
<div class="block">Reconfigures the given property with the given value.
This methods handles <a href="../../../../../../org/apache/felix/ipojo/InstanceManager.html#onSet(java.lang.Object, java.lang.String, java.lang.Object)"><code>InstanceManager.onSet(Object, String, Object)</code></a>
call and the callback invocation.
The reconfiguration occurs only if the value changes.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>prop</code> - the property object to reconfigure</dd><dd><code>value</code> - the new value.</dd>
<dt><span class="strong">Returns:</span></dt><dd>the new property value</dd></dl>
</li>
</ul>
<a name="propagate(java.util.Dictionary, java.util.Dictionary)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>propagate</h4>
<pre>private&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.609">propagate</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a>&nbsp;newProps,
<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a>&nbsp;oldProps)</pre>
<div class="block">Removes the old properties from the provided services and propagate new properties.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>newProps</code> - : new properties to propagate</dd><dd><code>oldProps</code> - : old properties to remove</dd></dl>
</li>
</ul>
<a name="onCreation(java.lang.Object)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>onCreation</h4>
<pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.648">onCreation</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;instance)</pre>
<div class="block">Handler createInstance method.
This method is override to allow delayed callback invocation.
Invokes the updated method if needed.</div>
<dl>
<dt><strong>Overrides:</strong></dt>
<dd><code><a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#onCreation(java.lang.Object)">onCreation</a></code>&nbsp;in class&nbsp;<code><a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html" title="class in org.apache.felix.ipojo">PrimitiveHandler</a></code></dd>
<dt><span class="strong">Parameters:</span></dt><dd><code>instance</code> - : the created object</dd><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../org/apache/felix/ipojo/PrimitiveHandler.html#onCreation(java.lang.Object)"><code>PrimitiveHandler.onCreation(Object)</code></a></dd></dl>
</li>
</ul>
<a name="notifyUpdated(java.lang.Object)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>notifyUpdated</h4>
<pre>private&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.676">notifyUpdated</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&nbsp;instance)</pre>
<div class="block">Invokes the updated method.
This method build the dictionary containing all valued properties,
as well as properties propagated to the provided service handler (
only if the propagation is enabled).</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>instance</code> - the instance on which the callback must be called.
If <code>null</code> the callback is called on all the existing
object.</dd></dl>
</li>
</ul>
<a name="updated(java.util.Dictionary)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>updated</h4>
<pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.751">updated</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Dictionary.html?is-external=true" title="class or interface in java.util">Dictionary</a>&nbsp;conf)
throws <a href="http://www.osgi.org/javadoc/r4v43/cmpn/org/osgi/service/cm/ConfigurationException.html?is-external=true" title="class or interface in org.osgi.service.cm">ConfigurationException</a></pre>
<div class="block">Managed Service method.
This method is called when the instance is reconfigured by the ConfigurationAdmin.
When called, it must hold the monitor lock.</div>
<dl>
<dt><strong>Specified by:</strong></dt>
<dd><code><a href="http://www.osgi.org/javadoc/r4v43/cmpn/org/osgi/service/cm/ManagedService.html?is-external=true#updated(java.util.Dictionary)" title="class or interface in org.osgi.service.cm">updated</a></code>&nbsp;in interface&nbsp;<code><a href="http://www.osgi.org/javadoc/r4v43/cmpn/org/osgi/service/cm/ManagedService.html?is-external=true" title="class or interface in org.osgi.service.cm">ManagedService</a></code></dd>
<dt><span class="strong">Parameters:</span></dt><dd><code>conf</code> - : pushed configuration.</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://www.osgi.org/javadoc/r4v43/cmpn/org/osgi/service/cm/ConfigurationException.html?is-external=true" title="class or interface in org.osgi.service.cm">ConfigurationException</a></code> - the reconfiguration failed.</dd><dt><span class="strong">See Also:</span></dt><dd><a href="http://www.osgi.org/javadoc/r4v43/cmpn/org/osgi/service/cm/ManagedService.html?is-external=true#updated(java.util.Dictionary)" title="class or interface in org.osgi.service.cm"><code>ManagedService.updated(java.util.Dictionary)</code></a></dd></dl>
</li>
</ul>
<a name="getDescription()">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>getDescription</h4>
<pre>public&nbsp;<a href="../../../../../../org/apache/felix/ipojo/architecture/HandlerDescription.html" title="class in org.apache.felix.ipojo.architecture">HandlerDescription</a>&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.788">getDescription</a>()</pre>
<div class="block">Gets the configuration handler description.</div>
<dl>
<dt><strong>Overrides:</strong></dt>
<dd><code><a href="../../../../../../org/apache/felix/ipojo/Handler.html#getDescription()">getDescription</a></code>&nbsp;in class&nbsp;<code><a href="../../../../../../org/apache/felix/ipojo/Handler.html" title="class in org.apache.felix.ipojo">Handler</a></code></dd>
<dt><span class="strong">Returns:</span></dt><dd>the configuration handler description.</dd><dt><span class="strong">See Also:</span></dt><dd><a href="../../../../../../org/apache/felix/ipojo/Handler.html#getDescription()"><code>Handler.getDescription()</code></a></dd></dl>
</li>
</ul>
<a name="addListener(org.apache.felix.ipojo.handlers.configuration.ConfigurationListener)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>addListener</h4>
<pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.798">addListener</a>(<a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationListener.html" title="interface in org.apache.felix.ipojo.handlers.configuration">ConfigurationListener</a>&nbsp;listener)</pre>
<div class="block">Add the given listener to the configuration handler's list of listeners.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>listener</code> - the <code>ConfigurationListener</code> object to be added</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if <code>listener</code> is <code>null</code></dd></dl>
</li>
</ul>
<a name="removeListener(org.apache.felix.ipojo.handlers.configuration.ConfigurationListener)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>removeListener</h4>
<pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.814">removeListener</a>(<a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationListener.html" title="interface in org.apache.felix.ipojo.handlers.configuration">ConfigurationListener</a>&nbsp;listener)</pre>
<div class="block">Remove the given listener from the configuration handler's list of listeners.
If the listeners is not registered, this method does nothing.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>listener</code> - the <code>ConfigurationListener</code> object to be removed</dd>
<dt><span class="strong">Throws:</span></dt>
<dd><code><a href="http://docs.oracle.com/javase/7/docs/api/java/lang/NullPointerException.html?is-external=true" title="class or interface in java.lang">NullPointerException</a></code> - if <code>listener</code> is <code>null</code></dd></dl>
</li>
</ul>
<a name="notifyListeners(java.util.Map)">
<!-- -->
</a>
<ul class="blockList">
<li class="blockList">
<h4>notifyListeners</h4>
<pre>private&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.839">notifyListeners</a>(<a href="http://docs.oracle.com/javase/7/docs/api/java/util/Map.html?is-external=true" title="class or interface in java.util">Map</a>&lt;<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</a>,<a href="http://docs.oracle.com/javase/7/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</a>&gt;&nbsp;map)</pre>
<div class="block">Notify all listeners that a reconfiguration has occurred.</div>
<dl><dt><span class="strong">Parameters:</span></dt><dd><code>map</code> - the new configuration of the component instance.</dd></dl>
</li>
</ul>
<a name="stateChanged(int)">
<!-- -->
</a>
<ul class="blockListLast">
<li class="blockList">
<h4>stateChanged</h4>
<pre>public&nbsp;void&nbsp;<a href="../../../../../../src-html/org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html#line.900">stateChanged</a>(int&nbsp;state)</pre>
<div class="block"><strong>Description copied from class:&nbsp;<code><a href="../../../../../../org/apache/felix/ipojo/Handler.html#stateChanged(int)">Handler</a></code></strong></div>
<div class="block">This method is called when the component state changed.
By default, this method does nothing.</div>
<dl>
<dt><strong>Overrides:</strong></dt>
<dd><code><a href="../../../../../../org/apache/felix/ipojo/Handler.html#stateChanged(int)">stateChanged</a></code>&nbsp;in class&nbsp;<code><a href="../../../../../../org/apache/felix/ipojo/Handler.html" title="class in org.apache.felix.ipojo">Handler</a></code></dd>
<dt><span class="strong">Parameters:</span></dt><dd><code>state</code> - the new instance state <a href="../../../../../../org/apache/felix/ipojo/ComponentInstance.html" title="interface in org.apache.felix.ipojo"><code>ComponentInstance</code></a></dd></dl>
</li>
</ul>
</li>
</ul>
</li>
</ul>
</div>
</div>
<!-- ========= END OF CLASS DATA ========= -->
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<div class="bottomNav"><a name="navbar_bottom">
<!-- -->
</a><a href="#skip-navbar_bottom" title="Skip navigation links"></a><a name="navbar_bottom_firstrow">
<!-- -->
</a>
<ul class="navList" title="Navigation">
<li><a href="../../../../../../overview-summary.html">Overview</a></li>
<li><a href="package-summary.html">Package</a></li>
<li class="navBarCell1Rev">Class</li>
<li><a href="class-use/ConfigurationHandler.html">Use</a></li>
<li><a href="package-tree.html">Tree</a></li>
<li><a href="../../../../../../deprecated-list.html">Deprecated</a></li>
<li><a href="../../../../../../index-all.html">Index</a></li>
</ul>
</div>
<div class="subNav">
<ul class="navList">
<li>Prev Class</li>
<li><a href="../../../../../../org/apache/felix/ipojo/handlers/configuration/ConfigurationHandlerDescription.html" title="class in org.apache.felix.ipojo.handlers.configuration"><span class="strong">Next Class</span></a></li>
</ul>
<ul class="navList">
<li><a href="../../../../../../index.html?org/apache/felix/ipojo/handlers/configuration/ConfigurationHandler.html" target="_top">Frames</a></li>
<li><a href="ConfigurationHandler.html" target="_top">No Frames</a></li>
</ul>
<ul class="navList" id="allclasses_navbar_bottom">
<li><a href="../../../../../../allclasses-noframe.html">All Classes</a></li>
</ul>
<div>
<script type="text/javascript"><!--
allClassesLink = document.getElementById("allclasses_navbar_bottom");
if(window==top) {
allClassesLink.style.display = "block";
}
else {
allClassesLink.style.display = "none";
}
//-->
</script>
</div>
<div>
<ul class="subNavList">
<li>Summary:&nbsp;</li>
<li>Nested&nbsp;|&nbsp;</li>
<li><a href="#field_summary">Field</a>&nbsp;|&nbsp;</li>
<li><a href="#constructor_summary">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method_summary">Method</a></li>
</ul>
<ul class="subNavList">
<li>Detail:&nbsp;</li>
<li><a href="#field_detail">Field</a>&nbsp;|&nbsp;</li>
<li><a href="#constructor_detail">Constr</a>&nbsp;|&nbsp;</li>
<li><a href="#method_detail">Method</a></li>
</ul>
</div>
<a name="skip-navbar_bottom">
<!-- -->
</a></div>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<p class="legalCopy"><small>Copyright &#169; 2014. All rights reserved.</small></p>
</body>
</html>