com.atlassian.crowd.directory.ldap.cache

Interface DirectoryCache

All Known Implementing Classes:

DirectoryCacheImplUsingChangeOperations

public interface DirectoryCache

A cache of users, groups and memberships for an external Directory. The CacheRefresher passes the updated data to this interface for caching.

See Also:

UsnChangedCacheRefresher

Method Summary

Modifier and Type	Method and Description
void	addGroupToGroup(String childGroup, String parentGroup)
void	addOrUpdateCachedGroup(Group group)
void	addOrUpdateCachedGroups(List<? extends Group> groups, Date syncStartDate)
void	addOrUpdateCachedUser(User user)
void	addOrUpdateCachedUsers(List<? extends User> users, Date syncStartDate) Synchronises a list of Users from an external directory in the local cache.
void	addUserToGroup(String username, String groupName)
void	applySyncingGroupAttributes(String groupName, Set<String> deletedAttributes, Map<String,Set<String>> storedAttributes) Removes any syncing group attributes listed in deletedAttributes, and store any that are listed in storedAttributes If any non-syncing attributes are included, they will be ignored
void	applySyncingUserAttributes(String userName, Set<String> deletedAttributes, Map<String,Set<String>> storedAttributes) Removes any syncing user attributes listed in deletedAttributes, and store any that are listed in storedAttributes If any non-syncing attributes are included, they will be ignored
void	deleteCachedGroup(String groupName)
void	deleteCachedGroups(Set<String> groupnames)
void	deleteCachedGroupsByGuids(Set<String> guids)
void	deleteCachedGroupsNotIn(GroupType groupType, List<? extends Group> ldapGroups, Date syncStartDate)
void	deleteCachedUser(String username)
void	deleteCachedUsersByGuid(Set<String> guids)
void	deleteCachedUsersNotIn(List<? extends User> users, Date syncStartDate)
GroupWithAttributes	findGroupWithAttributesByName(String name)
UserWithAttributes	findUserWithAttributesByName(String name)
Set<String>	getAllUserGuids() Returns a set of all user guids present in the cache excluding null values.
long	getUserCount() Counts users in directory cache.
void	removeGroupFromGroup(String childGroup, String parentGroup)
void	removeUserFromGroup(String username, String groupName)
void	syncGroupMembersForGroup(Group ldapGroup, Collection<String> groups)
void	syncGroupMembershipsAndMembersForGroup(String groupName, Set<String> parentGroupNames, Set<String> childGroupNames)
void	syncGroupMembershipsForUser(String childUsername, Set<String> parentGroupNames)
void	syncUserMembersForGroup(Group ldapGroup, Collection<String> remoteUsers)

Method Detail

addOrUpdateCachedUsers

void addOrUpdateCachedUsers(List<? extends User> users,
                            Date syncStartDate)
                     throws OperationFailedException

Synchronises a list of Users from an external directory in the local cache.

If the syncStartDate is not null, then it is used to ensure we don't re-introduce stale data if a User is updated locally after we did our search. Some callers may intentionally choose to pass null - eg when UsnChangedCacheRefresher does a partial synchronise.

Parameters:

users - A list of Users from the external directory.

syncStartDate - The date that the synchronise started (can be null).

Throws:

OperationFailedException - If the Internal Directory throws a OperationFailedException - which seems unlikely.

deleteCachedUsersNotIn

void deleteCachedUsersNotIn(List<? extends User> users,
                            Date syncStartDate)
                     throws OperationFailedException

Throws:

OperationFailedException

deleteCachedUsersByGuid

void deleteCachedUsersByGuid(Set<String> guids)
                      throws OperationFailedException

Throws:

OperationFailedException

addOrUpdateCachedGroups

void addOrUpdateCachedGroups(List<? extends Group> groups,
                             Date syncStartDate)
                      throws OperationFailedException

Throws:

OperationFailedException

deleteCachedGroupsNotIn

void deleteCachedGroupsNotIn(GroupType groupType,
                             List<? extends Group> ldapGroups,
                             Date syncStartDate)
                      throws OperationFailedException

Throws:

OperationFailedException

deleteCachedGroups

void deleteCachedGroups(Set<String> groupnames)
                 throws OperationFailedException

Throws:

OperationFailedException

deleteCachedGroupsByGuids

void deleteCachedGroupsByGuids(Set<String> guids)
                        throws OperationFailedException

Throws:

OperationFailedException

syncUserMembersForGroup

void syncUserMembersForGroup(Group ldapGroup,
                             Collection<String> remoteUsers)
                      throws OperationFailedException

Throws:

OperationFailedException

syncGroupMembersForGroup

void syncGroupMembersForGroup(Group ldapGroup,
                              Collection<String> groups)
                       throws OperationFailedException

Throws:

OperationFailedException

addOrUpdateCachedUser

void addOrUpdateCachedUser(User user)
                    throws OperationFailedException

Throws:

OperationFailedException

deleteCachedUser

void deleteCachedUser(String username)
               throws OperationFailedException

Throws:

OperationFailedException

addOrUpdateCachedGroup

void addOrUpdateCachedGroup(Group group)
                     throws OperationFailedException

Throws:

OperationFailedException

deleteCachedGroup

void deleteCachedGroup(String groupName)
                throws OperationFailedException

Throws:

OperationFailedException

addUserToGroup

void addUserToGroup(String username,
                    String groupName)
             throws OperationFailedException

Throws:

OperationFailedException

removeUserFromGroup

void removeUserFromGroup(String username,
                         String groupName)
                  throws OperationFailedException

Throws:

OperationFailedException

addGroupToGroup

void addGroupToGroup(String childGroup,
                     String parentGroup)
              throws OperationFailedException

Throws:

OperationFailedException

removeGroupFromGroup

void removeGroupFromGroup(String childGroup,
                          String parentGroup)
                   throws OperationFailedException

Throws:

OperationFailedException

syncGroupMembershipsForUser

void syncGroupMembershipsForUser(String childUsername,
                                 Set<String> parentGroupNames)
                          throws OperationFailedException

Throws:

OperationFailedException

syncGroupMembershipsAndMembersForGroup

void syncGroupMembershipsAndMembersForGroup(String groupName,
                                            Set<String> parentGroupNames,
                                            Set<String> childGroupNames)
                                     throws OperationFailedException

Throws:

OperationFailedException

getAllUserGuids

Set<String> getAllUserGuids()
                     throws OperationFailedException

Returns a set of all user guids present in the cache excluding null values.

Returns:

set of all guids present in the cache

Throws:

OperationFailedException - if the internal directory throes a OperationFailedException

getUserCount

long getUserCount()
           throws OperationFailedException

Counts users in directory cache.

Returns:

user count

Throws:

OperationFailedException

findUserWithAttributesByName

UserWithAttributes findUserWithAttributesByName(String name)
                                         throws UserNotFoundException,
                                                OperationFailedException

Throws:

UserNotFoundException

OperationFailedException

findGroupWithAttributesByName

GroupWithAttributes findGroupWithAttributesByName(String name)
                                           throws GroupNotFoundException,
                                                  OperationFailedException

Throws:

GroupNotFoundException

OperationFailedException

applySyncingUserAttributes

void applySyncingUserAttributes(String userName,
                                Set<String> deletedAttributes,
                                Map<String,Set<String>> storedAttributes)
                         throws UserNotFoundException,
                                OperationFailedException

Removes any syncing user attributes listed in deletedAttributes, and store any that are listed in storedAttributes If any non-syncing attributes are included, they will be ignored

Parameters:

userName - user to apply attributes to

deletedAttributes - attribute keys that need to be deleted

storedAttributes - attributes and values that need to be saved (will overwrite any existing attributes with the same keys)

Throws:

UserNotFoundException

OperationFailedException

applySyncingGroupAttributes

void applySyncingGroupAttributes(String groupName,
                                 Set<String> deletedAttributes,
                                 Map<String,Set<String>> storedAttributes)
                          throws GroupNotFoundException,
                                 OperationFailedException

Removes any syncing group attributes listed in deletedAttributes, and store any that are listed in storedAttributes If any non-syncing attributes are included, they will be ignored

Parameters:

groupName - group to apply attributes to

deletedAttributes - attribute keys that need to be deleted

storedAttributes - attributes and values that need to be saved (will overwrite any existing attributes with the same keys)

Throws:

GroupNotFoundException

OperationFailedException