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.ArchiveFormat, 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 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(Object projectIdOrPath, String filePath, String ref) Get file from repository.
RepositoryFile	getFile(Object projectIdOrPath, String filePath, String ref, boolean includeContent) Get file from repository.
RepositoryFile	getFile(String filePath, Integer projectId, String ref) Deprecated. Will be removed in version 5.0, replaced by getFile(Object, String, String)
RepositoryFile	getFileInfo(Object projectIdOrPath, String filePath, String ref) Get information on a file in the repository.
protected RepositoryFile	getFileV3(String filePath, Integer projectId, String ref) Deprecated. Will be removed in version 5.0
Optional<RepositoryFile>	getOptionalFile(Object projectIdOrPath, String filePath, String ref) Get an Optional instance with the value holding information and content for a file in the repository.
Optional<RepositoryFile>	getOptionalFileInfo(Object projectIdOrPath, String filePath, String ref) Get an Optional instance with the value holding information on a file in the 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, getGroupIdOrPath, getPageQueryParams, getProjectIdOrPath, getWithAccepts, handle, head, 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

RepositoryFileApi

public RepositoryFileApi(GitLabApi gitLabApi)

Method Detail

getOptionalFileInfo

public Optional<RepositoryFile> getOptionalFileInfo(Object projectIdOrPath,
                                                    String filePath,
                                                    String ref)

Get an Optional instance with the value holding information on a file in the repository. Allows you to receive information about file in repository like name, size. Only works with GitLab 11.1.0+, value will be an empty object for earlier versions of GitLab. HEAD /projects/:id/repository/files

Parameters:

projectIdOrPath - the id, path of the project, or a Project instance holding the project ID or path

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

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

Returns:

an Optional instance with the specified RepositoryFile as a value

getFileInfo

public RepositoryFile getFileInfo(Object projectIdOrPath,
                                  String filePath,
                                  String ref)
                           throws GitLabApiException

Get information on a file in the repository. Allows you to receive information about file in repository like name, size. Only works with GitLab 11.1.0+, returns an empty object for earlier versions of GitLab. HEAD /projects/:id/repository/files

Parameters:

projectIdOrPath - the id, path of the project, or a Project instance holding the project ID or path

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

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

Returns:

a RepositoryFile instance with the file info

Throws:

GitLabApiException - if any exception occurs

Since:

GitLab-11.1.0

getOptionalFile

public Optional<RepositoryFile> getOptionalFile(Object projectIdOrPath,
                                                String filePath,
                                                String ref)

Get an Optional instance with the value holding information and content for a file in the repository. Allows you to receive information about file in repository like name, size, and content. Only works with GitLab 11.1.0+, value will be an empty object for earlier versions of GitLab. HEAD /projects/:id/repository/files

Parameters:

projectIdOrPath - the id, path of the project, or a Project instance holding the project ID or path

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

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

Returns:

an Optional instance with the specified RepositoryFile as a value

getFile

public RepositoryFile getFile(Object projectIdOrPath,
                              String filePath,
                              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:

projectIdOrPath - the id, path of the project, or a Project instance holding the project ID or path

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

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

Returns:

a RepositoryFile instance with the file info and file content

Throws:

GitLabApiException - if any exception occurs

getFile

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

Deprecated. Will be removed in version 5.0, replaced by getFile(Object, String, String)

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 the 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 and file content

Throws:

GitLabApiException - if any exception occurs

getFile

public RepositoryFile getFile(Object projectIdOrPath,
                              String filePath,
                              String ref,
                              boolean includeContent)
                       throws GitLabApiException

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

Parameters:

projectIdOrPath - the id, path of the project, or a Project instance holding the project ID or path

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

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

includeContent - if true will also fetch file content

Returns:

a RepositoryFile instance with the file info and optionally file content

Throws:

GitLabApiException - if any exception occurs

getFileV3

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

Deprecated. Will be removed in version 5.0

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