Package org.gitlab4j.api

Class LabelsApi

java.lang.Object

org.gitlab4j.api.AbstractApi

org.gitlab4j.api.LabelsApi

All Implemented Interfaces:

Constants

public class LabelsApi
extends AbstractApi

Nested Class Summary

Nested classes/interfaces inherited from interface org.gitlab4j.api.Constants

Constants.ActionType, Constants.GroupOrderBy, Constants.ImpersonationState, Constants.IssueScope, Constants.IssueState, Constants.JobScope, Constants.LineType, Constants.MergeRequestState, Constants.MilestoneState, Constants.PipelineOrderBy, Constants.PipelineScope, Constants.ProjectOrderBy, Constants.SortOrder, Constants.StateEvent, Constants.TargetType, Constants.TokenType

Field Summary

Fields inherited from interface org.gitlab4j.api.Constants

NEXT_PAGE_HEADER, PAGE_HEADER, PAGE_PARAM, PER_PAGE, PER_PAGE_PARAM, PREV_PAGE_HEADER, TOTAL_HEADER, TOTAL_PAGES_HEADER

Constructor Summary

Constructors

Constructor	Description
LabelsApi(GitLabApi gitLabApi)

Method Summary

Modifier and Type	Method	Description
Label	createLabel(Integer projectId, String name, String color)	Create a label
Label	createLabel(Integer projectId, String name, String color, Integer priority)	Create a label
Label	createLabel(Integer projectId, String name, String color, String description)	Create a label
Label	createLabel(Integer projectId, String name, String color, String description, Integer priority)	Create a label
void	deleteLabel(Integer projectId, String name)	Delete the specified label
List<Label>	getLabels(Integer projectId)	Get all labels of the specified project.
List<Label>	getLabels(Integer projectId, int page, int perPage)	Get all labels of the specified project to using the specified page and per page setting
Label	subscribeLabel(Integer projectId, Integer labelId)	Subscribe a specified label
Label	unsubscribeLabel(Integer projectId, Integer labelId)	Unsubscribe a specified label
Label	updateLabel(Integer projectId, String name, String newName, String color, String description, Integer priority)	Update the specified label
Label	updateLabelColor(Integer projectId, String name, String color, String description, Integer priority)	Update the specified label
Label	updateLabelName(Integer projectId, String name, String newName, String description, Integer priority)	Update the specified label

Methods inherited from class org.gitlab4j.api.AbstractApi

addFormParam, addFormParam, delete, delete, get, get, getApiClient, getApiVersion, getDefaultPerPage, getDefaultPerPageParam, getPageQueryParams, getWithAccepts, handle, isApiVersion, post, post, post, post, put, put, putWithFormData, urlEncode, validate

Methods inherited from class java.lang.Object

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

Constructor Detail

LabelsApi

public LabelsApi(GitLabApi gitLabApi)

Method Detail

getLabels

public List<Label> getLabels(Integer projectId)
                      throws GitLabApiException

Get all labels of the specified project. Only returns the first page

Parameters:

projectId - the project ID to get the labels for

Returns:

a list of project's labels

Throws:

GitLabApiException - if any exception occurs

getLabels

public List<Label> getLabels(Integer projectId,
                             int page,
                             int perPage)
                      throws GitLabApiException

Get all labels of the specified project to using the specified page and per page setting

Parameters:

projectId - the project ID to get the labels for

page - the page to get

perPage - the number of issues per page

Returns:

a list of project's labels in the specified range

Throws:

GitLabApiException - if any exception occurs

createLabel

public Label createLabel(Integer projectId,
                         String name,
                         String color,
                         String description)
                  throws GitLabApiException

Create a label

Parameters:

projectId - the project ID to create a label for

name - the name for the label

color - the color for the label

description - the description for the label

Returns:

the created Label instance

Throws:

GitLabApiException - if any exception occurs

createLabel

public Label createLabel(Integer projectId,
                         String name,
                         String color)
                  throws GitLabApiException

Create a label

Parameters:

projectId - the project ID to create a label for

name - the name for the label

color - the color for the label

Returns:

the created Label instance

Throws:

GitLabApiException - if any exception occurs

createLabel

public Label createLabel(Integer projectId,
                         String name,
                         String color,
                         Integer priority)
                  throws GitLabApiException

Create a label

Parameters:

projectId - the project ID to create a label for

name - the name for the label

color - the color for the label

priority - the priority for the label

Returns:

the created Label instance

Throws:

GitLabApiException - if any exception occurs

createLabel

public Label createLabel(Integer projectId,
                         String name,
                         String color,
                         String description,
                         Integer priority)
                  throws GitLabApiException

Create a label

Parameters:

projectId - the project ID to create a label for

name - the name for the label

color - the color for the label

description - the description for the label

priority - the priority for the label

Returns:

the created Label instance

Throws:

GitLabApiException - if any exception occurs

updateLabelName

public Label updateLabelName(Integer projectId,
                             String name,
                             String newName,
                             String description,
                             Integer priority)
                      throws GitLabApiException

Update the specified label

Parameters:

projectId - the project ID to update a label for

name - the name for the label

newName - the new name for the label

description - the description for the label

priority - the priority for the label

Returns:

the modified Label instance

Throws:

GitLabApiException - if any exception occurs

updateLabelColor

public Label updateLabelColor(Integer projectId,
                              String name,
                              String color,
                              String description,
                              Integer priority)
                       throws GitLabApiException

Update the specified label

Parameters:

projectId - the project ID to update a label for

name - the name for the label

color - the color for the label

description - the description for the label

priority - the priority for the label

Returns:

the modified Label instance

Throws:

GitLabApiException - if any exception occurs

updateLabel

public Label updateLabel(Integer projectId,
                         String name,
                         String newName,
                         String color,
                         String description,
                         Integer priority)
                  throws GitLabApiException

Update the specified label

Parameters:

projectId - the project ID to update a label for

name - the name for the label

newName - the new name for the label

color - the color for the label

description - the description for the label

priority - the priority for the label

Returns:

the modified Label instance

Throws:

GitLabApiException - if any exception occurs

deleteLabel

public void deleteLabel(Integer projectId,
                        String name)
                 throws GitLabApiException

Delete the specified label

Parameters:

projectId - the project ID to delete a label for

name - the name for the label

Throws:

GitLabApiException - if any exception occurs

subscribeLabel

public Label subscribeLabel(Integer projectId,
                            Integer labelId)
                     throws GitLabApiException

Subscribe a specified label

Parameters:

projectId - the project ID to subscribe a label for

labelId - the lable ID

Returns:

HttpStatusCode 503

Throws:

GitLabApiException - if any exception occurs

unsubscribeLabel

public Label unsubscribeLabel(Integer projectId,
                              Integer labelId)
                       throws GitLabApiException

Unsubscribe a specified label

Parameters:

projectId - the project ID to unsubscribe a label for

labelId - the lable ID

Returns:

HttpStatusCode 503

Throws:

GitLabApiException - if any exception occurs