org.gitlab4j.api

Class RepositoryApi

java.lang.Object

org.gitlab4j.api.AbstractApi

org.gitlab4j.api.RepositoryApi

public class RepositoryApi
extends AbstractApi

This class provides an entry point to all the GitLab API repository calls.

Constructor Summary

Constructors

Constructor and Description
RepositoryApi(GitLabApi gitLabApi)

Method Summary

Modifier and Type	Method and Description
Branch	createBranch(Integer projectId, String branchName, String ref) Creates a branch for the project.
void	deleteBranch(Integer projectId, String branchName) Delete a single project repository branch.
Branch	getBranch(Integer projectId, String branchName) Get a single project repository branch.
List<Branch>	getBranches(Integer projectId) Get a list of repository branches from a project, sorted by name alphabetically.
String	getRawBlobCotent(Integer projectId, String sha) Get the raw file contents for a blob by blob SHA.
String	getRawFileContent(Integer projectId, String commitOrBranchName, String filepath) Get the raw file contents for a file by commit sha and path.
InputStream	getRepositoryArchive(Integer projectId, String sha) Get an archive of the complete repository by SHA (optional).
File	getRepositoryArchive(Integer projectId, String sha, File directory) Get an archive of the complete repository by SHA (optional) and saves to the specified directory.
List<Tag>	getTags(Integer projectId) Get a list of repository tags from a project, sorted by name in reverse alphabetical order.
List<TreeItem>	getTree(Integer projectId) Get a list of repository files and directories in a project.
List<TreeItem>	getTree(Integer projectId, String filePath, String refName) Get a list of repository files and directories in a project.
List<TreeItem>	getTree(Integer projectId, String filePath, String refName, Boolean recursive) Get a list of repository files and directories in a project.
Branch	protectBranch(Integer projectId, String branchName) Protects a single project repository branch.
Branch	unprotectBranch(Integer projectId, String branchName) Unprotects a single project repository branch.

Methods inherited from class org.gitlab4j.api.AbstractApi

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

Methods inherited from class java.lang.Object

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

Constructor Detail

RepositoryApi

public RepositoryApi(GitLabApi gitLabApi)

Method Detail

getBranches

public List<Branch> getBranches(Integer projectId)
                         throws GitLabApiException

Get a list of repository branches from a project, sorted by name alphabetically. GET /projects/:id/repository/branches

Parameters:

projectId -

Returns:

the list of repository branches for the specified project ID

Throws:

GitLabApiException

getBranch

public Branch getBranch(Integer projectId,
                        String branchName)
                 throws GitLabApiException

Get a single project repository branch. GET /projects/:id/repository/branches/:branch

Parameters:

projectId -

branchName -

Returns:

the branch info for the specified project ID/branch name pair

Throws:

GitLabApiException

createBranch

public Branch createBranch(Integer projectId,
                           String branchName,
                           String ref)
                    throws GitLabApiException

Creates a branch for the project. Support as of version 6.8.x POST /projects/:id/repository/branches

Parameters:

projectId - the project to create the branch for

branchName - the name of the branch to create

ref - Source to create the branch from, can be an existing branch, tag or commit SHA

Returns:

the branch info for the created branch

Throws:

GitLabApiException

deleteBranch

public void deleteBranch(Integer projectId,
                         String branchName)
                  throws GitLabApiException

Delete a single project repository branch. This is an idempotent function, protecting an already protected repository branch will not produce an error. DELETE /projects/:id/repository/branches/:branch

Parameters:

projectId -

branchName -

Throws:

GitLabApiException

protectBranch

public Branch protectBranch(Integer projectId,
                            String branchName)
                     throws GitLabApiException

Protects a single project repository branch. This is an idempotent function, protecting an already protected repository branch will not produce an error. PUT /projects/:id/repository/branches/:branch/protect

Parameters:

projectId -

branchName -

Returns:

the branch info for the protected branch

Throws:

GitLabApiException

unprotectBranch

public Branch unprotectBranch(Integer projectId,
                              String branchName)
                       throws GitLabApiException

Unprotects a single project repository branch. This is an idempotent function, unprotecting an already unprotected repository branch will not produce an error. PUT /projects/:id/repository/branches/:branch/unprotect

Parameters:

projectId -

branchName -

Returns:

the branch info for the unprotected branch

Throws:

GitLabApiException

getTags

public List<Tag> getTags(Integer projectId)
                  throws GitLabApiException

Get a list of repository tags from a project, sorted by name in reverse alphabetical order. GET /projects/:id/repository/tags

Parameters:

projectId -

Returns:

the list of tags for the specified project ID

Throws:

GitLabApiException

getTree

public List<TreeItem> getTree(Integer projectId)
                       throws GitLabApiException

Get a list of repository files and directories in a project. GET /projects/:id/repository/tree

Parameters:

projectId -

Returns:

a tree with the root directories and files of a project

Throws:

GitLabApiException

getTree

public List<TreeItem> getTree(Integer projectId,
                              String filePath,
                              String refName)
                       throws GitLabApiException

Get a list of repository files and directories in a project. GET /projects/:id/repository/tree id (required) - The ID of a project path (optional) - The path inside repository. Used to get contend of subdirectories ref_name (optional) - The name of a repository branch or tag or if not given the default branch

Parameters:

projectId -

filePath -

refName -

Returns:

a tree with the directories and files of a project

Throws:

GitLabApiException

getTree

public List<TreeItem> getTree(Integer projectId,
                              String filePath,
                              String refName,
                              Boolean recursive)
                       throws GitLabApiException

Get a list of repository files and directories in a project. GET /projects/:id/repository/tree id (required) - The ID of a project path (optional) - The path inside repository. Used to get contend of subdirectories ref_name (optional) - The name of a repository branch or tag or if not given the default branch recursive (optional) - Boolean value used to get a recursive tree (false by default)

Parameters:

projectId -

filePath -

refName -

recursive -

Returns:

a tree with the directories and files of a project

Throws:

GitLabApiException

getRawFileContent

public String getRawFileContent(Integer projectId,
                                String commitOrBranchName,
                                String filepath)
                         throws GitLabApiException

Get the raw file contents for a file by commit sha and path. GET /projects/:id/repository/blobs/:sha

Parameters:

projectId -

commitOrBranchName -

Returns:

a string with the file content for the specified file

Throws:

GitLabApiException

getRawBlobCotent

public String getRawBlobCotent(Integer projectId,
                               String sha)
                        throws GitLabApiException

Get the raw file contents for a blob by blob SHA. GET /projects/:id/repository/raw_blobs/:sha

Parameters:

projectId -

sha -

Returns:

the raw file contents for the blob

Throws:

GitLabApiException

getRepositoryArchive

public InputStream getRepositoryArchive(Integer projectId,
                                        String sha)
                                 throws GitLabApiException

Get an archive of the complete repository by SHA (optional). GET /projects/:id/repository/archive

Parameters:

projectId -

sha -

Returns:

an input stream that can be used to save as a file or to read the content of the archive

Throws:

GitLabApiException

getRepositoryArchive

public File getRepositoryArchive(Integer projectId,
                                 String sha,
                                 File directory)
                          throws GitLabApiException

Get an archive of the complete repository by SHA (optional) and saves to the specified directory. If the archive already exists in the directory it will be overwritten. GET /projects/:id/repository/archive

Parameters:

projectId -

sha -

directory - the File instance of the directory to save the archive to, if null will use "java.io.tmpdir"

Returns:

a File instance pointing to the downloaded instance

Throws:

GitLabApiException