com.google.gerrit.server.git

Class MergeUtil

java.lang.Object

com.google.gerrit.server.git.MergeUtil

public class MergeUtil
extends Object

Utility methods used during the merge process.

Note: Unless otherwise specified, the methods in this class do not flush ObjectInserters. Callers that want to read back objects before flushing should use ObjectInserter.newReader(). This is already the default behavior of BatchUpdate.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	MergeUtil.Factory

Method Summary

Modifier and Type	Method and Description
boolean	canCherryPick(MergeSorter mergeSorter, org.eclipse.jgit.lib.Repository repo, CodeReviewCommit mergeTip, CodeReviewCommit.CodeReviewRevWalk rw, CodeReviewCommit toMerge)
boolean	canFastForward(MergeSorter mergeSorter, CodeReviewCommit mergeTip, CodeReviewCommit.CodeReviewRevWalk rw, CodeReviewCommit toMerge)
boolean	canMerge(MergeSorter mergeSorter, org.eclipse.jgit.lib.Repository repo, CodeReviewCommit mergeTip, CodeReviewCommit toMerge)
CodeReviewCommit	createCherryPickFromCommit(org.eclipse.jgit.lib.Repository repo, org.eclipse.jgit.lib.ObjectInserter inserter, org.eclipse.jgit.revwalk.RevCommit mergeTip, org.eclipse.jgit.revwalk.RevCommit originalCommit, org.eclipse.jgit.lib.PersonIdent cherryPickCommitterIdent, String commitMsg, CodeReviewCommit.CodeReviewRevWalk rw, int parentIndex, boolean ignoreIdenticalTree)
String	createCommitMessageOnSubmit(CodeReviewCommit n, org.eclipse.jgit.revwalk.RevCommit mergeTip)
String	createCommitMessageOnSubmit(org.eclipse.jgit.revwalk.RevCommit n, org.eclipse.jgit.revwalk.RevCommit mergeTip, ChangeControl ctl, PatchSet.Id id) Creates a commit message for a change, which can be customized by plugins.
static String	createConflictMessage(List<String> conflicts)
static org.eclipse.jgit.revwalk.RevCommit	createMergeCommit(org.eclipse.jgit.lib.Repository repo, org.eclipse.jgit.lib.ObjectInserter inserter, org.eclipse.jgit.revwalk.RevCommit mergeTip, org.eclipse.jgit.revwalk.RevCommit originalCommit, String mergeStrategy, org.eclipse.jgit.lib.PersonIdent committerIndent, String commitMsg, org.eclipse.jgit.revwalk.RevWalk rw)
static CodeReviewCommit	findAnyMergedInto(CodeReviewCommit.CodeReviewRevWalk rw, Iterable<CodeReviewCommit> commits, CodeReviewCommit tip)
Set<Change.Id>	findUnmergedChanges(Set<Change.Id> expected, CodeReviewCommit.CodeReviewRevWalk rw, org.eclipse.jgit.revwalk.RevFlag canMergeFlag, CodeReviewCommit oldTip, CodeReviewCommit mergeTip, Iterable<Change.Id> alreadyMerged)
CodeReviewCommit	getFirstFastForward(CodeReviewCommit mergeTip, org.eclipse.jgit.revwalk.RevWalk rw, List<CodeReviewCommit> toMerge)
static org.eclipse.jgit.merge.ThreeWayMergeStrategy	getMergeStrategy(org.eclipse.jgit.lib.Config cfg)
boolean	hasMissingDependencies(MergeSorter mergeSorter, CodeReviewCommit toMerge)
void	markCleanMerges(org.eclipse.jgit.revwalk.RevWalk rw, org.eclipse.jgit.revwalk.RevFlag canMergeFlag, CodeReviewCommit mergeTip, Set<org.eclipse.jgit.revwalk.RevCommit> alreadyAccepted)
CodeReviewCommit	mergeOneCommit(org.eclipse.jgit.lib.PersonIdent author, org.eclipse.jgit.lib.PersonIdent committer, org.eclipse.jgit.lib.Repository repo, CodeReviewCommit.CodeReviewRevWalk rw, org.eclipse.jgit.lib.ObjectInserter inserter, Branch.NameKey destBranch, CodeReviewCommit mergeTip, CodeReviewCommit n)
String	mergeStrategyName()
static String	mergeStrategyName(boolean useContentMerge, boolean useRecursiveMerge)
static org.eclipse.jgit.merge.Merger	newMerger(org.eclipse.jgit.lib.Repository repo, org.eclipse.jgit.lib.ObjectInserter inserter, String strategyName)
org.eclipse.jgit.merge.ThreeWayMerger	newThreeWayMerger(org.eclipse.jgit.lib.Repository repo, org.eclipse.jgit.lib.ObjectInserter inserter)
static org.eclipse.jgit.merge.ThreeWayMerger	newThreeWayMerger(org.eclipse.jgit.lib.Repository repo, org.eclipse.jgit.lib.ObjectInserter inserter, String strategyName)
List<CodeReviewCommit>	reduceToMinimalMerge(MergeSorter mergeSorter, Collection<CodeReviewCommit> toSort, Set<CodeReviewCommit> incoming)
static org.eclipse.jgit.revwalk.RevCommit	resolveCommit(org.eclipse.jgit.lib.Repository repo, org.eclipse.jgit.revwalk.RevWalk rw, String str)
static boolean	useRecursiveMerge(org.eclipse.jgit.lib.Config cfg)
CodeReviewCommit	writeMergeCommit(org.eclipse.jgit.lib.PersonIdent author, org.eclipse.jgit.lib.PersonIdent committer, CodeReviewCommit.CodeReviewRevWalk rw, org.eclipse.jgit.lib.ObjectInserter inserter, Branch.NameKey destBranch, CodeReviewCommit mergeTip, org.eclipse.jgit.lib.ObjectId treeId, CodeReviewCommit n)

Methods inherited from class java.lang.Object

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

Method Detail

useRecursiveMerge

public static boolean useRecursiveMerge(org.eclipse.jgit.lib.Config cfg)

getMergeStrategy

public static org.eclipse.jgit.merge.ThreeWayMergeStrategy getMergeStrategy(org.eclipse.jgit.lib.Config cfg)

getFirstFastForward

public CodeReviewCommit getFirstFastForward(CodeReviewCommit mergeTip,
                                            org.eclipse.jgit.revwalk.RevWalk rw,
                                            List<CodeReviewCommit> toMerge)
                                     throws IntegrationException

Throws:

IntegrationException

reduceToMinimalMerge

public List<CodeReviewCommit> reduceToMinimalMerge(MergeSorter mergeSorter,
                                                   Collection<CodeReviewCommit> toSort,
                                                   Set<CodeReviewCommit> incoming)
                                            throws IntegrationException

Throws:

IntegrationException

createCherryPickFromCommit

public CodeReviewCommit createCherryPickFromCommit(org.eclipse.jgit.lib.Repository repo,
                                                   org.eclipse.jgit.lib.ObjectInserter inserter,
                                                   org.eclipse.jgit.revwalk.RevCommit mergeTip,
                                                   org.eclipse.jgit.revwalk.RevCommit originalCommit,
                                                   org.eclipse.jgit.lib.PersonIdent cherryPickCommitterIdent,
                                                   String commitMsg,
                                                   CodeReviewCommit.CodeReviewRevWalk rw,
                                                   int parentIndex,
                                                   boolean ignoreIdenticalTree)
                                            throws org.eclipse.jgit.errors.MissingObjectException,
                                                   org.eclipse.jgit.errors.IncorrectObjectTypeException,
                                                   IOException,
                                                   MergeIdenticalTreeException,
                                                   MergeConflictException

Throws:

org.eclipse.jgit.errors.MissingObjectException

org.eclipse.jgit.errors.IncorrectObjectTypeException

IOException

MergeIdenticalTreeException

MergeConflictException

createMergeCommit

public static org.eclipse.jgit.revwalk.RevCommit createMergeCommit(org.eclipse.jgit.lib.Repository repo,
                                                                   org.eclipse.jgit.lib.ObjectInserter inserter,
                                                                   org.eclipse.jgit.revwalk.RevCommit mergeTip,
                                                                   org.eclipse.jgit.revwalk.RevCommit originalCommit,
                                                                   String mergeStrategy,
                                                                   org.eclipse.jgit.lib.PersonIdent committerIndent,
                                                                   String commitMsg,
                                                                   org.eclipse.jgit.revwalk.RevWalk rw)
                                                            throws IOException,
                                                                   MergeIdenticalTreeException,
                                                                   MergeConflictException

Throws:

IOException

MergeIdenticalTreeException

MergeConflictException

createConflictMessage

public static String createConflictMessage(List<String> conflicts)

createCommitMessageOnSubmit

public String createCommitMessageOnSubmit(CodeReviewCommit n,
                                          org.eclipse.jgit.revwalk.RevCommit mergeTip)

createCommitMessageOnSubmit

public String createCommitMessageOnSubmit(org.eclipse.jgit.revwalk.RevCommit n,
                                          org.eclipse.jgit.revwalk.RevCommit mergeTip,
                                          ChangeControl ctl,
                                          PatchSet.Id id)

Creates a commit message for a change, which can be customized by plugins.

By default, adds footers to existing commit message based on the state of the change. Plugins implementing ChangeMessageModifier can modify the resulting commit message arbitrarily.

Parameters:

n -

mergeTip -

ctl -

id -

Returns:

new message

canMerge

public boolean canMerge(MergeSorter mergeSorter,
                        org.eclipse.jgit.lib.Repository repo,
                        CodeReviewCommit mergeTip,
                        CodeReviewCommit toMerge)
                 throws IntegrationException

Throws:

IntegrationException

canFastForward

public boolean canFastForward(MergeSorter mergeSorter,
                              CodeReviewCommit mergeTip,
                              CodeReviewCommit.CodeReviewRevWalk rw,
                              CodeReviewCommit toMerge)
                       throws IntegrationException

Throws:

IntegrationException

canCherryPick

public boolean canCherryPick(MergeSorter mergeSorter,
                             org.eclipse.jgit.lib.Repository repo,
                             CodeReviewCommit mergeTip,
                             CodeReviewCommit.CodeReviewRevWalk rw,
                             CodeReviewCommit toMerge)
                      throws IntegrationException

Throws:

IntegrationException

hasMissingDependencies

public boolean hasMissingDependencies(MergeSorter mergeSorter,
                                      CodeReviewCommit toMerge)
                               throws IntegrationException

Throws:

IntegrationException

mergeOneCommit

public CodeReviewCommit mergeOneCommit(org.eclipse.jgit.lib.PersonIdent author,
                                       org.eclipse.jgit.lib.PersonIdent committer,
                                       org.eclipse.jgit.lib.Repository repo,
                                       CodeReviewCommit.CodeReviewRevWalk rw,
                                       org.eclipse.jgit.lib.ObjectInserter inserter,
                                       Branch.NameKey destBranch,
                                       CodeReviewCommit mergeTip,
                                       CodeReviewCommit n)
                                throws IntegrationException

Throws:

IntegrationException

writeMergeCommit

public CodeReviewCommit writeMergeCommit(org.eclipse.jgit.lib.PersonIdent author,
                                         org.eclipse.jgit.lib.PersonIdent committer,
                                         CodeReviewCommit.CodeReviewRevWalk rw,
                                         org.eclipse.jgit.lib.ObjectInserter inserter,
                                         Branch.NameKey destBranch,
                                         CodeReviewCommit mergeTip,
                                         org.eclipse.jgit.lib.ObjectId treeId,
                                         CodeReviewCommit n)
                                  throws IOException,
                                         org.eclipse.jgit.errors.MissingObjectException,
                                         org.eclipse.jgit.errors.IncorrectObjectTypeException

Throws:

IOException

org.eclipse.jgit.errors.MissingObjectException

org.eclipse.jgit.errors.IncorrectObjectTypeException

newThreeWayMerger

public org.eclipse.jgit.merge.ThreeWayMerger newThreeWayMerger(org.eclipse.jgit.lib.Repository repo,
                                                               org.eclipse.jgit.lib.ObjectInserter inserter)

mergeStrategyName

public String mergeStrategyName()

mergeStrategyName

public static String mergeStrategyName(boolean useContentMerge,
                                       boolean useRecursiveMerge)

newThreeWayMerger

public static org.eclipse.jgit.merge.ThreeWayMerger newThreeWayMerger(org.eclipse.jgit.lib.Repository repo,
                                                                      org.eclipse.jgit.lib.ObjectInserter inserter,
                                                                      String strategyName)

newMerger

public static org.eclipse.jgit.merge.Merger newMerger(org.eclipse.jgit.lib.Repository repo,
                                                      org.eclipse.jgit.lib.ObjectInserter inserter,
                                                      String strategyName)

markCleanMerges

public void markCleanMerges(org.eclipse.jgit.revwalk.RevWalk rw,
                            org.eclipse.jgit.revwalk.RevFlag canMergeFlag,
                            CodeReviewCommit mergeTip,
                            Set<org.eclipse.jgit.revwalk.RevCommit> alreadyAccepted)
                     throws IntegrationException

Throws:

IntegrationException

findUnmergedChanges

public Set<Change.Id> findUnmergedChanges(Set<Change.Id> expected,
                                          CodeReviewCommit.CodeReviewRevWalk rw,
                                          org.eclipse.jgit.revwalk.RevFlag canMergeFlag,
                                          CodeReviewCommit oldTip,
                                          CodeReviewCommit mergeTip,
                                          Iterable<Change.Id> alreadyMerged)
                                   throws IntegrationException

Throws:

IntegrationException

findAnyMergedInto

public static CodeReviewCommit findAnyMergedInto(CodeReviewCommit.CodeReviewRevWalk rw,
                                                 Iterable<CodeReviewCommit> commits,
                                                 CodeReviewCommit tip)
                                          throws IOException

Throws:

IOException

resolveCommit

public static org.eclipse.jgit.revwalk.RevCommit resolveCommit(org.eclipse.jgit.lib.Repository repo,
                                                               org.eclipse.jgit.revwalk.RevWalk rw,
                                                               String str)
                                                        throws BadRequestException,
                                                               ResourceNotFoundException,
                                                               IOException

Throws:

BadRequestException

ResourceNotFoundException

IOException