Package org.gitlab4j.api

Class CommitsApi

java.lang.Object

org.gitlab4j.api.AbstractApi

org.gitlab4j.api.CommitsApi

All Implemented Interfaces:

Constants

public class CommitsApi
extends AbstractApi

This class implements the client side API for the GitLab commits calls.

Nested Class Summary

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

Constants.ActionType, Constants.EpicOrderBy, Constants.GroupOrderBy, Constants.ImpersonationState, Constants.IssueScope, Constants.IssueState, Constants.JobScope, Constants.LineType, Constants.MergeRequestOrderBy, Constants.MergeRequestScope, 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
CommitsApi(GitLabApi gitLabApi)

Method Summary

Modifier and Type	Method	Description
Comment	addComment(int projectId, String sha, String note)	Add a comment to a commit.
Comment	addComment(int projectId, String sha, String note, String path, Integer line, Constants.LineType lineType)	Add a comment to a commit.
Commit	createCommit(int projectId, String branch, String commitMessage, String startBranch, String authorEmail, String authorName, List<CommitAction> actions)	Create a commit with multiple files and actions.
Commit	createCommit(String project, String branch, String commitMessage, String startBranch, String authorEmail, String authorName, List<CommitAction> actions)	Create a commit with multiple files and actions.
List<Comment>	getComments(int projectId, String sha)	Get the comments of a commit in a project.
Pager<Comment>	getComments(int projectId, String sha, int itemsPerPage)	Get a Pager of the comments of a commit in a project.
Commit	getCommit(int projectId, String sha)	Get a specific commit identified by the commit hash or name of a branch or tag.
List<CommitRef>	getCommitRefs(int projectId, String sha)	Get a specific commit identified by the commit hash or name of a branch or tag as an Optional instance GET /projects/:id/repository/commits/:sha/refs
List<CommitRef>	getCommitRefs(int projectId, String sha, CommitRef.RefType refType)	Get a specific commit identified by the commit hash or name of a branch or tag as an Optional instance GET /projects/:id/repository/commits/:sha/refs?type=:refType
List<Commit>	getCommits(int projectId)	Get a list of repository commits in a project.
Pager<Commit>	getCommits(int projectId, int itemsPerPage)	Get a Pager of repository commits in a project.
List<Commit>	getCommits(int projectId, int page, int perPage)	Get a list of repository commits in a project.
List<Commit>	getCommits(int projectId, String ref, String path)	Get a list of file commits in a project GET /projects/:id/repository/commits?path=:file_path
List<Commit>	getCommits(int projectId, String ref, Date since, Date until)	Get a list of repository commits in a project.
Pager<Commit>	getCommits(int projectId, String ref, Date since, Date until, int itemsPerPage)	Get a Pager of repository commits in a project.
List<Commit>	getCommits(int projectId, String ref, Date since, Date until, int page, int perPage)	Get a list of repository commits in a project.
List<Commit>	getCommits(int projectId, String ref, Date since, Date until, String path)	Get a list of repository commits in a project.
Pager<Commit>	getCommits(int projectId, String ref, Date since, Date until, String path, int itemsPerPage)	Get a Pager of repository commits in a project GET /projects/:id/repository/commits
List<Commit>	getCommits(int projectId, String ref, Date since, Date until, String path, int page, int perPage)	Get a list of repository commits in a project.
List<Diff>	getDiff(int projectId, String sha)	Get the list of diffs of a commit in a project.
List<Diff>	getDiff(String projectPath, String sha)	Get the list of diffs of a commit in a project.
Optional<Commit>	getOptionalCommit(int projectId, String sha)	Get a specific commit identified by the commit hash or name of a branch or tag as an Optional instance GET /projects/:id/repository/commits/:sha

Methods inherited from class org.gitlab4j.api.AbstractApi

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

Methods inherited from class java.lang.Object

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

Constructor Detail

CommitsApi

public CommitsApi(GitLabApi gitLabApi)

Method Detail

getCommits

public List<Commit> getCommits(int projectId)
                        throws GitLabApiException

Get a list of repository commits in a project. GET /projects/:id/repository/commits

Parameters:

projectId - the project ID to get the list of commits for

Returns:

a list containing the commits for the specified project ID

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

getCommits

public List<Commit> getCommits(int projectId,
                               int page,
                               int perPage)
                        throws GitLabApiException

Get a list of repository commits in a project. GET /projects/:id/repository/commits

Parameters:

projectId - the project ID to get the list of commits for

page - the page to get

perPage - the number of commits per page

Returns:

a list containing the commits for the specified project ID

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

getCommits

public Pager<Commit> getCommits(int projectId,
                                int itemsPerPage)
                         throws GitLabApiException

Get a Pager of repository commits in a project. GET /projects/:id/repository/commits

Parameters:

projectId - the project ID to get the list of commits for

itemsPerPage - the number of Commit instances that will be fetched per page

Returns:

a Pager containing the commits for the specified project ID

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

getCommits

public List<Commit> getCommits(int projectId,
                               String ref,
                               Date since,
                               Date until)
                        throws GitLabApiException

Get a list of repository commits in a project. GET /projects/:id/repository/commits

Parameters:

projectId - the project ID to get the list of commits for

ref - the name of a repository branch or tag or if not given the default branch

since - only commits after or on this date will be returned

until - only commits before or on this date will be returned

Returns:

a list containing the commits for the specified project ID

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

getCommits

public List<Commit> getCommits(int projectId,
                               String ref,
                               Date since,
                               Date until,
                               String path)
                        throws GitLabApiException

Get a list of repository commits in a project. GET /projects/:id/repository/commits

Parameters:

projectId - the project ID to get the list of commits for

ref - the name of a repository branch or tag or if not given the default branch

since - only commits after or on this date will be returned

until - only commits before or on this date will be returned

path - the path to file of a project

Returns:

a list containing the commits for the specified project ID

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

getCommits

public List<Commit> getCommits(int projectId,
                               String ref,
                               String path)
                        throws GitLabApiException

Get a list of file commits in a project GET /projects/:id/repository/commits?path=:file_path

Parameters:

projectId - the project ID to get the list of commits for

ref - the name of a repository branch or tag or if not given the default branch

path - the path to file of a project

Returns:

a list containing the commits for the specified project ID and file

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

getCommits

public List<Commit> getCommits(int projectId,
                               String ref,
                               Date since,
                               Date until,
                               int page,
                               int perPage)
                        throws GitLabApiException

Get a list of repository commits in a project. GET /projects/:id/repository/commits

Parameters:

projectId - the project ID to get the list of commits for

ref - the name of a repository branch or tag or if not given the default branch

since - only commits after or on this date will be returned

until - only commits before or on this date will be returned

page - the page to get

perPage - the number of commits per page

Returns:

a list containing the commits for the specified project ID

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

getCommits

public List<Commit> getCommits(int projectId,
                               String ref,
                               Date since,
                               Date until,
                               String path,
                               int page,
                               int perPage)
                        throws GitLabApiException

Get a list of repository commits in a project. GET /projects/:id/repository/commits

Parameters:

projectId - the project ID to get the list of commits for

ref - the name of a repository branch or tag or if not given the default branch

since - only commits after or on this date will be returned

until - only commits before or on this date will be returned

path - the path to file of a project

page - the page to get

perPage - the number of commits per page

Returns:

a list containing the commits for the specified project ID

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

getCommits

public Pager<Commit> getCommits(int projectId,
                                String ref,
                                Date since,
                                Date until,
                                int itemsPerPage)
                         throws GitLabApiException

Get a Pager of repository commits in a project. GET /projects/:id/repository/commits

Parameters:

projectId - the project ID to get the list of commits for

ref - the name of a repository branch or tag or if not given the default branch

since - only commits after or on this date will be returned

until - only commits before or on this date will be returned

itemsPerPage - the number of Commit instances that will be fetched per page

Returns:

a Pager containing the commits for the specified project ID

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

getCommits

public Pager<Commit> getCommits(int projectId,
                                String ref,
                                Date since,
                                Date until,
                                String path,
                                int itemsPerPage)
                         throws GitLabApiException

Get a Pager of repository commits in a project GET /projects/:id/repository/commits

Parameters:

projectId - the project ID to get the list of commits for

ref - the name of a repository branch or tag or if not given the default branch

since - only commits after or on this date will be returned

until - only commits before or on this date will be returned

itemsPerPage - the number of Commit instances that will be fetched per page

path - the path to file of a project

Returns:

a Pager containing the commits for the specified project ID

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

getCommit

public Commit getCommit(int projectId,
                        String sha)
                 throws GitLabApiException

Get a specific commit identified by the commit hash or name of a branch or tag. GET /projects/:id/repository/commits/:sha

Parameters:

projectId - the project ID that the commit belongs to

sha - a commit hash or name of a branch or tag

Returns:

the Commit instance for the specified project ID/sha pair

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

getOptionalCommit

public Optional<Commit> getOptionalCommit(int projectId,
                                          String sha)

Get a specific commit identified by the commit hash or name of a branch or tag as an Optional instance GET /projects/:id/repository/commits/:sha

Parameters:

projectId - the project ID that the commit belongs to

sha - a commit hash or name of a branch or tag

Returns:

the Commit for the specified project ID/sha pair as an Optional instance

getCommitRefs

public List<CommitRef> getCommitRefs(int projectId,
                                     String sha)
                              throws GitLabApiException

Get a specific commit identified by the commit hash or name of a branch or tag as an Optional instance GET /projects/:id/repository/commits/:sha/refs

Parameters:

projectId - the project ID that the commit belongs to

sha - a commit hash or name of a branch or tag

Returns:

Get all references (from branches or tags) a commit is pushed to

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

Since:

Gitlab 10.6

getCommitRefs

public List<CommitRef> getCommitRefs(int projectId,
                                     String sha,
                                     CommitRef.RefType refType)
                              throws GitLabApiException

Get a specific commit identified by the commit hash or name of a branch or tag as an Optional instance GET /projects/:id/repository/commits/:sha/refs?type=:refType

Parameters:

projectId - the project ID that the commit belongs to

sha - a commit hash or name of a branch or tag

refType - the scope of commits. Possible values branch, tag, all. Default is all.

Returns:

Get all references (from branches or tags) a commit is pushed to

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

Since:

Gitlab 10.6

getDiff

public List<Diff> getDiff(int projectId,
                          String sha)
                   throws GitLabApiException

Get the list of diffs of a commit in a project. GET /projects/:id/repository/commits/:sha/diff

Parameters:

projectId - the project ID that the commit belongs to

sha - a commit hash or name of a branch or tag

Returns:

a List of Diff instances for the specified project ID/sha pair

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

getDiff

public List<Diff> getDiff(String projectPath,
                          String sha)
                   throws GitLabApiException

Get the list of diffs of a commit in a project. GET /projects/:id/repository/commits/:sha/diff

Parameters:

projectPath - the project path that the commit belongs to

sha - a commit hash or name of a branch or tag

Returns:

a List of Diff instances for the specified project ID/sha pair

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

getComments

public List<Comment> getComments(int projectId,
                                 String sha)
                          throws GitLabApiException

Get the comments of a commit in a project. GET /projects/:id/repository/commits/:sha/comments

Parameters:

projectId - the project ID that the commit belongs to

sha - a commit hash or name of a branch or tag

Returns:

a List of Comment instances for the specified project ID/sha pair

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

getComments

public Pager<Comment> getComments(int projectId,
                                  String sha,
                                  int itemsPerPage)
                           throws GitLabApiException

Get a Pager of the comments of a commit in a project. GET /projects/:id/repository/commits/:sha/comments

Parameters:

projectId - the project ID that the commit belongs to

sha - a commit hash or name of a branch or tag

itemsPerPage - the number of Comment instances that will be fetched per page

Returns:

a List of Comment instances for the specified project ID/sha pair

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

addComment

public Comment addComment(int projectId,
                          String sha,
                          String note,
                          String path,
                          Integer line,
                          Constants.LineType lineType)
                   throws GitLabApiException

Add a comment to a commit. In order to post a comment in a particular line of a particular file, you must specify the full commit SHA, the path, the line and lineType should be NEW. POST /projects/:id/repository/commits/:sha/comments

Parameters:

projectId - the project ID that the commit belongs to

sha - a commit hash or name of a branch or tag

note - the text of the comment, required

path - the file path relative to the repository, optional

line - the line number where the comment should be placed, optional

lineType - the line type, optional

Returns:

a Comment instance for the posted comment

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

addComment

public Comment addComment(int projectId,
                          String sha,
                          String note)
                   throws GitLabApiException

Add a comment to a commit. POST /projects/:id/repository/commits/:sha/comments

Parameters:

projectId - the project ID that the commit belongs to

sha - a commit hash or name of a branch or tag

note - the text of the comment, required

Returns:

a Comment instance for the posted comment

Throws:

GitLabApiException - GitLabApiException if any exception occurs during execution

createCommit

public Commit createCommit(int projectId,
                           String branch,
                           String commitMessage,
                           String startBranch,
                           String authorEmail,
                           String authorName,
                           List<CommitAction> actions)
                    throws GitLabApiException

Create a commit with multiple files and actions. POST /projects/:id/repository/commits

Parameters:

projectId - the ID of the project

branch - tame of the branch to commit into. To create a new branch, also provide startBranch

commitMessage - the commit message

startBranch - the name of the branch to start the new commit from

authorEmail - the commit author's email address

authorName - the commit author's name

actions - the array of CommitAction to commit as a batch

Returns:

the create Commit instance

Throws:

GitLabApiException - if any exception occurs during execution

createCommit

public Commit createCommit(String project,
                           String branch,
                           String commitMessage,
                           String startBranch,
                           String authorEmail,
                           String authorName,
                           List<CommitAction> actions)
                    throws GitLabApiException

Create a commit with multiple files and actions. POST /projects/:id/repository/commits

Parameters:

project - the path of the project

branch - tame of the branch to commit into. To create a new branch, also provide startBranch

commitMessage - the commit message

startBranch - the name of the branch to start the new commit from

authorEmail - the commit author's email address

authorName - the commit author's name

actions - the array of CommitAction to commit as a batch

Returns:

the create Commit instance

Throws:

GitLabApiException - if any exception occurs during execution