ServicesApi.java

package org.gitlab4j.api;

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

import org.gitlab4j.api.GitLabApi.ApiVersion;
import org.gitlab4j.api.models.Project;

/**
 * Access for the services API.
 * See
 * <a href="https://github.com/gitlabhq/gitlabhq/blob/master/doc/api/services.md">GitLab documentation</a>.
 * It is quite restricted as you may not retrieve the API but only set or delete.
 */
public class ServicesApi extends AbstractApi {

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

    /**
     * Activates the gitlab-ci service.
     *
     * PUT /projects/:id/services/gitlab-ci
     * @param projectId id of the project
     * @param token for authentication
     * @param projectCIUrl URL of the GitLab-CI project
     * @throws GitLabApiException if any exception occurs
     */
    public void setGitLabCI(Integer projectId, String token, String projectCIUrl) throws GitLabApiException {
        final Form formData = new Form();
        formData.param("token", token);
        formData.param("project_url", projectCIUrl);
        put(Response.Status.OK, formData.asMap(), "projects", projectId, "services", "gitlab-ci");
    }

    /**
     * Activates the gitlab-ci service.
     *
     * PUT /projects/:id/services/gitlab-ci
     * @param project the project
     * @param token for authentication
     * @param projectCIUrl URL of the GitLab-CI project
     * @throws GitLabApiException if any exception occurs
     */
    public void setGitLabCI(Project project, String token, String projectCIUrl) throws GitLabApiException {
        setGitLabCI(project.getId(), token, projectCIUrl);
    }

    /**
     * Deletes the gitlab-ci service.
     *
     * DELETE /projects/:id/services/gitlab-ci
     *
     * @param projectId id of the project
     * @throws GitLabApiException if any exception occurs
     */
    public void deleteGitLabCI(Integer projectId) throws GitLabApiException {
        Response.Status expectedStatus = (isApiVersion(ApiVersion.V3) ? Response.Status.OK : Response.Status.NO_CONTENT);
        delete(expectedStatus, null, "projects", projectId, "services", "gitlab-ci");
    }

    /**
     * DELETE /projects/:id/services/gitlab-ci
     * @param project to delete
     * @throws GitLabApiException if any exception occurs
     */
    public void deleteGitLabCI(Project project) throws GitLabApiException {
        deleteGitLabCI(project.getId());
    }