com.messners.gitlab.api

Class MergeRequestApi

java.lang.Object

com.messners.gitlab.api.AbstractApi

com.messners.gitlab.api.MergeRequestApi

public class MergeRequestApi
extends AbstractApi

This class implements the client side API for the GitLab merge request calls.

Author:

Greg Messner

Method Summary

Methods

Modifier and Type	Method and Description
MergeRequestComment	addMergeRequestComment(Integer projectId, Integer mergeRequestId, String comments) Adds a comment to a merge request.
MergeRequest	createMergeRequest(Integer projectId, String sourceBranch, String targetBranch, String title, String description, Integer assigneeId) Creates a merge request and optionally assigns a reviewer to it.
MergeRequest	getMergeRequest(Integer projectId, Integer mergeRequestId) Get information about a single merge request.
List<MergeRequest>	getMergeRequests(Integer projectId) Get all merge requests for the specified project.
MergeRequest	updateMergeRequest(Integer projectId, Integer mergeRequestId, String sourceBranch, String targetBranch, String title, String description, Integer assigneeId) Updates an existing merge request.

Methods inherited from class com.messners.gitlab.api.AbstractApi

addFormParam, addFormParam, delete, delete, get, get, getApiClient, handle, post, post, put, put, validate

Methods inherited from class java.lang.Object

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

Method Detail

getMergeRequests

public List<MergeRequest> getMergeRequests(Integer projectId)
                                    throws GitLabApiException

Get all merge requests for the specified project. GET /projects/:id/merge_requests

Parameters:

projectId - the project ID to get the merge requests for

Returns:

all merge requests for the specified project

Throws:

GitLabApiException

getMergeRequest

public MergeRequest getMergeRequest(Integer projectId,
                           Integer mergeRequestId)
                             throws GitLabApiException

Get information about a single merge request. GET /projects/:id/merge_request/:merge_request_id

Parameters:

projectId -

mergeRequestId -

Returns:

the specified MergeRequest instance

Throws:

GitLabApiException

createMergeRequest

public MergeRequest createMergeRequest(Integer projectId,
                              String sourceBranch,
                              String targetBranch,
                              String title,
                              String description,
                              Integer assigneeId)
                                throws GitLabApiException

Creates a merge request and optionally assigns a reviewer to it. POST /projects/:id/merge_requests

Parameters:

projectId - the ID of a project, required

sourceBranch - the source branch, required

targetBranch - the target branch, required

title - the title for the merge request, required

description - the description of the merge request

assigneeId - the Assignee user ID, optional

Returns:

the created MergeRequest instance

Throws:

GitLabApiException

updateMergeRequest

public MergeRequest updateMergeRequest(Integer projectId,
                              Integer mergeRequestId,
                              String sourceBranch,
                              String targetBranch,
                              String title,
                              String description,
                              Integer assigneeId)
                                throws GitLabApiException

Updates an existing merge request. You can change branches, title, or even close the MR. PUT /projects/:id/merge_request/:merge_request_id

Parameters:

projectId -

mergeRequestId -

sourceBranch -

targetBranch -

title -

description -

assigneeId -

Returns:

the updated merge request

Throws:

GitLabApiException

addMergeRequestComment

public MergeRequestComment addMergeRequestComment(Integer projectId,
                                         Integer mergeRequestId,
                                         String comments)
                                           throws GitLabApiException

Adds a comment to a merge request. POST /projects/:id/merge_request/:merge_request_id/comments

Parameters:

projectId -

mergeRequestId -

comments -

Returns:

the added merge request comment

Throws:

GitLabApiException