[riot-notifications] [RIOT-OS/RIOT] doc/memos: RDM Runtime Configuration Architecture (#10622)
notifications at github.com
Thu Jan 10 14:37:41 CET 2019
jia200x commented on this pull request.
+## 3.1. Registry handlers
+A RH represents a configuration group in the RIOT Registry. A RIOT
+module requires to implement and register a Registry Handler in order to expose
+its configurations to the Registry API.
+A RH is defined by a name and a series of handlers for
+interacting with the configuration parameters of the configuration group.
+These handlers are:
+- `set`: Sets a value to a configuration parameter. This handler MUST take care
+ of any logic to apply the value (e.g. data validation) or cache it until the
+commit handler is called
+- `get`: Gets the current value of a configuration parameter
+- `commit`: To be called when configuration parameters have been loaded from
+ storage. It could be use for special needed logic on applying configuration
> "commit: To be called when configuration parameters have been loaded from storage
I will remove this sentence
> commit: does the same as set, but also allows specially needed logic to be executed on applying configuration
Just for reference, `commit` does NOT do exactly the same as `set`. In fact, commit doesn't receive any keys or values.
The `set` handler only "sets" the value and the configuration MAY take effect. However, the only way to make sure all configurations take effect is calling `commit` after a batch of `set` calls
You are receiving this because you are subscribed to this thread.
Reply to this email directly or view it on GitHub:
-------------- next part --------------
An HTML attachment was scrubbed...
More information about the notifications