[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