com.atlassian.jira.rest.v2.issue.project

Class ProjectRoleResource

java.lang.Object

com.atlassian.jira.rest.v2.issue.project.ProjectRoleResource

public class ProjectRoleResource
extends Object

Since:

v4.4

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ProjectRoleResource.ActorsMap

Field Summary

Fields

Modifier and Type	Field and Description
static Map<String,String>	GET_ROLES_DOC_EXAMPLE

Constructor Summary

Constructors

Constructor and Description
ProjectRoleResource(ProjectRoleService projectRoleService, AvatarService avatarService, ProjectFinder projectFinder, JiraAuthenticationContext authContext, javax.ws.rs.core.UriInfo uriInfo, UserManager userManager, ProjectRoleBeanFactory projectRoleBeanFactory, GroupManager groupManager)

Method Summary

Modifier and Type	Method and Description
javax.ws.rs.core.Response	addActorUsers(String projectIdOrKey, Long id, ProjectRoleResource.ActorsMap actors) Adds an actor (user or group) to a project role.
javax.ws.rs.core.Response	deleteActor(String projectIdOrKey, Long id, String username, String groupname) Deletes actors (users or groups) from a project role.
javax.ws.rs.core.Response	getProjectRole(String projectIdOrKey, Long id) Returns the details for a given project role in a project.
javax.ws.rs.core.Response	getProjectRoles(String projectIdOrKey) Returns all roles in the given project Id or key, with links to full details on each role.
javax.ws.rs.core.Response	setActors(String projectIdOrKey, Long id, ProjectRoleActorsUpdateBean actors) Updates a project role to include the specified actors (users or groups).

Methods inherited from class java.lang.Object

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

Field Detail

GET_ROLES_DOC_EXAMPLE

public static Map<String,String> GET_ROLES_DOC_EXAMPLE

Constructor Detail

ProjectRoleResource

public ProjectRoleResource(ProjectRoleService projectRoleService,
                           AvatarService avatarService,
                           ProjectFinder projectFinder,
                           JiraAuthenticationContext authContext,
                           javax.ws.rs.core.UriInfo uriInfo,
                           UserManager userManager,
                           ProjectRoleBeanFactory projectRoleBeanFactory,
                           GroupManager groupManager)

Method Detail

getProjectRoles

public javax.ws.rs.core.Response getProjectRoles(String projectIdOrKey)

Returns all roles in the given project Id or key, with links to full details on each role.

Parameters:

projectIdOrKey - the project id or project key

Returns:

list of roles and URIs to full details

getProjectRole

public javax.ws.rs.core.Response getProjectRole(String projectIdOrKey,
                                                Long id)

Returns the details for a given project role in a project.

Parameters:

projectIdOrKey - the project id or project key

id - the project role id

Returns:

full details on the role and its actors. Actors are sorted by their display name.

setActors

public javax.ws.rs.core.Response setActors(String projectIdOrKey,
                                           Long id,
                                           ProjectRoleActorsUpdateBean actors)

Updates a project role to include the specified actors (users or groups). Can be also used to clear roles to not include any users or groups.

For user actors, their usernames should be used.

Parameters:

projectIdOrKey - the project id or project key

id - the project role id

actors - the actors to set for the role

Returns:

full details on the role and its actors after modification

addActorUsers

public javax.ws.rs.core.Response addActorUsers(String projectIdOrKey,
                                               Long id,
                                               ProjectRoleResource.ActorsMap actors)

Adds an actor (user or group) to a project role.

For user actors, their usernames should be used.

Parameters:

projectIdOrKey - the project id or project key

id - the project role id

actors - the actors to add to the role

Returns:

full details on the role and its actors after modification

deleteActor

public javax.ws.rs.core.Response deleteActor(String projectIdOrKey,
                                             Long id,
                                             String username,
                                             String groupname)

Deletes actors (users or groups) from a project role.

• Delete a user from the role: /rest/api/2/project/{projectIdOrKey}/role/{roleId}?user={username}
• Delete a group from the role: /rest/api/2/project/{projectIdOrKey}/role/{roleId}?group={groupname}

Parameters:

projectIdOrKey - the project id or project key

id - the project role id

username - the username of the user to remove from the project role

groupname - the groupname to remove from the project role

Returns:

no content on success