Field Detail

• args

  protected final com.google.gerrit.server.git.strategy.SubmitStrategy.Arguments args

Method Detail

• run

  public final MergeTip run(CodeReviewCommit currentTip,
             java.util.Collection<CodeReviewCommit> toMerge)
                     throws MergeException

  Runs this submit strategy.

  If possible, the provided commits will be merged with this submit strategy.

  Parameters:

  currentTip - the mergeTip

  toMerge - the list of submitted commits that should be merged using this submit strategy. Implementations are responsible for ordering of commits, and should not modify the input in place.

  Returns:

  the new merge tip.

  Throws:

  MergeException

• _run

  protected abstract MergeTip _run(CodeReviewCommit currentTip,
              java.util.Collection<CodeReviewCommit> toMerge)
                            throws MergeException

  Throws:

  MergeException

  See Also:

  run(CodeReviewCommit, Collection)

• dryRun

  public abstract boolean dryRun(CodeReviewCommit mergeTip,
               CodeReviewCommit toMerge)
                          throws MergeException

  Checks whether the given commit can be merged. Implementations must ensure that invoking this method modifies neither the git repository nor the Gerrit database.

  Parameters:

  mergeTip - the merge tip.

  toMerge - the commit that should be checked.

  Returns:

  true if the given commit can be merged, otherwise false

  Throws:

  MergeException

• getRefLogIdent

  public final org.eclipse.jgit.lib.PersonIdent getRefLogIdent()

  Returns the identity that should be used for reflog entries when updating the destination branch.

  The reflog identity may only be set during run(CodeReviewCommit, Collection), and this method is invalid to call beforehand.

  Returns:

  the ref log identity, which may be null.

• getNewCommits

  public java.util.Map<com.google.gerrit.reviewdb.client.Change.Id,CodeReviewCommit> getNewCommits()

  Returns all commits that have been newly created for the changes that are getting merged.

  By default this method returns an empty map, but subclasses may override this method to provide any newly created commits. This method may only be called after run(CodeReviewCommit, Collection).

  Returns:

  new commits created for changes that were merged.

• retryOnLockFailure

  public boolean retryOnLockFailure()

  Returns whether a merge that failed with RefUpdate.Result.LOCK_FAILURE should be retried.

  May be overridden by subclasses.

  Returns:

  true if a merge that failed with RefUpdate.Result.LOCK_FAILURE should be retried, otherwise false

• setRefLogIdent

  protected final void setRefLogIdent(com.google.gerrit.reviewdb.client.PatchSetApproval submitApproval)

  Set the ref log identity if it wasn't set yet.

  Parameters:

  submitApproval - the approval that submitted the patch set