All Downloads are FREE. Search and download functionalities are using the official Maven repository.

org.gitlab4j.api.MergeRequestApi Maven / Gradle / Ivy

Go to download

GitLab4J-API (gitlab4j-api) provides a full featured Java client library for working with GitLab repositories and servers via the GitLab REST API.

There is a newer version: 6.0.0-rc.6
Show newest version
package org.gitlab4j.api;

import java.util.List;
import java.util.Optional;
import java.util.stream.Stream;

import jakarta.ws.rs.core.Form;
import jakarta.ws.rs.core.GenericType;
import jakarta.ws.rs.core.MultivaluedMap;
import jakarta.ws.rs.core.Response;

import org.gitlab4j.api.GitLabApi.ApiVersion;
import org.gitlab4j.api.models.AcceptMergeRequestParams;
import org.gitlab4j.api.models.ApprovalRule;
import org.gitlab4j.api.models.ApprovalRuleParams;
import org.gitlab4j.api.models.ApprovalState;
import org.gitlab4j.api.models.Commit;
import org.gitlab4j.api.models.Diff;
import org.gitlab4j.api.models.Issue;
import org.gitlab4j.api.models.MergeRequest;
import org.gitlab4j.api.models.MergeRequestDiff;
import org.gitlab4j.api.models.MergeRequestFilter;
import org.gitlab4j.api.models.MergeRequestParams;
import org.gitlab4j.api.models.MergeRequestVersion;
import org.gitlab4j.api.models.Participant;
import org.gitlab4j.api.models.Pipeline;

/**
 * This class implements the client side API for the GitLab merge request calls.
 * @see Merge requests API at GitLab
 * @see Merge request approvals API at GitLab
 */
public class MergeRequestApi extends AbstractApi {

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

    /**
     * Get all merge requests matching the filter.
     *
     * 
GitLab Endpoint: GET /merge_requests
* * @param filter a MergeRequestFilter instance with the filter settings * @return all merge requests for the specified project matching the filter * @throws GitLabApiException if any exception occursput */ public List getMergeRequests(MergeRequestFilter filter) throws GitLabApiException { return (getMergeRequests(filter, getDefaultPerPage()).all()); } /** * Get all merge requests matching the filter. * *
GitLab Endpoint: GET /merge_requests
* * @param filter a MergeRequestFilter instance with the filter settings * @param page the page to get * @param perPage the number of MergeRequest instances per page * @return all merge requests for the specified project matching the filter * @throws GitLabApiException if any exception occurs */ public List getMergeRequests(MergeRequestFilter filter, int page, int perPage) throws GitLabApiException { MultivaluedMap queryParams = (filter != null ? filter.getQueryParams(page, perPage).asMap() : getPageQueryParams(page, perPage)); Response response; if (filter != null && (filter.getProjectId() != null && filter.getProjectId().intValue() > 0) || (filter.getIids() != null && filter.getIids().size() > 0)) { if (filter.getProjectId() == null || filter.getProjectId().intValue() == 0) { throw new RuntimeException("project ID cannot be null or 0"); } response = get(Response.Status.OK, queryParams, "projects", filter.getProjectId(), "merge_requests"); } else { response = get(Response.Status.OK, queryParams, "merge_requests"); } return (response.readEntity(new GenericType>() {})); } /** * Get all merge requests matching the filter. * *
GitLab Endpoint: GET /merge_requests
* * @param filter a MergeRequestFilter instance with the filter settings * @param itemsPerPage the number of MergeRequest instances that will be fetched per page * @return all merge requests for the specified project/group matching the filter * @throws GitLabApiException if any exception occurs */ public Pager getMergeRequests(MergeRequestFilter filter, int itemsPerPage) throws GitLabApiException { MultivaluedMap queryParams = (filter != null ? filter.getQueryParams().asMap() : null); if (filter != null && ((filter.getProjectId() != null && filter.getProjectId().intValue() > 0) || (filter.getIids() != null && filter.getIids().size() > 0))) { if (filter.getProjectId() == null || filter.getProjectId().intValue() == 0) { throw new RuntimeException("project ID cannot be null or 0"); } return (new Pager(this, MergeRequest.class, itemsPerPage, queryParams, "projects", filter.getProjectId(), "merge_requests")); } else if (filter != null && filter.getGroupId() != null && filter.getGroupId().intValue() > 0) { return (new Pager(this, MergeRequest.class, itemsPerPage, queryParams, "groups", filter.getGroupId(), "merge_requests")); } else { return (new Pager(this, MergeRequest.class, itemsPerPage, queryParams, "merge_requests")); } } /** * Get all merge requests matching the filter as a Stream. * *
GitLab Endpoint: GET /merge_requests
* * @param filter a MergeRequestFilter instance with the filter settings * @return a Stream containing all the merge requests for the specified project matching the filter * @throws GitLabApiException if any exception occurs */ public Stream getMergeRequestsStream(MergeRequestFilter filter) throws GitLabApiException { return (getMergeRequests(filter, getDefaultPerPage()).stream()); } /** * Get all merge requests for the specified project. * *
GitLab Endpoint: GET /projects/:id/merge_requests
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @return all merge requests for the specified project * @throws GitLabApiException if any exception occurs */ public List getMergeRequests(Object projectIdOrPath) throws GitLabApiException { return (getMergeRequests(projectIdOrPath, getDefaultPerPage()).all()); } /** * Get all merge requests for the specified project. * *
GitLab Endpoint: GET /projects/:id/merge_requests
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param page the page to get * @param perPage the number of MergeRequest instances per page * @return all merge requests for the specified project * @throws GitLabApiException if any exception occurs */ public List getMergeRequests(Object projectIdOrPath, int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests"); return (response.readEntity(new GenericType>() {})); } /** * Get all merge requests for the specified project. * *
GitLab Endpoint: GET /projects/:id/merge_requests
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param itemsPerPage the number of MergeRequest instances that will be fetched per page * @return all merge requests for the specified project * @throws GitLabApiException if any exception occurs */ public Pager getMergeRequests(Object projectIdOrPath, int itemsPerPage) throws GitLabApiException { return (new Pager(this, MergeRequest.class, itemsPerPage, null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests")); } /** * Get all merge requests for the specified project as a Stream * *
GitLab Endpoint: GET /projects/:id/merge_requests
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @return a Stream with all merge requests for the specified project * @throws GitLabApiException if any exception occurs */ public Stream getMergeRequestsStream(Object projectIdOrPath) throws GitLabApiException { return (getMergeRequests(projectIdOrPath, getDefaultPerPage()).stream()); } /** * Get all merge requests with a specific state for the specified project. * *
GitLab Endpoint: GET /projects/:id/merge_requests?state=:state
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param state the state parameter can be used to get only merge requests with a given state (opened, closed, or merged) or all of them (all). * @return all merge requests for the specified project * @throws GitLabApiException if any exception occurs */ public List getMergeRequests(Object projectIdOrPath, MergeRequestState state) throws GitLabApiException { return (getMergeRequests(projectIdOrPath, state, getDefaultPerPage()).all()); } /** * Get all merge requests for the specified project. * *
GitLab Endpoint: GET /projects/:id/merge_requests
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param state the state parameter can be used to get only merge requests with a given state (opened, closed, or merged) or all of them (all). * @param page the page to get * @param perPage the number of MergeRequest instances per page * @return all merge requests for the specified project * @throws GitLabApiException if any exception occurs */ public List getMergeRequests(Object projectIdOrPath, MergeRequestState state, int page, int perPage) throws GitLabApiException { Form formData = new GitLabApiForm() .withParam("state", state) .withParam(PAGE_PARAM, page) .withParam(PER_PAGE_PARAM, perPage); Response response = get(Response.Status.OK, formData.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests"); return (response.readEntity(new GenericType>() {})); } /** * Get all merge requests for the specified project. * *
GitLab Endpoint: GET /projects/:id/merge_requests
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param state the state parameter can be used to get only merge requests with a given state (opened, closed, or merged) or all of them (all). * @param itemsPerPage the number of MergeRequest instances that will be fetched per page * @return all merge requests for the specified project * @throws GitLabApiException if any exception occurs */ public Pager getMergeRequests(Object projectIdOrPath, MergeRequestState state, int itemsPerPage) throws GitLabApiException { Form formData = new GitLabApiForm() .withParam("state", state); return (new Pager(this, MergeRequest.class, itemsPerPage, formData.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests")); } /** * Get all merge requests with a specific state for the specified project as a Stream. * *
GitLab Endpoint: GET /projects/:id/merge_requests?state=:state
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param state the state parameter can be used to get only merge requests with a given state (opened, closed, or merged) or all of them (all). * @return a Stream with all the merge requests for the specified project * @throws GitLabApiException if any exception occurs */ public Stream getMergeRequestsStream(Object projectIdOrPath, MergeRequestState state) throws GitLabApiException { return (getMergeRequests(projectIdOrPath, state, getDefaultPerPage()).stream()); } /** * Get information about a single merge request. * *

NOTE: GitLab API V4 uses IID (internal ID), V3 uses ID to identify the merge request.

* *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return the specified MergeRequest instance * @throws GitLabApiException if any exception occurs */ public MergeRequest getMergeRequest(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return getMergeRequest(projectIdOrPath, mergeRequestIid, null, null, null); } /** * Get information about a single merge request. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @param renderHtml if true response includes rendered HTML for title and description, can be null * @param includeDivergedCommitCount if true response includes the commits behind the target branch, can be null * @param includeRebaseInProgress if true response includes whether a rebase operation is in progress, can be null * @return a MergeRequest instance as specified by the parameters * @throws GitLabApiException if any exception occurs */ public MergeRequest getMergeRequest(Object projectIdOrPath, Long mergeRequestIid, Boolean renderHtml, Boolean includeDivergedCommitCount, Boolean includeRebaseInProgress) throws GitLabApiException { GitLabApiForm queryParams = new GitLabApiForm() .withParam("render_html", renderHtml) .withParam("include_diverged_commits_count", includeDivergedCommitCount) .withParam("include_rebase_in_progress", includeRebaseInProgress); Response response = get(Response.Status.OK, queryParams.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid); return (response.readEntity(MergeRequest.class)); } /** * Get information about a single merge request as an Optional instance. * *

NOTE: GitLab API V4 uses IID (internal ID), V3 uses ID to identify the merge request.

* *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return the specified MergeRequest as an Optional instance instance */ public Optional getOptionalMergeRequest(Object projectIdOrPath, Long mergeRequestIid) { return getOptionalMergeRequest(projectIdOrPath, mergeRequestIid, null, null, null); } /** * Get information about a single merge request as an Optional instance. * *

NOTE: GitLab API V4 uses IID (internal ID), V3 uses ID to identify the merge request.

* *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @param renderHtml if true response includes rendered HTML for title and description, can be null * @param includeDivergedCommitCount if true response includes the commits behind the target branch, can be null * @param includeRebaseInProgress if true response includes whether a rebase operation is in progress, can be null * @return the specified MergeRequest as an Optional instance instance */ public Optional getOptionalMergeRequest(Object projectIdOrPath, Long mergeRequestIid, Boolean renderHtml, Boolean includeDivergedCommitCount , Boolean includeRebaseInProgress) { try { return (Optional.ofNullable(getMergeRequest(projectIdOrPath, mergeRequestIid, renderHtml, includeDivergedCommitCount, includeRebaseInProgress))); } catch (GitLabApiException glae) { return (GitLabApi.createOptionalFromException(glae)); } } /** * Get a list of merge request commits. * *

NOTE: GitLab API V4 uses IID (internal ID), V3 uses ID to identify the merge request.

* *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/commits
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return a list containing the commits for the specified merge request * @throws GitLabApiException GitLabApiException if any exception occurs during execution */ public List getCommits(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return (getCommits(projectIdOrPath, mergeRequestIid, getDefaultPerPage()).all()); } /** * Get a list of merge request commits. * *

NOTE: GitLab API V4 uses IID (internal ID), V3 uses ID to identify the merge request.

* *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/commits
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @param page the page to get * @param perPage the number of commits per page * @return a list containing the commits for the specified merge request * @throws GitLabApiException GitLabApiException if any exception occurs during execution */ public List getCommits(Object projectIdOrPath, Long mergeRequestIid, int page, int perPage) throws GitLabApiException { Form formData = new GitLabApiForm().withParam("owned", true).withParam(PAGE_PARAM, page).withParam(PER_PAGE_PARAM, perPage); Response response = get(Response.Status.OK, formData.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "commits"); return (response.readEntity(new GenericType>() {})); } /** * Get a Pager of merge request commits. * *

NOTE: GitLab API V4 uses IID (internal ID), V3 uses ID to identify the merge request.

* *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/commits
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @param itemsPerPage the number of Commit instances that will be fetched per page * @return a Pager containing the commits for the specified merge request * @throws GitLabApiException GitLabApiException if any exception occurs during execution */ public Pager getCommits(Object projectIdOrPath, Long mergeRequestIid, int itemsPerPage) throws GitLabApiException { return (new Pager(this, Commit.class, itemsPerPage, null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "commits")); } /** * Get a Stream of merge request commits. * *

NOTE: GitLab API V4 uses IID (internal ID), V3 uses ID to identify the merge request.

* *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/commits
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return a Stream containing the commits for the specified merge request * @throws GitLabApiException GitLabApiException if any exception occurs during execution */ public Stream getCommitsStream(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return (getCommits(projectIdOrPath, mergeRequestIid, getDefaultPerPage()).stream()); } /** * Get a list of merge request diff versions. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/versions
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return a List of merge request diff versions for the specified merge request * @throws GitLabApiException if any exception occurs */ public List getDiffVersions(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return (getDiffVersions(projectIdOrPath, mergeRequestIid, getDefaultPerPage()).all()); } /** * Get a Pager of merge request diff versions. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/versions
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @param itemsPerPage the number of MergeRequest instances that will be fetched per page * @return a Pager of merge request diff versions for the specified merge request * @throws GitLabApiException if any exception occurs */ public Pager getDiffVersions(Object projectIdOrPath, Long mergeRequestIid, int itemsPerPage) throws GitLabApiException { return (new Pager(this, MergeRequestVersion.class, itemsPerPage, null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "versions")); } /** * Get a Stream of merge request diff versions. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/versions
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return a Stream of merge request diff versions for the specified merge request * @throws GitLabApiException if any exception occurs */ public Stream getDiffVersionsStream(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return (getDiffVersions(projectIdOrPath, mergeRequestIid, getDefaultPerPage()).stream()); } /** * Get a single merge request diff version. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/versions/:version_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @param versionId the ID of the merge request diff version * @return a MergeRequestVersion instance for the specified MR diff version * @throws GitLabApiException if any exception occurs */ public MergeRequestDiff getDiffVersion(Object projectIdOrPath, Long mergeRequestIid, Long versionId) throws GitLabApiException { Response response = get(Response.Status.OK, null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "versions", versionId); return (response.readEntity(MergeRequestDiff.class)); } /** * Get a single merge request diff version as an Optional instance. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/versions/:version_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @param versionId the ID of the merge request diff version * @return the specified MergeRequestVersion as an Optional instance instance */ public Optional getOptionalDiffVersion(Object projectIdOrPath, Long mergeRequestIid, Long versionId) { try { return (Optional.ofNullable(getDiffVersion(projectIdOrPath, mergeRequestIid, versionId))); } catch (GitLabApiException glae) { return (GitLabApi.createOptionalFromException(glae)); } } /** * Get a list of merge request diffs. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/diffs
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return a List of merge request diffs for the specified merge request * @throws GitLabApiException if any exception occurs */ public List getDiffs(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return (getDiffs(projectIdOrPath, mergeRequestIid, getDefaultPerPage()).all()); } /** * Get a Pager of merge request diffs. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/diffs
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @param itemsPerPage the number of Diff instances that will be fetched per page * @return a Pager of merge request diffs for the specified merge request * @throws GitLabApiException if any exception occurs */ public Pager getDiffs(Object projectIdOrPath, Long mergeRequestIid, int itemsPerPage) throws GitLabApiException { return (new Pager<>(this, Diff.class, itemsPerPage, null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "diffs")); } /** * Get a Stream of merge request diffs. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/diffs
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return a Stream of merge request diffs for the specified merge request * @throws GitLabApiException if any exception occurs */ public Stream getDiffsStream(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return (getDiffs(projectIdOrPath, mergeRequestIid, getDefaultPerPage()).stream()); } /** * Creates a merge request. * *
GitLab Endpoint: POST /projects/:id/merge_requests
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param params a MergeRequestParams instance holding the info to create the merge request * @return the created MergeRequest instance * @throws GitLabApiException if any exception occurs * @since GitLab Starter 8.17, GitLab CE 11.0. */ public MergeRequest createMergeRequest(Object projectIdOrPath, MergeRequestParams params) throws GitLabApiException { GitLabApiForm form = params.getForm(true); Response response = post(Response.Status.CREATED, form, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests"); return (response.readEntity(MergeRequest.class)); } /** * Creates a merge request. * *
GitLab Endpoint: POST /projects/:id/merge_requests
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param sourceBranch the source branch, required * @param targetBranch the target branch, required * @param title the title for the merge request, required * @param description the description of the merge request * @param assigneeId the Assignee user ID, optional * @param targetProjectId the ID of a target project, optional * @param labels labels for MR, optional * @param milestoneId the ID of a milestone, optional * @param removeSourceBranch Flag indicating if a merge request should remove the source branch when merging, optional * @param squash Squash commits into a single commit when merging, optional * @return the created MergeRequest instance * @throws GitLabApiException if any exception occurs * @since GitLab Starter 8.17, GitLab CE 11.0. */ public MergeRequest createMergeRequest(Object projectIdOrPath, String sourceBranch, String targetBranch, String title, String description, Long assigneeId, Long targetProjectId, String[] labels, Long milestoneId, Boolean removeSourceBranch, Boolean squash) throws GitLabApiException { MergeRequestParams params = new MergeRequestParams() .withSourceBranch(sourceBranch) .withTargetBranch(targetBranch) .withTitle(title) .withDescription(description) .withAssigneeId(assigneeId) .withTargetProjectId(targetProjectId) .withLabels(labels) .withMilestoneId(milestoneId) .withRemoveSourceBranch(removeSourceBranch) .withSquash(squash); return(createMergeRequest(projectIdOrPath, params)); } /** * Creates a merge request. * *
GitLab Endpoint: POST /projects/:id/merge_requests
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param sourceBranch the source branch, required * @param targetBranch the target branch, required * @param title the title for the merge request, required * @param description the description of the merge request * @param assigneeId the Assignee user ID, optional * @param targetProjectId the ID of a target project, optional * @param labels labels for MR, optional * @param milestoneId the ID of a milestone, optional * @param removeSourceBranch Flag indicating if a merge request should remove the source branch when merging, optional * @return the created MergeRequest instance * @throws GitLabApiException if any exception occurs */ public MergeRequest createMergeRequest(Object projectIdOrPath, String sourceBranch, String targetBranch, String title, String description, Long assigneeId, Long targetProjectId, String[] labels, Long milestoneId, Boolean removeSourceBranch) throws GitLabApiException { MergeRequestParams params = new MergeRequestParams() .withSourceBranch(sourceBranch) .withTargetBranch(targetBranch) .withTitle(title) .withDescription(description) .withAssigneeId(assigneeId) .withTargetProjectId(targetProjectId) .withLabels(labels) .withMilestoneId(milestoneId) .withRemoveSourceBranch(removeSourceBranch); return(createMergeRequest(projectIdOrPath, params)); } /** * Creates a merge request and optionally assigns a reviewer to it. * *
GitLab Endpoint: POST /projects/:id/merge_requests
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param sourceBranch the source branch, required * @param targetBranch the target branch, required * @param title the title for the merge request, required * @param description the description of the merge request * @param assigneeId the Assignee user ID, optional * @return the created MergeRequest instance * @throws GitLabApiException if any exception occurs */ public MergeRequest createMergeRequest(Object projectIdOrPath, String sourceBranch, String targetBranch, String title, String description, Long assigneeId) throws GitLabApiException { MergeRequestParams params = new MergeRequestParams() .withSourceBranch(sourceBranch) .withTargetBranch(targetBranch) .withTitle(title) .withDescription(description) .withAssigneeId(assigneeId); return(createMergeRequest(projectIdOrPath, params)); } /** * Updates an existing merge request. You can change branches, title, or even close the merge request. * *
GitLab Endpoint: PUT /projects/:id/merge_requests/:merge_request_iid
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request to update * @param params a MergeRequestParams instance holding the info to update the merge request * @return the updated merge request * @throws GitLabApiException if any exception occurs */ public MergeRequest updateMergeRequest(Object projectIdOrPath, Long mergeRequestIid, MergeRequestParams params) throws GitLabApiException { GitLabApiForm form = params.getForm(false); Response response = put(Response.Status.OK, form.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid); return (response.readEntity(MergeRequest.class)); } /** * Updates an existing merge request. You can change branches, title, or even close the MR. * *

NOTE: GitLab API V4 uses IID (internal ID), V3 uses ID to identify the merge request.

* *
GitLab Endpoint: PUT /projects/:id/merge_requests/:merge_request_iid
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request to update * @param targetBranch the target branch, optional * @param title the title for the merge request * @param assigneeId the Assignee user ID, optional * @param description the description of the merge request, optional * @param stateEvent new state for the merge request, optional * @param labels comma separated list of labels, optional * @param milestoneId the ID of a milestone, optional * @param removeSourceBranch Flag indicating if a merge request should remove the source * branch when merging, optional * @param squash Squash commits into a single commit when merging, optional * @param discussionLocked Flag indicating if the merge request's discussion is locked, optional * @param allowCollaboration Allow commits from members who can merge to the target branch, * optional * @return the updated merge request * @throws GitLabApiException if any exception occurs */ public MergeRequest updateMergeRequest(Object projectIdOrPath, Long mergeRequestIid, String targetBranch, String title, Long assigneeId, String description, StateEvent stateEvent, String labels, Long milestoneId, Boolean removeSourceBranch, Boolean squash, Boolean discussionLocked, Boolean allowCollaboration) throws GitLabApiException { String[] labelsArray = null; if (labels != null) { labelsArray = labels.split(",", -1); } MergeRequestParams params = new MergeRequestParams() .withTargetBranch(targetBranch) .withTitle(title) .withAssigneeId(assigneeId) .withDescription(description) .withStateEvent(stateEvent) .withLabels(labelsArray) .withMilestoneId(milestoneId) .withRemoveSourceBranch(removeSourceBranch) .withDiscussionLocked(discussionLocked) .withAllowCollaboration(allowCollaboration) .withSquash(squash); return (updateMergeRequest(projectIdOrPath, mergeRequestIid, params)); } /** * Only for admins and project owners. Soft deletes the specified merge. * *

NOTE: GitLab API V4 uses IID (internal ID), V3 uses ID to identify the merge request.

* *
GitLab Endpoint: DELETE /projects/:id/merge_requests/:merge_request_iid
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @throws GitLabApiException if any exception occurs */ public void deleteMergeRequest(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { if (mergeRequestIid == null) { throw new RuntimeException("mergeRequestIid cannot be null"); } Response.Status expectedStatus = (isApiVersion(ApiVersion.V3) ? Response.Status.OK : Response.Status.NO_CONTENT); delete(expectedStatus, null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid); } /** * Merge changes to the merge request. If the MR has any conflicts and can not be merged, * you'll get a 405 and the error message 'Branch cannot be merged'. If merge request is * already merged or closed, you'll get a 406 and the error message 'Method Not Allowed'. * If the sha parameter is passed and does not match the HEAD of the source, you'll get * a 409 and the error message 'SHA does not match HEAD of source branch'. If you don't * have permissions to accept this merge request, you'll get a 401. * *

NOTE: GitLab API V4 uses IID (internal ID), V3 uses ID to identify the merge request.

* *
GitLab Endpoint: PUT /projects/:id/merge_requests/:merge_request_iid/merge
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @param params the MergeRequest instance holding the parameters for accepting the merge request * @return the merged merge request * @throws GitLabApiException if any exception occurs */ public MergeRequest acceptMergeRequest(Object projectIdOrPath, Long mergeRequestIid, AcceptMergeRequestParams params) throws GitLabApiException { Response response = put(Response.Status.OK, params.getForm().asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "merge"); return (response.readEntity(MergeRequest.class)); } /** * Merge changes to the merge request. If the MR has any conflicts and can not be merged, * you'll get a 405 and the error message 'Branch cannot be merged'. If merge request is * already merged or closed, you'll get a 406 and the error message 'Method Not Allowed'. * If the sha parameter is passed and does not match the HEAD of the source, you'll get * a 409 and the error message 'SHA does not match HEAD of source branch'. If you don't * have permissions to accept this merge request, you'll get a 401. * *

NOTE: GitLab API V4 uses IID (internal ID), V3 uses ID to identify the merge request.

* *
GitLab Endpoint: PUT /projects/:id/merge_requests/:merge_request_iid/merge
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return the merged merge request * @throws GitLabApiException if any exception occurs */ public MergeRequest acceptMergeRequest(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return (acceptMergeRequest(projectIdOrPath, mergeRequestIid, null, null, null, null)); } /** * Merge changes to the merge request. If the MR has any conflicts and can not be merged, * you'll get a 405 and the error message 'Branch cannot be merged'. If merge request is * already merged or closed, you'll get a 406 and the error message 'Method Not Allowed'. * If the sha parameter is passed and does not match the HEAD of the source, you'll get * a 409 and the error message 'SHA does not match HEAD of source branch'. If you don't * have permissions to accept this merge request, you'll get a 401. * *

NOTE: GitLab API V4 uses IID (internal ID), V3 uses ID to identify the merge request. Additionally, * mergeWhenPipelineSucceeds sets the merge_when_build_succeeds flag for GitLab API V3.

* *
GitLab Endpoint: PUT /projects/:id/merge_requests/:merge_request_iid/merge
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @param mergeCommitMessage custom merge commit message, optional * @param shouldRemoveSourceBranch if true removes the source branch, optional * @param mergeWhenPipelineSucceeds if true the MR is merged when the pipeline, optional * @return the merged merge request * @throws GitLabApiException if any exception occurs */ public MergeRequest acceptMergeRequest(Object projectIdOrPath, Long mergeRequestIid, String mergeCommitMessage, Boolean shouldRemoveSourceBranch, Boolean mergeWhenPipelineSucceeds) throws GitLabApiException { return (acceptMergeRequest(projectIdOrPath, mergeRequestIid, mergeCommitMessage, shouldRemoveSourceBranch, mergeWhenPipelineSucceeds, null)); } /** * Merge changes to the merge request. If the MR has any conflicts and can not be merged, * you'll get a 405 and the error message 'Branch cannot be merged'. If merge request is * already merged or closed, you'll get a 406 and the error message 'Method Not Allowed'. * If the sha parameter is passed and does not match the HEAD of the source, you'll get * a 409 and the error message 'SHA does not match HEAD of source branch'. If you don't * have permissions to accept this merge request, you'll get a 401. * *

NOTE: GitLab API V4 uses IID (internal ID), V3 uses ID to identify the merge request. Additionally, * mergeWhenPipelineSucceeds sets the merge_when_build_succeeds flag for GitLab API V3.

* *
GitLab Endpoint: PUT /projects/:id/merge_requests/:merge_request_iid/merge
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @param mergeCommitMessage custom merge commit message, optional * @param shouldRemoveSourceBranch if true removes the source branch, optional * @param mergeWhenPipelineSucceeds if true the MR is merged when the pipeline, optional * @param sha if present, then this SHA must match the HEAD of the source branch, otherwise the merge will fail, optional * @return the merged merge request * @throws GitLabApiException if any exception occurs */ public MergeRequest acceptMergeRequest(Object projectIdOrPath, Long mergeRequestIid, String mergeCommitMessage, Boolean shouldRemoveSourceBranch, Boolean mergeWhenPipelineSucceeds, String sha) throws GitLabApiException { if (mergeRequestIid == null) { throw new RuntimeException("mergeRequestIid cannot be null"); } Form formData = new GitLabApiForm() .withParam("merge_commit_message", mergeCommitMessage) .withParam("should_remove_source_branch", shouldRemoveSourceBranch) .withParam((isApiVersion(ApiVersion.V3) ? "merge_when_build_succeeds" : "merge_when_pipeline_succeeds"), mergeWhenPipelineSucceeds) .withParam("sha", sha); Response response = put(Response.Status.OK, formData.asMap(), "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "merge"); return (response.readEntity(MergeRequest.class)); } /** * Cancel merge when pipeline succeeds. If you don't have permissions to accept this merge request, * you'll get a 401. If the merge request is already merged or closed, you get 405 and * error message 'Method Not Allowed'. In case the merge request is not set to be merged when the * pipeline succeeds, you'll also get a 406 error. * *

NOTE: GitLab API V4 uses IID (internal ID), V3 uses ID to identify the merge request.

* *
GitLab Endpoint: POST /projects/:id/merge_requests/:merge_request_iid/cancel_merge_when_pipeline_succeeds
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return the updated merge request * @throws GitLabApiException if any exception occurs */ public MergeRequest cancelMergeRequest(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { if (mergeRequestIid == null) { throw new RuntimeException("mergeRequestIid cannot be null"); } Response response = post(Response.Status.OK, (Form)null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "cancel_merge_when_pipeline_succeeds"); return (response.readEntity(MergeRequest.class)); } /** * Get the merge request with approval information. * * Note: This API endpoint is only available on 8.9 Starter and above. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/approvals
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return a MergeRequest instance with approval information included * @throws GitLabApiException if any exception occurs */ public MergeRequest getMergeRequestApprovals(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return (getApprovals(projectIdOrPath, mergeRequestIid)); } /** * Get the merge request with approval information. * * Note: This API endpoint is only available on 8.9 Starter and above. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/approvals
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return a MergeRequest instance with approval information included * @throws GitLabApiException if any exception occurs */ public MergeRequest getApprovals(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { if (mergeRequestIid == null) { throw new RuntimeException("mergeRequestIid cannot be null"); } Response response = get(Response.Status.OK, null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "approvals"); return (response.readEntity(MergeRequest.class)); } /** * Get the approval state of a merge request. * Note: This API endpoint is only available on 12.3 Starter and above. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/approval_state
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return a ApprovalState instance with approval state * @throws GitLabApiException if any exception occurs */ public ApprovalState getApprovalState(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { if (mergeRequestIid == null) { throw new RuntimeException("mergeRequestIid cannot be null"); } Response response = get(Response.Status.OK, null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "approval_state"); return (response.readEntity(ApprovalState.class)); } /** * Get a list of the merge request level approval rules. * Note: This API endpoint is only available on 12.3 Starter and above. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/approval_rules
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return a List of ApprovalRule instances for the specified merge request. * @throws GitLabApiException if any exception occurs */ public List getApprovalRules(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return (getApprovalRules(projectIdOrPath, mergeRequestIid, -1).all()); } /** * Get a Pager of the merge request level approval rules. * Note: This API endpoint is only available on 12.3 Starter and above. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/approval_rules
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @param itemsPerPage the number of ApprovalRule instances that will be fetched per page * @return a Pager of ApprovalRule instances for the specified merge request. * @throws GitLabApiException if any exception occurs */ public Pager getApprovalRules(Object projectIdOrPath, Long mergeRequestIid, int itemsPerPage) throws GitLabApiException { if (mergeRequestIid == null) { throw new RuntimeException("mergeRequestIid cannot be null"); } return (new Pager(this, ApprovalRule.class, itemsPerPage, null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "approval_rules")); } /** * Get a Stream of the merge request level approval rules. * Note: This API endpoint is only available on 12.3 Starter and above. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/approval_rules
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return a Stream of ApprovalRule instances for the specified merge request. * @throws GitLabApiException if any exception occurs */ public Stream getApprovalRulesStream(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return (getApprovalRules(projectIdOrPath, mergeRequestIid, -1).stream()); } /** * Create a merge request level approval rule. * Note: This API endpoint is only available on 12.3 Starter and above. * *
GitLab Endpoint: POST /projects/:id/merge_requests/:merge_request_iid/approval_rules
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @param projectRuleId the ID of a project-level approval rule * @param params the ApprovalRuleParams instance holding the parameters for the approval rule * @return a ApprovalRule instance with approval configuration * @throws GitLabApiException if any exception occurs */ public ApprovalRule createApprovalRule(Object projectIdOrPath, Long mergeRequestIid, Long projectRuleId, ApprovalRuleParams params) throws GitLabApiException { if (mergeRequestIid == null) { throw new RuntimeException("mergeRequestIid cannot be null"); } GitLabApiForm formData = params.getForm(); formData.withParam("approval_project_rule_id", projectRuleId); Response response = post(Response.Status.OK, formData, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "approval_rules"); return (response.readEntity(ApprovalRule.class)); } /** * Update the specified the merge request level approval rule. * Note: This API endpoint is only available on 12.3 Starter and above. * *
GitLab Endpoint: PUT /projects/:id/merge_requests/:merge_request_iid/approval_rules/:approval_rule_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @param approvalRuleId the ID of the approval rule * @param params the ApprovalRuleParams instance holding the parameters for the approval rule update * @return a ApprovalRule instance with approval configuration * @throws GitLabApiException if any exception occurs */ public ApprovalRule updateApprovalRule(Object projectIdOrPath, Long mergeRequestIid, Long approvalRuleId, ApprovalRuleParams params) throws GitLabApiException { if (mergeRequestIid == null) { throw new RuntimeException("mergeRequestIid cannot be null"); } if (approvalRuleId == null) { throw new RuntimeException("approvalRuleId cannot be null"); } GitLabApiForm formData = params.getForm(); Response response = putWithFormData(Response.Status.OK, formData, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "approval_rules", approvalRuleId); return (response.readEntity(ApprovalRule.class)); } /** * Delete the specified the merge request level approval rule. * Note: This API endpoint is only available on 12.3 Starter and above. * *
GitLab Endpoint: DELETE /projects/:id/merge_requests/:merge_request_iid/approval_rules/:approval_rule_id
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @param approvalRuleId the ID of the approval rule * @throws GitLabApiException if any exception occurs */ public void deleteApprovalRule(Object projectIdOrPath, Long mergeRequestIid, Long approvalRuleId) throws GitLabApiException { if (mergeRequestIid == null) { throw new RuntimeException("mergeRequestIid cannot be null"); } if (approvalRuleId == null) { throw new RuntimeException("approvalRuleId cannot be null"); } delete(Response.Status.OK, null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "approval_rules", approvalRuleId); } /** * Approve a merge request. * * Note: This API endpoint is only available on 8.9 EE and above. * *
GitLab Endpoint: POST /projects/:id/merge_requests/:merge_request_iid/approve
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @param sha the HEAD of the merge request, optional * @return a MergeRequest instance with approval information included * @throws GitLabApiException if any exception occurs */ public MergeRequest approveMergeRequest(Object projectIdOrPath, Long mergeRequestIid, String sha) throws GitLabApiException { if (mergeRequestIid == null) { throw new RuntimeException("mergeRequestIid cannot be null"); } Form formData = new GitLabApiForm().withParam("sha", sha); Response response = post(Response.Status.OK, formData, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "approve"); return (response.readEntity(MergeRequest.class)); } /** * Unapprove a merge request. * * Note: This API endpoint is only available on 8.9 EE and above. * *
GitLab Endpoint: POST /projects/:id/merge_requests/:merge_request_iid/unapprove
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return a MergeRequest instance with approval information included * @throws GitLabApiException if any exception occurs */ public MergeRequest unapproveMergeRequest(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { if (mergeRequestIid == null) { throw new RuntimeException("mergeRequestIid cannot be null"); } Response response = post(Response.Status.OK, (Form)null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "unapprove"); return (response.readEntity(MergeRequest.class)); } /** * Get merge request with changes information. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/changes
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the IID of the merge request to get * @return a merge request including its changes * @throws GitLabApiException if any exception occurs */ public MergeRequest getMergeRequestChanges(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { Response response = get(Response.Status.OK, null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "changes"); return (response.readEntity(MergeRequest.class)); } /** * Get list of participants of merge request. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/participants
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the IID of the merge request to get * @return a List containing all participants for the specified merge request * @throws GitLabApiException if any exception occurs */ public List getParticipants(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return (getParticipants(projectIdOrPath, mergeRequestIid, getDefaultPerPage()).all()); } /** * Get list of participants of merge request and in the specified page range. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/participants
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the IID of the merge request to get * @param page the page to get * @param perPage the number of projects per page * @return a List containing all participants for the specified merge request * @throws GitLabApiException if any exception occurs */ public List getParticipants(Object projectIdOrPath, Long mergeRequestIid, int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "participants"); return (response.readEntity(new GenericType>() { })); } /** * Get a Pager of the participants of merge request. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/participants
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the IID of the merge request to get * @param itemsPerPage the number of Participant instances that will be fetched per page * @return a Pager containing all participants for the specified merge request * @throws GitLabApiException if any exception occurs */ public Pager getParticipants(Object projectIdOrPath, Long mergeRequestIid, int itemsPerPage) throws GitLabApiException { return new Pager(this, Participant.class, itemsPerPage, null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "participants"); } /** * Get Stream of participants of merge request. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/participants
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the IID of the merge request to get * @return a Stream containing all participants for the specified merge request * @throws GitLabApiException if any exception occurs */ public Stream getParticipantsStream(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return (getParticipants(projectIdOrPath, mergeRequestIid, getDefaultPerPage()).stream()); } /** * Get list containing all the issues that would be closed by merging the provided merge request. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/closes_issues
* * @param projectIdOrPath id, path of the project, or a Project instance holding the project ID or path * @param mergeRequestIid the IID of the merge request to get the closes issues for * @return a List containing all the issues that would be closed by merging the provided merge request * @throws GitLabApiException if any exception occurs */ public List getClosesIssues(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return (getClosesIssues(projectIdOrPath, mergeRequestIid, getDefaultPerPage()).all()); } /** * Get list containing all the issues that would be closed by merging the provided merge request. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/closes_issues
* * @param projectIdOrPath id, path of the project, or a Project instance holding the project ID or path * @param mergeRequestIid the IID of the merge request to get the closes issues for * @param page the page to get * @param perPage the number of issues per page * @return a List containing all the issues that would be closed by merging the provided merge request * @throws GitLabApiException if any exception occurs */ public List getClosesIssues(Object projectIdOrPath, Long mergeRequestIid, int page, int perPage) throws GitLabApiException { Response response = get(Response.Status.OK, getPageQueryParams(page, perPage), "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "closes_issues"); return (response.readEntity(new GenericType>() { })); } /** * Get a Pager containing all the issues that would be closed by merging the provided merge request. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/closes_issues
* * @param projectIdOrPath id, path of the project, or a Project instance holding the project ID or path * @param mergeRequestIid the IID of the merge request to get the closes issues for * @param itemsPerPage the number of Issue instances that will be fetched per page * @return a Pager containing all the issues that would be closed by merging the provided merge request * @throws GitLabApiException if any exception occurs */ public Pager getClosesIssues(Object projectIdOrPath, Long mergeRequestIid, int itemsPerPage) throws GitLabApiException { return new Pager(this, Issue.class, itemsPerPage, null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "closes_issues"); } /** * Get Stream containing all the issues that would be closed by merging the provided merge request. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/closes_issues
* * @param projectIdOrPath id, path of the project, or a Project instance holding the project ID or path * @param mergeRequestIid the IID of the merge request to get the closes issues for * @return a Stream containing all the issues that would be closed by merging the provided merge request * @throws GitLabApiException if any exception occurs */ public Stream getClosesIssuesStream(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return (getClosesIssues(projectIdOrPath, mergeRequestIid, getDefaultPerPage()).stream()); } /** * Get list containing all the issues that would be closed by merging the provided merge request. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/closes_issues
* * @param projectIdOrPath id, path of the project, or a Project instance holding the project ID or path * @param mergeRequestIid the IID of the merge request to get the closes issues for * @return a List containing all the issues that would be closed by merging the provided merge request * @throws GitLabApiException if any exception occurs */ public List getApprovalStatus(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return (getClosesIssues(projectIdOrPath, mergeRequestIid, getDefaultPerPage()).all()); } /** * Automatically rebase the source_branch of the merge request against its target_branch. * * This is an asynchronous request. The API will return a 202 Accepted response if the * request is enqueued successfully * *
GitLab Endpoint: PUT /projects/:id/merge_requests/:merge_request_iid/rebase
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request to rebase * @return the merge request info containing the status of a merge request rebase * @throws GitLabApiException if any exception occurs */ public MergeRequest rebaseMergeRequest(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { Response response = put(Response.Status.ACCEPTED, null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "rebase"); return (response.readEntity(MergeRequest.class)); } /** * Get the merge request info containing the status of a merge request rebase. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request being rebased * @return the merge request info containing the status of a merge request rebase * @throws GitLabApiException if any exception occurs */ public MergeRequest getRebaseStatus(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return getMergeRequest(projectIdOrPath, mergeRequestIid, null, null, true); } /** * Get a list of pipelines for a merge request. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/pipelines
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return a list containing the pipelines for the specified merge request * @throws GitLabApiException if any exception occurs during execution */ public List getMergeRequestPipelines(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return (getMergeRequestPipelines(projectIdOrPath, mergeRequestIid, getDefaultPerPage()).all()); } /** * Get a Pager of pipelines for a merge request. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/pipelines
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @param itemsPerPage the number of Pipeline instances that will be fetched per page * @return a Pager containing the pipelines for the specified merge request * @throws GitLabApiException if any exception occurs during execution */ public Pager getMergeRequestPipelines(Object projectIdOrPath, Long mergeRequestIid, int itemsPerPage) throws GitLabApiException { return (new Pager(this, Pipeline.class, itemsPerPage, null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "pipelines")); } /** * Get a Stream of pipelines for a merge request. * *
GitLab Endpoint: GET /projects/:id/merge_requests/:merge_request_iid/pipelines
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return a Stream containing the pipelines for the specified merge request * @throws GitLabApiException if any exception occurs during execution */ public Stream getMergeRequestPipelinesStream(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { return (getMergeRequestPipelines(projectIdOrPath, mergeRequestIid, getDefaultPerPage()).stream()); } /** *

Create a new pipeline for a merge request. A pipeline created via this endpoint will not run * a regular branch/tag pipeline, it requires .gitlab-ci.yml to be configured with only: * [merge_requests] to create jobs.

* * The new pipeline can be: * A detached merge request pipeline. * A pipeline for merged results if the project setting is enabled. * *
GitLab Endpoint: POST /projects/:id/merge_requests/:merge_request_iid/pipelines
* * @param projectIdOrPath the project in the form of an Long(ID), String(path), or Project instance * @param mergeRequestIid the internal ID of the merge request * @return a Pipeline instance with the newly created pipeline info * @throws GitLabApiException if any exception occurs during execution */ public Pipeline createMergeRequestPipeline(Object projectIdOrPath, Long mergeRequestIid) throws GitLabApiException { Response response = post(Response.Status.CREATED, (Form)null, "projects", getProjectIdOrPath(projectIdOrPath), "merge_requests", mergeRequestIid, "pipelines"); return (response.readEntity(Pipeline.class)); } }




© 2015 - 2024 Weber Informatics LLC | Privacy Policy