On Mon, Feb 24, 2014 at 12:32:04PM +0100, Pavel Březina wrote:
https://fedorahosted.org/sssd/wiki/DesignDocs/DBusResponder
Hi,
I couldn't find the original thread so I'm starting a new one. I would
like us to agree on best practice of naming methods. The current design
is somewhat inconsistent, since it uses e.g. FindUserByName(name) and
GetDomain(name) for obtaining one object path by name.
I'm proposing the following convention:
* List<class>() returning array of object paths, no arguments
- ListUsers
- ListDomains
* Find<class><condition>(arg1, ...) returning array of object paths
- FindUsersByName(filter)
- FindGroupsByName(filter)
* Get<class><condition>(arg1, ...) returning single object path
- GetUserById(id)
- GetDomainByName(name)
As discussed on IRC, I actually used only Find and List as Get is used
by org.freedesktop.DBus.Properties.
Other changes to the document include methods for cached object
management and a note about getters being synchronous. Both were
proposed by Stef on IRC.