org.gitlab4j.api

Class RepositoryFileApi

java.lang.Object

org.gitlab4j.api.AbstractApi

org.gitlab4j.api.RepositoryFileApi

public class RepositoryFileApi
extends AbstractApi

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

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.
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, 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

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

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 - full path to new file. Ex. lib/class.rb

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 - full path to new file. Ex. lib/class.rb

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