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

Class RoleResource

java.lang.Object

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

public class RoleResource
extends Object

Since:

6.4

Constructor Summary

Constructors

Constructor and Description
RoleResource(ProjectRoleService projectRoleService, ProjectRoleBeanFactory projectRoleBeanFactory, ResponseFactory responses, I18nHelper i18n, JiraAuthenticationContext authContext, GlobalPermissionManager permissionManager)

Method Summary

Modifier and Type	Method and Description
javax.ws.rs.core.Response	addProjectRoleActorsToRole(long roleId, ActorInputBean actorsInput) Adds default actors to the given role.
javax.ws.rs.core.Response	createProjectRole(CreateUpdateRoleRequestBean inputBean) Creates a new ProjectRole to be available in Jira.
javax.ws.rs.core.Response	deleteProjectRole(long roleId, Long roleIdToSwap) Deletes a role.
javax.ws.rs.core.Response	deleteProjectRoleActorsFromRole(long roleId, String user, String group) Removes default actor from the given role.
javax.ws.rs.core.Response	fullyUpdateProjectRole(long roleId, CreateUpdateRoleRequestBean updateProjectRoleBean) Fully updates a roles.
javax.ws.rs.core.Response	getProjectRoleActorsForRole(long roleId) Gets default actors for the given role.
javax.ws.rs.core.Response	getProjectRoles() Get all the ProjectRoles available in Jira.
javax.ws.rs.core.Response	getProjectRolesById(long roleId) Get a specific ProjectRole available in Jira.
javax.ws.rs.core.Response	partialUpdateProjectRole(long roleId, CreateUpdateRoleRequestBean updateProjectRoleBean) Partially updates a roles name or description.

Methods inherited from class java.lang.Object

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

Constructor Detail

RoleResource

public RoleResource(ProjectRoleService projectRoleService,
                    ProjectRoleBeanFactory projectRoleBeanFactory,
                    ResponseFactory responses,
                    I18nHelper i18n,
                    JiraAuthenticationContext authContext,
                    GlobalPermissionManager permissionManager)

Method Detail

getProjectRoles

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

Get all the ProjectRoles available in Jira. Currently this list is global.

Returns:

Returns full details of the roles available in Jira.

getProjectRolesById

public javax.ws.rs.core.Response getProjectRolesById(long roleId)

Get a specific ProjectRole available in Jira.

Returns:

Returns full details of the role available in Jira.

createProjectRole

public javax.ws.rs.core.Response createProjectRole(CreateUpdateRoleRequestBean inputBean)

Creates a new ProjectRole to be available in Jira. The created role does not have any default actors assigned.

Returns:

Returns full details of the created role

partialUpdateProjectRole

public javax.ws.rs.core.Response partialUpdateProjectRole(long roleId,
                                                          CreateUpdateRoleRequestBean updateProjectRoleBean)

Partially updates a roles name or description.

Returns:

Returns updated role.

fullyUpdateProjectRole

public javax.ws.rs.core.Response fullyUpdateProjectRole(long roleId,
                                                        CreateUpdateRoleRequestBean updateProjectRoleBean)

Fully updates a roles. Both name and description must be given.

Returns:

Returns updated role.

deleteProjectRole

public javax.ws.rs.core.Response deleteProjectRole(long roleId,
                                                   Long roleIdToSwap)

Deletes a role. May return 403 in the future

Parameters:

roleIdToSwap - if given, removes a role even if it is used in scheme by replacing the role with the given one

getProjectRoleActorsForRole

public javax.ws.rs.core.Response getProjectRoleActorsForRole(long roleId)

Gets default actors for the given role.

Returns:

Returns actor list.

addProjectRoleActorsToRole

public javax.ws.rs.core.Response addProjectRoleActorsToRole(long roleId,
                                                            ActorInputBean actorsInput)

Adds default actors to the given role. The request data should contain a list of usernames or a list of groups to add.

Returns:

Returns actor list.

deleteProjectRoleActorsFromRole

public javax.ws.rs.core.Response deleteProjectRoleActorsFromRole(long roleId,
                                                                 String user,
                                                                 String group)

Removes default actor from the given role.

Parameters:

roleId - the role id to remove the actors from

user - if given, removes an actor from given role

group - if given, removes an actor from given role

Returns:

Returns updated actors list.