@Component
@Provides
public class MyComponent implements MyService {
    @Property(name="foo")
    @ServiceProperty
    private String m_foo;

    @Property(name="array")
    public void updateArray(String[] array) {
     //...
    }
}

<component classname="...MyComponent">
   <provides>{html}

h1. Configuration Handler

_The configuration handler aims to manage component configuration. This handler allows the configuration and dynamic reconfiguration of instances. A configuration is a set of couple (name, value). The name can be a field name or a property name associated to a field or/and a method. iPOJO also supports complex properties composed by maps, dictionaries, lists and arrays._

{div:class=toc}
{toc:maxLevel=4|minLevel=2}
{div}

h2. Configurable Properties

To support configuration, the component type needs to declare which properties are configurable. These properties are not necessarily service property but can be internal component property.

h2. Examples

{code:xml}
<iPOJO>
<Component className="fr.imag.adele.escoffier.hello.impl.HelloServiceImpl">
   <Provides>
       <Property<property name="foo" field="m_foo"/>
   </Provides>provides>
   <Properties<properties propagation="false"/>
       <Property name="foo" field="m_foo"/>
       <Property name="array" method="updateArray"/>
       <Property name="hello.language" type="java.lang.String"/>
   </Properties>properties>
</Component>
component>

<instance component="fr.imag.adele.escoffier.hello.impl.HelloServiceImpl" name="HelloService.MyComponent">
   <property name="foo" value="bar"/>
   <property name="array" value="\{1, 2, 3}"/>
   <property name="hello.language" value="en"/>
</instance>
</iPOJO>
{code}
In the previous 

If a property @Component(propagation=true)

@Updated
public void updated() {
  // The instance was reconfigured
}

// OR
@Updated
public void updated(Dictionary conf) {
  // The instance was reconfigured, conf is the new configuration.
}

@Component(managedservice="my.pid")
public class MyComponent {

}

<component classname="...MyComponent">
   <!-- ... -->
   <properties pid="my.pidhas a method, this method is invoked each time that the property value changes (the method is called to push the initial value just after the constructor). The method receives one argument of the type of the property (an integer array in the example).

h2. Exposing a Managed Service
The ManagedService is a service specified in the OSGi Compendium. It allows reconfiguring an instance with the Configuration Admin. There is two way for an iPOJO instance to expose a Managed Service.
* In the component type description by adding the {{pid}} attribute in the properties element 
* In the instance configuration by configuring the {{managed.service.pid}} property
{code:xml}
<iPOJO>
<Component className="fr.imag.adele.escoffier.hello.impl.HelloServiceImpl">
   <Provides>
       <Property name="foo" field="m_foo"/>
   </Provides>
   <Properties propagation="false" pid="mymanagedservicepid"/>
       <Property name="foo" field="m_foo"/>
       <Property name="array" method="updateArray"/>
       <Property name="hello.language" type="java.lang.String"/<!-- ... -->
   </Properties>properties>
</Component>
component>

<instance component="fr.imag.adele.escoffier.hello.impl.HelloServiceImpl" name="HelloService">
   <property name="foo" value="bar"/>
   <property name="array" value="\{1, 2, 3}"/>
   <property name="hello.language" value="en"/>
 .MyComponent">
  <property name="managed.service.pid" value="mymanagedservicepid2my.pid.2"/>
</instance>

If the managed service pid is specified both in the component type and in the instance configuration, the instance configuration is used.

@Updated
public void updated() {
  // The instance was reconfigured
}

// OR
@Updated
public void updated(Dictionary conf) {
  // The instance was reconfigured, conf is the new configuration.
}

In XML, the method name is given as an attribute of the {{properties}} element.
{code:xml}
<component className="...MyComponent">
   <!-- ... -->
   <properties updated="updated</iPOJO>
{code}
{info:title=Type vs. Instance configuration}
If the managed service pid is specified both in the component type and in the instance configuration, the instance configuration is used.
{info}

The managed service pid is the identifier used by the Configuration Admin to attach configuration to Managed Services. First this pid must be unique (as any pid in OSGi). Moreover, this pid cannot be the same one that the pid used in the Managed Service Factory to create the instance (if you use this way to create your instance).

When an instance is reconfigured with the Managed Service, the configuration is propagated if the propagation is enabled.

h2. Dynamic Reconfiguration using Factories or ManagedServiceFactories
The handler supports reconfiguration. To reconfigure an instance you can use both iPOJO Factory and the ManagedServiceFactory exposed by the factory of the targeted instance. By calling the method _reconfigure_ or _update_ (according of the service do you use), the handler receive the new configuration and apply it. If the propagation is activated, the service registrations are updated too.

h2. Being notified when a reconfiguration is completed
Sometimes you need to be notified when a reconfiguration is done (all setter method called). This can be done thanks to the {{updated}} attribute. This attribute specifies a method claeed when a configuration/reconfiguration is completed. This method receives a {{Dictionary}} containing the properties (pair <key,value>). Properties with no value are not in the received configuration.

{code:xml}
<Component className="...HelloServiceImpl">
   <Provides>
       <Property name="foo" field="m_foo"/>
   </Provides>
   <Properties updated="afterReconfiguration"/>
       <Property name="foo" field="m_foo"/>
       <Property name="array" method="updateArray"/>
       <Property name="hello.language" type="java.lang.String"/<!-- ... -->
   </Properties>properties>
</Component>
{code}

{code:java}
public void afterReconfiguration(Dictionary config) {
  ...
}
{code}
\\
{include: