org.gitlab4j.api

Class RepositoryFileApi

java.lang.Object

org.gitlab4j.api.AbstractApi

org.gitlab4j.api.RepositoryFileApi

All Implemented Interfaces:

Constants

public class RepositoryFileApi
extends AbstractApi

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

Nested Class Summary

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

Constants.ActionType, Constants.IssueScope, Constants.IssueState, Constants.JobScope, Constants.LineType, 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 and Description
RepositoryFileApi(GitLabApi gitLabApi)

Method Summary

Modifier and Type	Method and Description
RepositoryFile	createFile(RepositoryFile file, Integer projectId, String branchName, String commitMessage) Create new file in repository POST /projects/:id/repository/files file_path (required) - Full path to new file.
void	deleteFile(String filePath, Integer projectId, String branchName, String commitMessage) Delete existing file in repository DELETE /projects/:id/repository/files file_path (required) - Full path to file.
RepositoryFile	getFile(String filePath, Integer projectId, String ref) Get file from repository.
protected RepositoryFile	getFileV3(String filePath, Integer projectId, String ref) Get file from repository.
InputStream	getRawFile(Integer projectId, String commitOrBranchName, String filepath) Get the raw file contents for a file by commit sha and path.
File	getRawFile(Integer projectId, String commitOrBranchName, String filepath, File directory) Get the raw file for the file by commit sha and path.
RepositoryFile	updateFile(RepositoryFile file, Integer projectId, String branchName, String commitMessage) Update existing file in repository PUT /projects/:id/repository/files file_path (required) - Full path to new file.

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, putWithFormData, urlEncode, validate

Methods inherited from class java.lang.Object

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

Constructor Detail

RepositoryFileApi

public RepositoryFileApi(GitLabApi gitLabApi)

Method Detail

getFile

public RepositoryFile getFile(String filePath,
                              Integer projectId,
                              String ref)
                       throws GitLabApiException

Get file from repository. Allows you to receive information about file in repository like name, size, content. Note that file content is Base64 encoded. GET /projects/:id/repository/files

Parameters:

filePath - (required) - Full path to new file. Ex. lib/class.rb

projectId - (required) - the project ID

ref - (required) - The name of branch, tag or commit

Returns:

a RepositoryFile instance with the file info

Throws:

GitLabApiException - if any exception occurs

getFileV3

protected RepositoryFile getFileV3(String filePath,
                                   Integer projectId,
                                   String ref)
                            throws GitLabApiException

Get file from repository. Allows you to receive information about file in repository like name, size, content. Note that file content is Base64 encoded. GET /projects/:id/repository/files

Parameters:

filePath - (required) - Full path to new file. Ex. lib/class.rb

projectId - (required) - the project ID

ref - (required) - The name of branch, tag or commit

Returns:

a RepositoryFile instance with the file info

Throws:

GitLabApiException - if any exception occurs

createFile

public RepositoryFile createFile(RepositoryFile file,
                                 Integer projectId,
                                 String branchName,
                                 String commitMessage)
                          throws GitLabApiException

Create new file in repository POST /projects/:id/repository/files file_path (required) - Full path to new file. Ex. lib/class.rb branch_name (required) - The name of branch encoding (optional) - 'text' or 'base64'. Text is default. content (required) - File content commit_message (required) - Commit message

Parameters:

file - a ReposityoryFile instance with info for the file to create

projectId - the project ID

branchName - the name of branch

commitMessage - the commit message

Returns:

a RepositoryFile instance with the created file info

Throws:

GitLabApiException - if any exception occurs

updateFile

public RepositoryFile updateFile(RepositoryFile file,
                                 Integer projectId,
                                 String branchName,
                                 String commitMessage)
                          throws GitLabApiException

Update existing file in repository PUT /projects/:id/repository/files file_path (required) - Full path to new file. Ex. lib/class.rb branch_name (required) - The name of branch encoding (optional) - 'text' or 'base64'. Text is default. content (required) - File content commit_message (required) - Commit message

Parameters:

file - a ReposityoryFile instance with info for the file to update

projectId - the project ID

branchName - the name of branch

commitMessage - the commit message

Returns:

a RepositoryFile instance with the updated file info

Throws:

GitLabApiException - if any exception occurs

deleteFile

public void deleteFile(String filePath,
                       Integer projectId,
                       String branchName,
                       String commitMessage)
                throws GitLabApiException

Delete existing file in repository DELETE /projects/:id/repository/files file_path (required) - Full path to file. Ex. lib/class.rb branch_name (required) - The name of branch commit_message (required) - Commit message

Parameters:

filePath - full path to new file. Ex. lib/class.rb

projectId - the project ID

branchName - the name of branch

commitMessage - the commit message

Throws:

GitLabApiException - if any exception occurs

getRawFile

public File getRawFile(Integer projectId,
                       String commitOrBranchName,
                       String filepath,
                       File directory)
                throws GitLabApiException

Get the raw file for the file by commit sha and path. Thye file will be saved to the specified directory. If the file already exists in the directory it will be overwritten. GET /projects/:id/repository/archive

Parameters:

projectId - the ID of the project

commitOrBranchName - the commit or branch name to get the file for

filepath - the path of the file to get

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

Returns:

a File instance pointing to the download of the specified file

Throws:

GitLabApiException - if any exception occurs

getRawFile

public InputStream getRawFile(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 - the ID of the project

commitOrBranchName - the commit or branch name to get the file contents for

filepath - the path of the file to get

Returns:

an InputStream to read the raw file from

Throws:

GitLabApiException - if any exception occurs