Package jetbrains.buildServer.groups.impl

Class SecuredUserGroupManager

java.lang.Object

jetbrains.buildServer.groups.impl.SecuredUserGroupManager

All Implemented Interfaces:

UserGroupManager

public class SecuredUserGroupManager
extends Object
implements UserGroupManager

Author:

Maxim Podkolzine (maxim.podkolzine@jetbrains.com)

Field Summary

Fields inherited from interface jetbrains.buildServer.groups.UserGroupManager

MAX_GROUP_KEY_LENGTH

Constructor Summary

Constructors

Constructor	Description
SecuredUserGroupManager(UserGroupManager delegate, SecurityContextEx securityContext)

Method Summary

Modifier and Type	Method	Description
void	addUserGroupListener(UserGroupListener listener)	Adds the specified listener to the manager's list.
SUserGroup	createUserGroup(String key, String name, String description)	Creates a new user group.
void	deleteUserGroup(SUserGroup group)	Deletes a user group.
SUserGroup	findUserGroupByKey(String key)	Given a group key method finds the corresponding user group.
SUserGroup	findUserGroupByName(String name)	Given a group name method finds the corresponding user group.
Set<SUserGroup>	findUserGroupsByPropertyValue(PropertyKey propertyKey, String propertyValue, boolean caseSensitive)	Returns set of the user groups having specified property.
List<UserGroup>	getAllHostGroupsOf(User user)	Returns topologically ordered list of all groups containing specified user, directly or through intermediate subgroups.
SUserGroup	getAllUsersGroup()	Returns the all-users group.
List<UserGroup>	getHostGroupsOf(User user)	Returns the list of groups that host specified user (directly).
Collection<SUserGroup>	getRootUserGroups()	Returns the collection of root user groups, i.e.
Collection<SUserGroup>	getUserGroups()	Returns the collection of all user groups.
boolean	isAllUsersGroup(SUserGroup group)	Returns true, if the specified group is the all-users group.
void	removeUserGroupListener(UserGroupListener listener)	Removes the listener from the manager's list.
void	renameUserGroup(String key, String name)	Renames a user group.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SecuredUserGroupManager

public SecuredUserGroupManager(@NotNull
                               UserGroupManager delegate,
                               @NotNull
                               SecurityContextEx securityContext)

Method Detail

createUserGroup

@NotNull
public SUserGroup createUserGroup(@NotNull
                                  String key,
                                  @NotNull
                                  String name,
                                  @NotNull
                                  String description)
                           throws UserGroupException

Description copied from interface: UserGroupManager

Creates a new user group.

The key is specified by user, but must be unique among all user groups. An attempt to create a user group with existing key results in exception.

The name must be unique too. Similarly, in case of duplication an exception is thrown.

Specified by:

createUserGroup in interface UserGroupManager

Parameters:

key - user group key

name - user group name

description - user group description

Returns:

a newly created user group

Throws:

UserGroupException - if specified key already exists

deleteUserGroup

public void deleteUserGroup(@NotNull
                            SUserGroup group)

Description copied from interface: UserGroupManager

Deletes a user group.

Note: the group would be deleted from all parent groups automatically, and all subgroups will be reattached to the group's parents. group's direct users aren't moved anywhere.

Specified by:

deleteUserGroup in interface UserGroupManager

Parameters:

group - a group to delete

renameUserGroup

public void renameUserGroup(@NotNull
                            String key,
                            @NotNull
                            String name)
                     throws UserGroupException

Description copied from interface: UserGroupManager

Renames a user group.

Specified by:

renameUserGroup in interface UserGroupManager

Parameters:

key - the group key

name - new group name

Throws:

UserGroupException - if the group is not found, or cannot be renamed

See Also:

SUserGroup.setName(String)

getUserGroups

@NotNull
public Collection<SUserGroup> getUserGroups()

Description copied from interface: UserGroupManager

Returns the collection of all user groups.

Specified by:

getUserGroups in interface UserGroupManager

Returns:

collection of user groups

See Also:

UserGroupManager.getRootUserGroups()

getRootUserGroups

@NotNull
public Collection<SUserGroup> getRootUserGroups()

Description copied from interface: UserGroupManager

Returns the collection of root user groups, i.e. the ones that are not included in any other group.

Specified by:

getRootUserGroups in interface UserGroupManager

Returns:

collection of root user groups

See Also:

UserGroupManager.getUserGroups()

getHostGroupsOf

@NotNull
public List<UserGroup> getHostGroupsOf(@NotNull
                                       User user)

Description copied from interface: UserGroupManager

Returns the list of groups that host specified user (directly).

Specified by:

getHostGroupsOf in interface UserGroupManager

Parameters:

user - the user

Returns:

list of host groups

getAllHostGroupsOf

@NotNull
public List<UserGroup> getAllHostGroupsOf(@NotNull
                                          User user)

Description copied from interface: UserGroupManager

Returns topologically ordered list of all groups containing specified user, directly or through intermediate subgroups.

Specified by:

getAllHostGroupsOf in interface UserGroupManager

Parameters:

user - the user

Returns:

list of all groups containing the user

findUserGroupByKey

public SUserGroup findUserGroupByKey(@NotNull
                                     String key)

Description copied from interface: UserGroupManager

Given a group key method finds the corresponding user group.

Specified by:

findUserGroupByKey in interface UserGroupManager

Parameters:

key - the user group key

Returns:

user group, or null

findUserGroupByName

public SUserGroup findUserGroupByName(@NotNull
                                      String name)

Description copied from interface: UserGroupManager

Given a group name method finds the corresponding user group.

Specified by:

findUserGroupByName in interface UserGroupManager

Parameters:

name - the user group name

Returns:

user group, or null

findUserGroupsByPropertyValue

@NotNull
public Set<SUserGroup> findUserGroupsByPropertyValue(@NotNull
                                                     PropertyKey propertyKey,
                                                     @Nullable
                                                     String propertyValue,
                                                     boolean caseSensitive)

Description copied from interface: UserGroupManager

Returns set of the user groups having specified property.

Specified by:

findUserGroupsByPropertyValue in interface UserGroupManager

Parameters:

propertyKey - property key

propertyValue - property value

caseSensitive - whether to perform case sensitive search

Returns:

see above

addUserGroupListener

public void addUserGroupListener(@NotNull
                                 UserGroupListener listener)

Description copied from interface: UserGroupManager

Adds the specified listener to the manager's list.

Specified by:

addUserGroupListener in interface UserGroupManager

Parameters:

listener - the listener to add

removeUserGroupListener

public void removeUserGroupListener(@NotNull
                                    UserGroupListener listener)

Description copied from interface: UserGroupManager

Removes the listener from the manager's list.

Specified by:

removeUserGroupListener in interface UserGroupManager

Parameters:

listener - the listener to remove

getAllUsersGroup

@NotNull
public SUserGroup getAllUsersGroup()

Description copied from interface: UserGroupManager

Returns the all-users group.

Specified by:

getAllUsersGroup in interface UserGroupManager

Returns:

the all-users group

isAllUsersGroup

public boolean isAllUsersGroup(@NotNull
                               SUserGroup group)

Description copied from interface: UserGroupManager

Returns true, if the specified group is the all-users group.

Specified by:

isAllUsersGroup in interface UserGroupManager

Parameters:

group - the group to check

Returns:

true if the specified group is the all-users group, false otherwise