com.google.gerrit.server.edit

Class ChangeEditModifier

java.lang.Object

com.google.gerrit.server.edit.ChangeEditModifier

public class ChangeEditModifier
extends java.lang.Object

Utility functions to manipulate change edits.

This class contains methods to modify edit's content. For retrieving, publishing and deleting edit see ChangeEditUtil.

Method Summary

Modifier and Type	Method and Description
ChangeEdit	combineWithModifiedPatchSetTree(org.eclipse.jgit.lib.Repository repository, ChangeNotes notes, PatchSet patchSet, java.util.List<TreeModification> treeModifications) Applies the indicated modifications to the specified patch set.
void	createEdit(org.eclipse.jgit.lib.Repository repository, ChangeNotes notes) Creates a new change edit.
void	deleteFile(org.eclipse.jgit.lib.Repository repository, ChangeNotes notes, java.lang.String file) Deletes a file from the Git tree of a change edit.
void	modifyFile(org.eclipse.jgit.lib.Repository repository, ChangeNotes notes, java.lang.String filePath, RawInput newContent) Modifies the contents of a file of a change edit.
void	modifyMessage(org.eclipse.jgit.lib.Repository repository, ChangeNotes notes, java.lang.String newCommitMessage) Modifies the commit message of a change edit.
void	rebaseEdit(org.eclipse.jgit.lib.Repository repository, ChangeNotes notes) Rebase change edit on latest patch set
void	renameFile(org.eclipse.jgit.lib.Repository repository, ChangeNotes notes, java.lang.String currentFilePath, java.lang.String newFilePath) Renames a file of a change edit or moves it to another directory.
void	restoreFile(org.eclipse.jgit.lib.Repository repository, ChangeNotes notes, java.lang.String file) Restores a file of a change edit to the state it was in before the patch set on which the change edit is based.

Methods inherited from class java.lang.Object

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

Method Detail

createEdit

public void createEdit(org.eclipse.jgit.lib.Repository repository,
                       ChangeNotes notes)
                throws AuthException,
                       java.io.IOException,
                       InvalidChangeOperationException,
                       PermissionBackendException,
                       ResourceConflictException

Creates a new change edit.

Parameters:

repository - the affected Git repository

notes - the ChangeNotes of the change for which the change edit should be created

Throws:

AuthException - if the user isn't authenticated or not allowed to use change edits

InvalidChangeOperationException - if a change edit already existed for the change

PermissionBackendException

java.io.IOException

ResourceConflictException

rebaseEdit

public void rebaseEdit(org.eclipse.jgit.lib.Repository repository,
                       ChangeNotes notes)
                throws AuthException,
                       InvalidChangeOperationException,
                       java.io.IOException,
                       MergeConflictException,
                       PermissionBackendException,
                       ResourceConflictException

Rebase change edit on latest patch set

Parameters:

repository - the affected Git repository

notes - the ChangeNotes of the change whose change edit should be rebased

Throws:

AuthException - if the user isn't authenticated or not allowed to use change edits

InvalidChangeOperationException - if a change edit doesn't exist for the specified change, the change edit is already based on the latest patch set, or the change represents the root commit

MergeConflictException - if rebase fails due to merge conflicts

PermissionBackendException

java.io.IOException

ResourceConflictException

modifyMessage

public void modifyMessage(org.eclipse.jgit.lib.Repository repository,
                          ChangeNotes notes,
                          java.lang.String newCommitMessage)
                   throws AuthException,
                          java.io.IOException,
                          UnchangedCommitMessageException,
                          PermissionBackendException,
                          BadRequestException,
                          ResourceConflictException

Modifies the commit message of a change edit. If the change edit doesn't exist, a new one will be created based on the current patch set.

Parameters:

repository - the affected Git repository

notes - the ChangeNotes of the change whose change edit's message should be modified

newCommitMessage - the new commit message

Throws:

AuthException - if the user isn't authenticated or not allowed to use change edits

UnchangedCommitMessageException - if the commit message is the same as before

PermissionBackendException

BadRequestException - if the commit message is malformed

java.io.IOException

ResourceConflictException

modifyFile

public void modifyFile(org.eclipse.jgit.lib.Repository repository,
                       ChangeNotes notes,
                       java.lang.String filePath,
                       RawInput newContent)
                throws AuthException,
                       BadRequestException,
                       InvalidChangeOperationException,
                       java.io.IOException,
                       PermissionBackendException,
                       ResourceConflictException

Modifies the contents of a file of a change edit. If the change edit doesn't exist, a new one will be created based on the current patch set.

Parameters:

repository - the affected Git repository

notes - the ChangeNotes of the change whose change edit should be modified

filePath - the path of the file whose contents should be modified

newContent - the new file content

Throws:

AuthException - if the user isn't authenticated or not allowed to use change edits

BadRequestException - if the user provided bad input (e.g. invalid file paths)

InvalidChangeOperationException - if the file already had the specified content

PermissionBackendException

ResourceConflictException - if the project state does not permit the operation

java.io.IOException

deleteFile

public void deleteFile(org.eclipse.jgit.lib.Repository repository,
                       ChangeNotes notes,
                       java.lang.String file)
                throws AuthException,
                       BadRequestException,
                       InvalidChangeOperationException,
                       java.io.IOException,
                       PermissionBackendException,
                       ResourceConflictException

Deletes a file from the Git tree of a change edit. If the change edit doesn't exist, a new one will be created based on the current patch set.

Parameters:

repository - the affected Git repository

notes - the ChangeNotes of the change whose change edit should be modified

file - path of the file which should be deleted

Throws:

AuthException - if the user isn't authenticated or not allowed to use change edits

BadRequestException - if the user provided bad input (e.g. invalid file paths)

InvalidChangeOperationException - if the file does not exist

PermissionBackendException

ResourceConflictException - if the project state does not permit the operation

java.io.IOException

renameFile

public void renameFile(org.eclipse.jgit.lib.Repository repository,
                       ChangeNotes notes,
                       java.lang.String currentFilePath,
                       java.lang.String newFilePath)
                throws AuthException,
                       BadRequestException,
                       InvalidChangeOperationException,
                       java.io.IOException,
                       PermissionBackendException,
                       ResourceConflictException

Renames a file of a change edit or moves it to another directory. If the change edit doesn't exist, a new one will be created based on the current patch set.

Parameters:

repository - the affected Git repository

notes - the ChangeNotes of the change whose change edit should be modified

currentFilePath - the current path/name of the file

newFilePath - the desired path/name of the file

Throws:

AuthException - if the user isn't authenticated or not allowed to use change edits

BadRequestException - if the user provided bad input (e.g. invalid file paths)

InvalidChangeOperationException - if the file was already renamed to the specified new name

PermissionBackendException

ResourceConflictException - if the project state does not permit the operation

java.io.IOException

restoreFile

public void restoreFile(org.eclipse.jgit.lib.Repository repository,
                        ChangeNotes notes,
                        java.lang.String file)
                 throws AuthException,
                        BadRequestException,
                        InvalidChangeOperationException,
                        java.io.IOException,
                        PermissionBackendException,
                        ResourceConflictException

Restores a file of a change edit to the state it was in before the patch set on which the change edit is based. If the change edit doesn't exist, a new one will be created based on the current patch set.

Parameters:

repository - the affected Git repository

notes - the ChangeNotes of the change whose change edit should be modified

file - the path of the file which should be restored

Throws:

AuthException - if the user isn't authenticated or not allowed to use change edits

InvalidChangeOperationException - if the file was already restored

PermissionBackendException

BadRequestException

java.io.IOException

ResourceConflictException

combineWithModifiedPatchSetTree

public ChangeEdit combineWithModifiedPatchSetTree(org.eclipse.jgit.lib.Repository repository,
                                                  ChangeNotes notes,
                                                  PatchSet patchSet,
                                                  java.util.List<TreeModification> treeModifications)
                                           throws AuthException,
                                                  BadRequestException,
                                                  java.io.IOException,
                                                  InvalidChangeOperationException,
                                                  MergeConflictException,
                                                  PermissionBackendException,
                                                  ResourceConflictException

Applies the indicated modifications to the specified patch set. If a change edit exists and is based on the same patch set, the modified patch set tree is merged with the change edit. If the change edit doesn't exist, a new one will be created.

Parameters:

repository - the affected Git repository

notes - the ChangeNotes of the change to which the patch set belongs

patchSet - the PatchSet which should be modified

treeModifications - the modifications which should be applied

Returns:

the resulting ChangeEdit

Throws:

AuthException - if the user isn't authenticated or not allowed to use change edits

InvalidChangeOperationException - if the existing change edit is based on another patch set or no change edit exists but the specified patch set isn't the current one

MergeConflictException - if the modified patch set tree can't be merged with an existing change edit

BadRequestException

java.io.IOException

PermissionBackendException

ResourceConflictException