LabelsApi.java

package org.gitlab4j.api;

import java.util.List;

import javax.ws.rs.core.GenericType;
import javax.ws.rs.core.Response;

import org.gitlab4j.api.models.Label;

public class LabelsApi extends AbstractApi {

    public LabelsApi(GitLabApi gitLabApi) {
        super(gitLabApi);
    }

    /**
     * Get all labels of the specified project. Only returns the first page
     *
     * @param projectId the project ID to get the labels for
     * @return a list of project's labels
     * @throws GitLabApiException if any exception occurs
     */
    public List<Label> getLabels(Integer projectId) throws GitLabApiException {
        return (getLabels(projectId, 1, getDefaultPerPage()));
    }

    /**
     * Get all labels of the specified project to using the specified page and per page setting
     *
     * @param projectId the project ID to get the labels for
     * @param page      the page to get
     * @param perPage   the number of issues per page
     * @return a list of project's labels in the specified range
     * @throws GitLabApiException if any exception occurs
     */
    public List<Label> getLabels(Integer projectId, int page, int perPage) throws GitLabApiException {

        if (projectId == null) {
            throw new RuntimeException("projectId cannot be null");
        }

        Response response = get(javax.ws.rs.core.Response.Status.OK, getPageQueryParams(page, perPage), "projects", projectId, "labels");
        return (response.readEntity(new GenericType<List<Label>>() {}));
    }

    /**
     * Create a label
     *
     * @param projectId   the project ID to create a label for
     * @param name        the name for the label
     * @param color       the color for the label
     * @param description the description for the label
     * @return the created Label instance
     * @throws GitLabApiException if any exception occurs
     */
    public Label createLabel(Integer projectId, String name, String color, String description) throws GitLabApiException {
        return (createLabel(projectId, name, color, description, null));
    }

    /**
     * Create a label
     *
     * @param projectId the project ID to create a label for
     * @param name      the name for the label
     * @param color     the color for the label
     * @return the created Label instance
     * @throws GitLabApiException if any exception occurs
     */
    public Label createLabel(Integer projectId, String name, String color) throws GitLabApiException {
        return (createLabel(projectId, name, color, null, null));