jetbrains.buildServer.groups
Interface UserGroup

All Known Subinterfaces:
SUserGroup

public interface UserGroup

Represents a user group. A user group is an entity that associates a set of users with some permissions (roles), notification rules, etc.

Groups can include other groups (subgroups), inheriting the roles and notification rules of subgroups.

A group is not associated with a particular project, but can have permissions associated with the project.

Since:
4.5
Author:
Maxim Podkolzine (maxim.podkolzine@jetbrains.com)

Method Summary
 java.util.List<UserGroup> getAllSubgroups()
          Returns the set of all subgroups included into this group, directly or through intermediate ones.
 java.util.List<User> getAllUsers()
          Returns the set of all users included into this group, directly or through subgroups.
 java.lang.String getDescription()
          Returns a description of this group.
 java.util.List<UserGroup> getDirectSubgroups()
          Returns the collection of subgroups that are directly included into this group.
 java.util.List<User> getDirectUsers()
          Returns the collection of users included into this group.
 java.lang.String getKey()
          Returns a group key.
 java.lang.String getName()
          Returns a displayable name of this group.
 java.util.List<UserGroup> getParentGroups()
          Returns the list of parent groups, i.e.
 

Method Detail

getKey

@NotNull
java.lang.String getKey()
Returns a group key. The key is fixed, unique among all groups.

Returns:
group key

getName

@NotNull
java.lang.String getName()
Returns a displayable name of this group. The name is unique among all groups, but in contrast with group key is modifiable.

Returns:
group name

getDescription

@NotNull
java.lang.String getDescription()
Returns a description of this group.

Returns:
group description

getDirectSubgroups

@NotNull
java.util.List<UserGroup> getDirectSubgroups()
Returns the collection of subgroups that are directly included into this group.

Returns:
list of direct subgroups
See Also:
getAllSubgroups(), getParentGroups()

getAllSubgroups

@NotNull
java.util.List<UserGroup> getAllSubgroups()
Returns the set of all subgroups included into this group, directly or through intermediate ones.

Returns:
list of all subgroups
See Also:
getDirectSubgroups()

getParentGroups

@NotNull
java.util.List<UserGroup> getParentGroups()
Returns the list of parent groups, i.e. groups that contain this groups as a subgroup.

Returns:
list of parents
See Also:
getDirectSubgroups()

getDirectUsers

@NotNull
java.util.List<User> getDirectUsers()
Returns the collection of users included into this group. This method ignores the subgroups.

Returns:
list of users
See Also:
getAllUsers()

getAllUsers

@NotNull
java.util.List<User> getAllUsers()
Returns the set of all users included into this group, directly or through subgroups.

Returns:
list of all users
See Also:
getDirectUsers()