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.JobScope, Constants.PipelineOrderBy, Constants.PipelineScope, Constants.ProjectOrderBy, Constants.SortOrder

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 and Description
CommitsApi(GitLabApi gitLabApi)

Method Summary

Modifier and Type	Method and Description
Commit	getCommit(int projectId, String sha) Get a specific commit identified by the commit hash or name of a branch or tag.
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, 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<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.

Methods inherited from class org.gitlab4j.api.AbstractApi

addFormParam, addFormParam, delete, delete, get, get, getApiClient, getApiVersion, getDefaultPerPage, getDefaultPerPageParam, getPageQueryParams, getWithAccepts, handle, isApiVersion, post, post, post, put, put, 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,
                               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 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

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

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