[SSSD] Design Discussion: D-Bus responder
Jakub Hrozek
jhrozek at redhat.com
Fri Mar 7 16:05:45 UTC 2014
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.
More information about the sssd-devel
mailing list