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. _______________________________________________ sssd-devel mailing list sssd-devel@lists.fedorahosted.org https://lists.fedorahosted.org/mailman/listinfo/sssd-devel
