Update the configuration for a Managed Service.
When the implementation of updated(Dictionary)
detects any
kind of error in the configuration properties, it should create a new
ConfigurationException
which describes the problem. This
can allow a management system to provide useful information to a human
administrator.
If this method throws any other Exception
, the
Configuration Admin service must catch it and should log it.
The Configuration Admin service must call this method asynchronously
which initiated the callback. This implies that implementors of Managed
Service can be assured that the callback will not take place during
registration when they execute the registration in a synchronized method.
- Specified by:
updated
in interface ManagedService
- Parameters:
properties
- A copy of the Configuration properties, or
null
. This argument must not contain the
"service.bundleLocation" property. The value of this property may
be obtained from the Configuration.getBundleLocation
method.
- Throws:
ConfigurationException
- when the update fails