Field Detail

• args

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

Method Detail

• run

  public final CodeReviewCommit run(CodeReviewCommit mergeTip,
                     java.util.List<CodeReviewCommit> toMerge)
                             throws MergeException

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

  Parameters:

  mergeTip - the mergeTip

  toMerge - the list of submitted commits that should be merged using this submit strategy

  Returns:

  the new mergeTip

  Throws:

  MergeException

• _run

  protected abstract CodeReviewCommit _run(CodeReviewCommit mergeTip,
                      java.util.List<CodeReviewCommit> toMerge)
                                    throws MergeException

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

  Parameters:

  mergeTip - the mergeTip

  toMerge - the list of submitted commits that should be merged using this submit strategy

  Returns:

  the new mergeTip

  Throws:

  MergeException

• dryRun

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

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

  Parameters:

  mergeTip - the mergeTip

  toMerge - the commit for which it should be checked whether it can be merged or not

  Returns:

  true if the given commit can be merged, otherwise false

  Throws:

  MergeException

• getRefLogIdent

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

  Returns the PersonIdent that should be used for the ref log entries when updating the destination branch. The ref log identity may be set after the run(CodeReviewCommit, List) method finished. Do only call this method after the run(CodeReviewCommit, List) method has been invoked.

  Returns:

  the ref log identity, 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 is returning an empty map, but subclasses may overwrite this method to provide newly created commits. Do only call this method after the run(CodeReviewCommit, List) method has been invoked.

  Returns:

  new commits created for changes that are getting merged

• retryOnLockFailure

  public boolean retryOnLockFailure()

  Returns whether a merge that failed with RefUpdate.Result.LOCK_FAILURE should be retried. May be overwritten 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)

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

  Parameters:

  submitApproval - the approval that submitted the patch set