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	bumpLastUpdatedOn(boolean bump)
void	deleteChange() Instruct BatchUpdate to delete this change.
default Change	getChange()
ChangeControl	getControl()
default ChangeNotes	getNotes()
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, getRepository, 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.

getControl

ChangeControl getControl()

Returns:

control for this change. The user will be the same as Context.getUser(), and the change data is read within the same transaction that updateChange is executing.

bumpLastUpdatedOn

void bumpLastUpdatedOn(boolean bump)

Parameters:

bump - whether to bump the value of Change.getLastUpdatedOn() field before storing to ReviewDb. For NoteDb, the value is always incremented (assuming the update is not otherwise a no-op).

deleteChange

void deleteChange()

Instruct BatchUpdate to delete this change.

If called, all other updates are ignored.

getNotes

default ChangeNotes getNotes()

Returns:

notes corresponding to getControl().

getChange

default Change getChange()

Returns:

change corresponding to getControl().