com.google.gerrit.server.update

Interface ChangeContext

All Superinterfaces:

Context

public interface ChangeContext
extends Context

Context for performing the BatchUpdateOp.updateChange(com.google.gerrit.server.update.ChangeContext) phase.

A single ChangeContext corresponds to updating a single change; if a BatchUpdate spans multiple changes, then multiple ChangeContext instances will be created.

Method Summary

Modifier and Type	Method and Description
void	deleteChange() Instruct BatchUpdate to delete this change.
void	dontBumpLastUpdatedOn() Don't bump the value of Change.getLastUpdatedOn().
default Change	getChange()
ChangeNotes	getNotes() Get the up-to-date notes for this change.
ChangeUpdate	getUpdate(PatchSet.Id psId) Get an update for this change at a given patch set.

Methods inherited from interface com.google.gerrit.server.update.Context

getAccount, getAccountId, getDb, getIdentifiedUser, getOrder, getProject, getRepoView, getRevWalk, getTimeZone, getUser, getWhen

Method Detail

getUpdate

ChangeUpdate getUpdate(PatchSet.Id psId)

Get an update for this change at a given patch set.

A single operation can modify changes at different patch sets. Commits in the NoteDb graph within this update are created in patch set order.

To get the current patch set ID, use PatchSetUtil.current(com.google.gerrit.reviewdb.server.ReviewDb, com.google.gerrit.server.notedb.ChangeNotes).

Parameters:

psId - patch set ID.

Returns:

handle for change updates.

getNotes

ChangeNotes getNotes()

Get the up-to-date notes for this change.

The change data is read within the same transaction that BatchUpdateOp.updateChange(ChangeContext) is executing.

Returns:

notes for this change.

dontBumpLastUpdatedOn

void dontBumpLastUpdatedOn()

Don't bump the value of Change.getLastUpdatedOn().

If called, don't bump the timestamp before storing to ReviewDb. Only has an effect in ReviewDb, and the only usage should be to match the behavior of NoteDb. Specifically, in NoteDb the timestamp is updated if and only if the change meta graph is updated, and is not updated when only drafts are modified.

deleteChange

void deleteChange()

Instruct BatchUpdate to delete this change.

If called, all other updates are ignored.

getChange

default Change getChange()

Returns:

change corresponding to getNotes().